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>