解决SpringBoot jar包中的文件读取问题实现

2025-05-29 0 59

前言

SpringBoot微服务已成为业界主流,从开发到部署都非常省时省力,但是最近小明开发时遇到一个问题:在代码中读取资源文件(比如word文档、导出模版等),本地开发时可以正常读取 ,但是,当我们打成jar包发布到服务器后,再次执行程序时就会抛出找不到文件的异常。

背景

这个问题是在一次使用freemarker模版引擎导出word报告时发现的。大概说一下docx导出java实现思路:导出word的文档格式为docx,事先准备好一个排好版的docx文档作为模版,读取解析该模版,将其中的静态资源替换再导出。

docx文档本身其实是一个压缩的zip文件,将其解压过后就会发现它有自己的目录结构。

问题

这个docx文档所在目录如下图所示:

解决SpringBoot jar包中的文件读取问题实现

在本地调试时,我使用如下方式读取:

?

1

2

3

4
import org.springframework.util.ResourceUtils;

public static void main(String[] args) throws IOException {

File docxTemplate = ResourceUtils.getFile("classpath:templates/docxTemplate.docx");

}

可以正常解析使用,但是打包发布到beta环境却不可用。抛出异常如下:

?

1
java.io.FileNotFoundException: class path resource [templates/docxTemplate.docx] cannot be resolved to absolute file path because it does not reside in the file system: jar:file:/usr/local/subject-server.jar!/BOOT-INF/classes!/templates/docxTemplate.docx

显而易见,这个异常告诉我们:没有找到文件,但是将jar包解压过后,发现这个文件是真真实实存在的。
那这到底是怎么回事呢?这压根难不倒我。我们要善于透过堆栈信息看本质。通过仔细观察堆栈信息,我发现此时的文件路径并不是一个合法的URL(文件资源定位符)。原来jar包中资源有其专门的URL形式: jar:<url>!/{entry} )。所以,此时如果仍然按照标准的文件资源定位形式

?

1
File f=new File("jar:file:……");

定位文件,就会抛出java.io.FileNotFoundException。

解决

虽然我们不能用常规操作文件的方法来读取jar包中的资源文件docxTemplate.docx,但可以通过Class类的getResourceAsStream()方法,即通过流的方式来获取 :

?

1

2

3
public static void main(String[] args) throws IOException {

InputStream inputStream = WordUtil.class.getClassLoader().getResourceAsStream("templates/docxTemplate.docx");

}

拿到流之后,就可以将其转换为任意一个我们需要的对象,比如File、String等等,此处我要获取docxTemplate.docx下的目录结构,因此我需要一个File对象,代码举例如下:

?

1

2

3

4

5

6

7

8

9

10

11
import org.apache.commons.io.FileUtils;

public static void main(String[] args) throws IOException {

InputStream inputStream = WordUtil.class.getClassLoader().getResourceAsStream("templates/docxTemplate.docx");

File docxFile = new File("docxTemplate.docx");

// 使用common-io的工具类即可转换

FileUtils.copyToFile(inputStream,docxFile);

ZipFile zipFile = new ZipFile(docxFile);

Enumeration<? extends ZipEntry> zipEntrys = zipFile.entries();

// todo 记得关闭流

}

结果

打包、发布至beta环境,亲测可用,问题完美解决。

到此这篇关于解决SpringBoot jar包中的文件读取问题实现的文章就介绍到这了,更多相关SpringBoot jar文件读取内容请搜索快网idc以前的文章或继续浏览下面的相关文章希望大家以后多多支持快网idc!

原文链接:https://segmentfault.com/a/1190000023777147

收藏 (0) 打赏

感谢您的支持,我会继续努力的!

打开微信/支付宝扫一扫,即可进行扫码打赏哦,分享从这里开始,精彩与您同在
点赞 (0)

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

快网idc优惠网 建站教程 解决SpringBoot jar包中的文件读取问题实现 https://www.kuaiidc.com/117756.html

相关文章

发表评论
暂无评论