Maven的pom.xml中resources标签的用法-编程知识

spring-boot-starter-parent-2.4.1.pom文件中resources标签内容如下：

<build><resources><resource><directory>${basedir}/src/main/resources</directory><filtering>true</filtering><includes><include>**/application*.yml</include><include>**/application*.yaml</include><include>**/application*.properties</include></includes></resource><resource><directory>${basedir}/src/main/resources</directory><excludes><exclude>**/application*.yml</exclude><exclude>**/application*.yaml</exclude><exclude>**/application*.properties</exclude></excludes></resource></resources>
</build>

先做一下实验，看一下结果，我们再来给出这个标签的含义是什么

rsource 下标签作用解释

其中包含的标签含义如下：

targetPath：指定了资源构建时的目标目录，默认为base direcory，即source目录结构下
原文：This is not required if you simply put the resources in that directory structure at the source
filtering：决定是否将resources目录下的文件中的tokens（即通过@val@标识的变量）进行参数替换。这里的参数主要有两个来源，一个是来自于pom文件中的properties属性，一个是来源于外部的.properties文件（个人认为这个文件不可与springboot中的配置文件混为一谈）
那么如何引用外部的.properties文件呢？通过另一个标签下的进行路径的指定。
directory：一个相对于POM文件的路径，指定了resources文件的路径。
includes：制定了包含文件的patterns，符合样式的且在directory目录下的文件都会包含进编译好的资源文件中
excludes：与includes对应，指定不包含在内的模式。如果和includes冲突，优先不包含。即includes和excludes同时包含某个文件，这个这个文件不会被包含打包进资源文件；

一、resources作用

1. 明确告诉Maven 需要打包编译的文件

在项目当中进行编译的时候，他默认是不会对某些文件进行编译的，例如在java文件夹下的mybatis当中的.xml文件，还有在resources文件夹当中有时候会存储一些资源文件，默认有些也是不进行编译的，这里的不进行编译指的是他不会编译到target文件夹当中，并且打包也是。

我们在正常开发项目的时候，有时候获取资源是获取的编译后的路径地址，他会在编译后的路径找不到文件（target文件夹），就是这个原因。

这时候就需要用到resources标签，在pom.xml添加，告诉maven我这些文件也需要编译，并且打包的时候需要打包进去。

2、配置文件取pom当中的值

在现实开发当中，我也遇到过，在pom文件当中配置参数，然后通过application.properties使用@@来进行取pom的值。假如我不想用application.properties取值，而是用了新创建的比如a.properties取值，这时候就需要在pom当中配置resources。

用法另见

二实战

先在maven工程的resources目录下面创建2个配置文件

在这里插入图片描述
再修改pom文件，修改内容如下

<!--在properties标签中添加变量test.name-->
<properties><test.name>测试内容test01</test.name>
</properties>
<!--在build标签中添加resources标签-->
<build><resources><resource><directory>src/main/resources</directory><filtering>true</filtering><includes><include>a.properties</include></includes></resource></resources>
</build>

再在a.properties文件中引用pom文件中定义的变量值

a.name=${test.name}

b.properties文件中的内容如下

b.name=${test.name}

点击package 进行打包
打包完成后在target目录下的classes类路径下的内容如下
在这里插入图片描述

<build><resources><resource><directory>src/main/resources</directory><filtering>true</filtering><includes><include>a.properties</include></includes></resource></resources>
</build>

从这里可以得出结论：上面这段配置的含义是如果filtering标签的值设置成true，默认值是false，则在工程进行编译打包的时候只会将工程的src/main/resources目录下的includes标签中的资源文件打包进去，并且会进行预编译（就是就将资源文件中引用pom文件中的properties标签中的变量，转化其对应的值），除了includes标签中的资源文件的其它资源文件都不会被打包进去。

resources 标签下的 filtering标签的用法和替换只另见

再修改pom文件的resources标签

<build><resources><resource><directory>src/main/resources</directory><filtering>true</filtering><includes><include>a.properties</include></includes></resource><resource><directory>src/main/resources</directory><!--filtering标签的值默认是false，在这里可写可不写--><filtering>false</filtering><excludes><exclude>a.properties</exclude></excludes></resource></resources>
</build>

进行编译打包，结果如下
在这里插入图片描述

<resource><directory>src/main/resources</directory><!--filtering标签的值默认是false，在这里可写可不写--><filtering>false</filtering><excludes><exclude>a.properties</exclude></excludes>
</resource>

由此可知这段配置的含义是：在项目进行打包的时候会将src/main/resources目录下除了a.properties资源文件的其它资源文件打包进去，并且这些打包进去的资源文件的内容不会进行预编译，之前是什么样子，打完包之后还是什么样子。

2.1 总结

如果项目打包的时候，想对某个资源文件中的内容进行预编译再打包进去，而对其他的资源文件不进行预编译处理打包到项目中，则可以按照如下配置进行处理

<resources><resource><directory>src/main/resources</directory><filtering>true</filtering><includes><include>需要进行预编译的资源文件名称如：a.properties</include></includes></resource><resource><directory>src/main/resources</directory><!--filtering标签的值默认是false，在这里可写可不写--><filtering>false</filtering><excludes><exclude>上面includes标签中的资源文件名称如：a.properties</exclude></excludes></resource>
</resources>

2.2 resources标签结合mybatis使用

如果想要将mapper.xml文件和mapper接口同一个包中，并且在项目打包的时候需要作为资源文件也要打包进去，比如项目的结构如下

在这里插入图片描述
可以在pom文件中进行如下配置

<build><resources><!--将src/main/java目录下的所有xml文件都作为项目的资源文件，项目打包的时候也会打包进去--><resource><directory>src/main/java</directory><includes><include>**/*.xml</include></includes></resource><!--将项目的src/main/resources目录下的所有文件都作为项目的资源文件项目打包的时候也会打包进去--><resource><directory>src/main/resources</directory></resource></resources><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins>
</build>