Spring-Boot读取resource或template中的文件
1.项目场景:
以jar包方式部署系统,想读取resource或是template下面的文件时,报 File Not Found
我遇到的情况是,整个项目达成了一个包,在开发环境(windows + idea)读取文件没问题,但在预发布环境(centos, 打成一个jar部署),则报错。
2.问题描述:
File file = ResourceUtils.getFile("classpath:templates/jumppage.html")
使用上述方法读取模板文件当部署成jar包时读取不到文件
3.解决方案:
方法1/2/3在开发环境、预发布环境都可以读取到jar包中的文件,方法4则只有开发环境中可以、直接从jar包读取失败。
3.1方法一
InputStream in = null;
ClassPathResource classPathResource = new ClassPathResource("templates/jumppage.html");
in = classPathResource.getInputStream();
StringBuffer buff = new StringBuffer();
byte[] filecontent = new byte[1024];
while((in.read(filecontent)) != -1){String strRead = new String(filecontent);buff.append(strRead);
}
byte[] bytes = buff.toString().getBytes();
注:使用classPathResource.getFile()会报错找不到该文件,原因是springboot打成了jar包,classPathResource.getFile()无法读取jar包目录下的文件
3.2方法二
InputStream inputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream("templates/jumppage.html");
3.3方法三
InputStream inputStream = this.getClass().getResourceAsStream("/templates/jumppage.html");
3.4方法四
File file = ResourceUtils.getFile("classpath:templates/jumppage.html");
InputStream inputStream = new FileInputStream(file);
SpringBoot打包后资源文件读取问题
springboot项目打包之后,将所有依赖都打入jar包,同时也将系统中要使用的一些资源文件也会打进来,之后运行这个jar包,里面包含的资源文件不能再像文件系统那样直接在classpath下就可以使用了。
如下所示,这段代码在idea中运行,可以按照预期,正确访问到资源文件hello.txt。
package com.xxx.springresourcedemo;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.core.io.ClassPathResource;import java.io.File;
import java.io.InputStream;@SpringBootApplication
public class SpringresourcedemoApplication implements CommandLineRunner {public static void main(String[] args) {SpringApplication.run(SpringresourcedemoApplication.class, args);}@Overridepublic void run(String... args) throws Exception {try {String path = new ClassPathResource("hello.txt").getURL().getPath();File file = new File(path);System.out.println(file.getPath()+" exists -> "+file.exists());}catch (Exception e){System.out.println("exception -> "+e.getMessage());}}
}
在 idea中运行程序,打印信息如下:
但是如果我们打包,直接在windows下或者在linux下运行,这个代码的结果就发生了改变:
我们可以通过反编译工具看jar包的内容,hello.txt文件确实在BOOT-INF\classes目录下:
打包之后运行的结果为什么会出现这个问题?其实仔细想想,jar包内的文件路径发生了改变,当然就不能再像文件系统那样使用这个文件了。
那么问题来了,静态文件怎么加载,springboot又是如何加载application.yml或者其他配置文件的呢?其实它是通过读取流的方式来加载资源文件的。
有了这个思路,我们改变代码,通过InputStream流来读取文件,看看结果怎样?
package com.xxx.springresourcedemo;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.core.io.ClassPathResource;import java.io.File;
import java.io.InputStream;@SpringBootApplication
public class SpringresourcedemoApplication implements CommandLineRunner {public static void main(String[] args) {SpringApplication.run(SpringresourcedemoApplication.class, args);}@Overridepublic void run(String... args) throws Exception {try{InputStream in = new ClassPathResource("hello.txt").getInputStream();byte[] data = new byte[1024];int len;String content = "";while((len=in.read(data))!=-1){content += new String(data,0,len);}in.close();System.out.println("file content -> "+content);}catch (Exception e){System.out.println("exception -> "+e.getMessage());}}
}
这个代码,无论实在idea中运行,还是打包之后运行,结果都一样:
打包之后运行:
这样,我们大概就知道了,通过流的方式可以读取resources资源文件。
如果你使用了流的方式读取资源文件,发现还是不能读取,那么问题就是打包的时候资源文件被过滤了,这个时候就需要考虑打包配置了。可以参考如下pom.xml:
<build><resources><resource><directory>src/main/resources</directory><includes><include>**/*.yml</include><include>**/*.txt</include></includes><filtering>true</filtering></resource><resource><directory>src/main/java</directory><includes><include>**/*.xml</include></includes><filtering>true</filtering></resource></resources><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-resources-plugin</artifactId><version>3.0.1</version><configuration><nonFilteredFileExtensions><nonFilteredFileExtension>txt,yml</nonFilteredFileExtension></nonFilteredFileExtensions></configuration></plugin></plugins>
</build>
我们可以看看springboot启动时加载application.properties的代码:
加载application.properties文件时用到了OriginTrackedPropertiesLoader类的load()方法,这个方法里面的内容如下:
断点的位置就开始通过reader读取了,而这里的CharacterReader内部类的构造器代码如下:
CharacterReader(Resource resource) throws IOException {this.reader = new LineNumberReader(new InputStreamReader(resource.getInputStream(), StandardCharsets.ISO_8859_1));
}
这里通过resource.getInputStream()流来封装InputStreamReader,最后封装为LineNumberReader,至此,springboot加载配置文件的思路也就是通过InputStream流来读取我们就清楚了。还有其他的配置文件的加载方法,比如spring.factories加载方法,其实也是通过InputStream流的方式来读取的。
springboot打包之后,资源文件不能直接通过路径的方式来作为文件使用,但是可以通过流的方式读取,这里配置文件,我们只需要知道内容,无需写出来,但是比如图片,我们需要在别的地方使用的,那么就需要通过InputStream,OutputStream流将资源文件读出来保存到一个可以访问的文件中,那么我们就可以正常使用了。