在做模板导出的时候,想要把项目中的excel文件作为模板供用户下载,就这么一个功能,挺简单的,但是遇到了一些问题。本地下载没问题,linux服务器上却报找不到文件错误。
-
来简单分析下,我是使用spring-core下的
ResourceUtils.getFile()工具(这个jar包的util目录下有很多有用的工具),直接来看看它的源码吧。 -

-
从方法的注释来看,入参可以是
classpath:、file:或者是普通的路径,至于这classpath:有不明白的,之前的有提到过,可以翻看一下。 -
然后从代码实现来看呢,总体上有三步,分别对应解析
classpath:、file:、普通路径。因为从资源目录下读取文件,所以主要来看看对classpath:的解析。 -
首先通过调用
ClassUtils.getDefaultClassLoader()获得默认的类加载器,稍微看看ClassUtils.getDefaultClassLoader()的实现: -

-
可以看出先尝试获得当前线程的类加载器,如果失败,就获取当前类的类加载器,再失败的话就获取系统类加载器,关于类加载器的种类问题,以后会总结一下。
-
拿到类加载器后,就可以去加载资源了,可知是调用
getFile(url, description)这个方法来获得File的,来看看它的实现: -

-
从这个方法中看到了之前抛出的错误信息了,
cannot be resolved to absolute file path...,从条件判断可以看到resourceUrl.getProtocol()不是file,那么会是什么呢?我猜可能是jar,因为从报错的信息来看,资源的地址直接定位到了jar文件里面去了。 -
ok,让我来验证一下,通过远程调试来看看是不是
jar,经过一番配置后,看图: -

-
果然是
jar,到这里呢,问题就算找到了,可怎么解决呢?接下来提供一种解决办法。 -
既然不能使用
file来获取资源目录下的文件,可以使用类加载器来加载资源文件,不用我们自己来写,spring有个工具类可以读取类路径下的资源文件:ClassPathResource,挺好用的。 -
这个问题的背景是提供下载的接口,所以有这么些代码片段:
public ResponseEntity<byte[]> test(String templateName) throws IOException {
String templateName;
ClassPathResource classPathResource = new ClassPathResource(templateName);
String filename = classPathResource.getFilename();
@Cleanup InputStream inputStream = classPathResource.getInputStream();
byte[] bytes = FileCopyUtils.copyToByteArray(inputStream);
String fileName = new String(filename.getBytes("UTF-8"), "iso-8859-1");// 为了解决中文名称乱码问题
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
headers.setContentDispositionFormData("attachment", fileName);
return new ResponseEntity<>(bytes, headers, HttpStatus.CREATED);
}
- 这里面用到了一个流转字节的工具类
FileCopyUtils,也挺不错的,不用自己重新写,还有@Cleanup这个注解可以释放流,也挺方便的。 - 好的,这个读取内嵌servlet容器的jar的文件问题通过以上分析大致可以得到解决,但是里面的原理还需要细细揣摩才行,活到老,学到老。

本文介绍了解决在Spring框架中从类路径下读取模板文件的问题,特别是当应用部署在Linux服务器上的场景。文章详细分析了使用ResourceUtils.getFile()方法遇到的错误,并提出了一种解决方案,即利用ClassPathResource类来读取资源文件。
1268





