经验——SpringBoot 获取 resource 目录下的文件
一、背景
介绍： 在业务开发中，我们可能会将几个文件打包成一个压缩文件，而有些文件是固定不变的，可以提前放在资源文件 resource 下面。 这时我们只需要根据相对路径来获取文件。功能看起来很简单，但是遇到的坑倒是不少啊！
二、配置 maven
在文件编译时，需要将 resource 目录下的文件拷贝到 target 目录的 classes 目录下面，这个才是运行时的文件。因为是使用了 maven ，所以此处是在 pom 文件进行配置。如下(只贴出关键点)，这是最终能使用的版本：
<profiles>
<profile>
<id>dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<build>
<resources>
<!-- 把资源文件拷贝到classs目录下 -->
<resource>
<targetPath>${project.build.directory}/classes</targetPath>
<directory>src/main/resources</directory>
<!-- 开启过滤，用指定的参数替换directory下的文件中的参数 -->
<filtering>true</filtering>
<!-- 指定具体的文件，带扩展名 -->
<includes>
<include>**/*.xml</include>
<include>**/*.properties</include>
<include>**/*.Filter</include>
</includes>
<!-- 排除文件 -->
<excludes>
<exclude>**/*.exe</exclude>
<exclude>**/*.EXE</exclude>
</excludes>
</resource>
<resource>
<targetPath>${project.build.directory}/classes</targetPath>
<directory>src/main/resources</directory>
<!-- 不开启过滤 -->
<filtering>false</filtering>
<includes>
<!-- 改匹配规则是将 resource 目录下的所有文件夹及文件都包含 -->
<include>**/*</include>
</includes>
</resource>
<!-- 把资源文件log4j到classs目录下 -->
<resource>
<targetPath>${project.build.directory}/classes</targetPath>
<directory>${project.basedir}../../build/template/log-template</directory>
<filtering>true</filtering>
<includes>
<include>**/*</include>
</includes>
</resource>
</resources>
</build>
</profile>
</profiles>
- 开启过滤的效果，可以查看博客： maven filtering 标签说明
- 遇到的问题：
- 在 resource 目录下放 exe 文件时，打包到 target 的目录下时，文件大小总是会多出 几百kb ，并且文件不能使用。解决：将 exe 文件的拷贝配置需要放在 filtering 标签为 false 下面。
- 当文件没有后缀时，获取文件失败。原因是在配置资源拷贝时，总是设置了后缀名，导致无后缀文件没有匹配上。解决: 将资源的配置设置为目录，即上面配置第二个 resource 下的 include 标签 。
三、获取文件
此时就应该对文件进行获取了，获取资源的方法很多种。我下面就说出两种：
// 1. 第一种
file = ResourceUtils.getFile("classpath:" + path);
// 2.第二种（推荐）
ClassPathResource cpr = new ClassPathResource(path);
file = cpr.getFile();
- 说明：此处的 path 是相对路径（记得文件的路径分隔符使用：File.separator）。推荐使用第二种方式，因为在网上搜到文章说第一种在 centOS 会出问题，可以查看：SpringBoot 不要使用 ResourceUtils 读取资源文件
四、总结
- 步骤为：配置maven --> 将文件放置对应 resource 目录 --> 使用 ClassPathResource 根据相对路径获取文件
- 我们在开发时，即使是很小的功能，也可能会遇到很多意想不到的问题，需要静心慢慢排查
本文参与 腾讯云自媒体分享计划，分享自作者个人站点/博客。
原始发表：2020-06-04 ，如有侵权请联系 cloudcommunity@tencent.com 删除
评论
登录后参与评论
推荐阅读
目录