当前位置：首页 > news >正文

Maven核心插件之maven-resources-plugin

news 来源：原创 2025/5/6 15:13:18

前言

Maven 插件是 Maven 构建系统的重要组成部分，它们为 Maven 提供了丰富的功能和扩展能力，使得 Maven 不仅是一个构建工具，更是一个强大的项目管理平台。在 Maven 项目中，插件的使用通常通过配置 pom.xml 文件来完成。每个插件都有自己的配置参数，通过配置这些参数，可以控制插件的行为。插件为 Maven 项目提供了强大的扩展能力，使得开发者能够自定义项目的构建过程，实现自动化构建、代码生成、代码检查等多种功能。

一、插件概述

1.1 插件简介

在项目当中进行编译的时候，默认是不会对某些文件进行编译的，例如在java文件夹下的mybatis当中的 xml 文件，还有在resources文件夹当中有时候会存储一些资源文件，默认也是不进行编译的。注意，这里的不进行编译指的是不会编译到target文件夹当中，并且打包也是。在正常开发项目的时候，有时候获取资源是获取的编译后的路径地址，在编译后的路径找不到文件（target文件夹），就是这个原因。这时候就需要用到 maven-resources-plugin 插件，在pom.xml添加，告诉maven这些文件也需要编译，并且打包的时候需要打包进去。maven-resources-plugin 是 Maven 中一个非常重要的插件，用于处理项目的资源文件。资源文件通常包括配置文件、静态文件（如 HTML、CSS、JavaScript）、图像等。这个插件提供了多种功能，如复制资源文件、过滤资源文件、设置资源文件的输出目录等。

官网介绍：https://maven.apache.org/plugins/maven-resources-plugin/

为了使项目结构更为清晰，Maven 区别对待Java代码文件和资源文件，maven-compiler-plugin 用来编译Java代码，maven-resources-plugin 则用来处理资源文件。默认的主资源文件目录是 src/main/resources，很多用户会需要添加额外的资源文件目录，这个时候就可以通过配置 maven-resources-plugin 来实现。

此外，资源文件过滤也是Maven的一大特性，你可以在资源文件中使用 ${propertyName} 形式的Maven属性，然后配置 maven-resources-plugin 开启对资源文件的过滤，之后就可以针对不同环境通过命令行或者Profile传入属性的值，以实现更为灵活的构建。

注意，这个插件只要我们编译代码就会用到该插件，就算我们项目没有声明该插件也照样会使用到，如下图所示：

1.2 使用方式

在pom.xml文件中，插件配置通常位于 <build> 标签下的 <plugins> 标签内，每个插件配置由 <plugin> 标签包裹，并包含以下基本信息：

配置项	简要说明
groupId	插件所属的组织ID。
artifactId	插件的构件ID，用于唯一标识插件。
version	插件的版本号。
configuration	插件的配置参数，用于控制插件的行为。

以下是一个简单的Maven插件配置示例，展示了如何使用 Maven Resources Plugin 插件来配置为使用 Java 1.8 版本编译源代码：

<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-resources-plugin</artifactId><configuration><encoding>UTF-8</encoding></configuration>
</plugin>

【说明】在这个示例中，maven-resources-plugin 被配置为使用 UTF-8 编码处理资源文件。

二、插件常用配置

2.1 字符集编码

既然插件是copy资源文件那必然涉及到文件的编码，可以选择的编码有ASCII、UTF-8 或者 UTF-16，设置编码的方式有两种：

第一种：使用properties标签声明 project.build.sourceEncoding，声明好后，插件当中的 <encoding> 标签会取这个编码，如下所示：

<properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties>

第二种通过插件配置：

<build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-resources-plugin</artifactId><configuration><encoding>UTF-8</encoding></configuration></plugin></plugins>
</build>

注意：只要官网当中提到了可以使用${…}的方式配置，那么我们就可以不声明插件，可以直接在properties当中配置。

2.2 resources 配置结构

resources 标签其实就是 maven-resources-plugin 的配置，主要用来配置资源目录的，如下所示：

<build><resources><resource><directory>${project.basedir}/src/main/resources</directory><filtering></filtering><includes><include></include></includes><excludes><exclude></exclude></excludes></resource><!--假如资源目录有多个可以在这里声明--><resource></resource></resources>
</build>

标签	简要说明
directory	指定资源文件目录，这里是 `src/main/resources`。
includes	指定资源文件目录中，仅包含哪些文件被打包，例如 `*/.properties` 表示所有子目录下的 `.properties` 文件。
excludes	指定资源文件目录中，仅哪些文件不被打包
filtering	一个boolea值，默认值为false，指定打包时的配置文件中是否进行变量替换

2.3 resources 默认配置

所谓默认配置就是在项目当中不设置resources标签，默认生效的。

2.3.1 maven超级pom默认配置

maven 项目默认继承了一个父pom.xml，配置主要包含了如下，其中一些配置就是对 maven-resources-plugin 插件的配置，如下所示：

<build><directory>${project.basedir}/target</directory><!-- 主资源默认输出的位置 --><outputDirectory>${project.build.directory}/classes</outputDirectory><!--打出来的默认jar、war包名--><finalName>${project.artifactId}-${project.version}</finalName><!-- 测试资源默认输出的位置 --><testOutputDirectory>${project.build.directory}/test-classes</testOutputDirectory><!--默认的主源代码地址--><sourceDirectory>${project.basedir}/src/main/java</sourceDirectory><scriptSourceDirectory>${project.basedir}/src/main/scripts</scriptSourceDirectory><!--默认的测试源代码地址--><testSourceDirectory>${project.basedir}/src/test/java</testSourceDirectory><!--默认的主源代码当中的资源文件地址--><resources><resource><directory>${project.basedir}/src/main/resources</directory></resource></resources><!--默认的测试源代码当中的资源文件地址--><testResources><testResource><directory>${project.basedir}/src/test/resources</directory></testResource></testResources>
</build>

2.3.2 Spring Boot对resources插件的默认配置

Spring Boot 项目一般我们都会继承一个 spring-boot-starter-parent，而其 pom 当中就默认给我们做了一些 resources 插件的配置，那么我们的的项目 resources 默认配置如下，其会将maven默认配置给替换掉，如下所示：

<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>

这里需要注意一点：假如我们项目当中去声明resources标签，那么他会将继承的父类当中的resources标签给替换掉，说白了就是重写的会覆盖继承的。

三、resources下的标签详解

3.1、filtering 的使用

若是要将src/main/java路径下.fxml文件结尾的编译打包进去，当有两个同类型文件，只想打包进去一个文件，可以在include标签当中指定文件名称。

<build><resources><resource><directory>src/main/java</directory><filtering>true</filtering><includes><include>**/*.fxml</include></includes></resource><resource><directory>src/main/resources</directory><filtering>true</filtering></resource></resources>
</build>

filtering 默认为 false，作用是是否允许指定任意文件可以以 ${...} or @...@ 的语法来提取pom.xml当中的配置。假设在 src/main/resources 目录下有一个application.properties 文件，内容如下：

userName=${userName}
userName=@userName@

这时候可以在pom.xml文件中定义变量的取值：

<propweties><userName>zhangsan</userName>
</propweties>

如果需要对配置文件中变量进行替换实际值，就需要开启 <filtering>，该值设置为true。这里使用了includes标签指定了文件，也就是允许application.properties文件读取变量值。

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

执行mvn clean package -DskipTests 打包，然后打开target/classes目录当中查看资源文件，会发现使用 @...@取值成功了，而${...} 没有成功。这是因为项目继承了spring-boot-starter-parent，而 Spring Boot 的xml当中有一个这个标签 <resource.delimiter> 将取值语法改为了 @...@，因为spring害怕和其他语法有冲突，所以使用了这个配置。

我们也可以通过手动声明来覆盖springboot父类的配置，这样便可以通过${...}语法进行取值了。

<properties><resource.delimiter>${*}</resource.delimiter>
</properties>

这里需要特别注意的是，没有必要使用变量取值的，千万不要将filtering设置为true，针对于这一点官网也明确指出二进制文件一定不要过滤。例如在resources文件夹当中存放有Excel模板，导出模板后发现是乱码的，但是通过源代码打开Excel就是正常的，原因就是将文件给进行过滤了，导致编译过后target当中的Excel都是乱码的。解决方案就是在编译时不进行过滤，但也要被放到resource目录下。修改配置如下：

3.2 include和excludes的使用

关于这个标签官网也有叙述：https://maven.apache.org/plugins/maven-resources-plugin/examples/include-exclude.html

其实实际开发当中很多人对这都是不理解，配置起来也是一顿乱配置。来看下这个图，多看几篇，一旦理解了，就彻底懂了！

**/代表的是根目录，/src/main/resources 和 /src/main/java 这两个都属于根目录，一个*可以代表一个占位符，可以是多个字母组成的。

四、总结

maven-resources-plugin 是一个功能强大且灵活的插件，用于处理项目中的资源文件。通过合理配置，可以实现资源的复制、过滤、设置输出目录等功能。了解并掌握这些配置，可以大大提高项目的灵活性和可维护性。

Apache Maven 插件是 Maven 的核心组成部分，它们扩展了 Maven 的功能，使得 Maven 能够完成各种复杂的构建任务。了解和使用 Maven 插件对于提高项目的构建效率和质量具有重要意义，有效地利用插件来提高 Maven 项目的构建效率和质量。在实际开发中，应根据项目需求选择合适的插件，并合理配置和使用它们，增强项目的可维护性和可扩展性。

Maven核心插件之maven-resources-plugin

前言 Maven 插件是 Maven 构建系统的重要组成部分，它们为 Maven 提供了丰富的功能和扩展能力，使得 Maven 不仅是一个构建工具，更是一个强大的项目管理平台。在 Maven 项目中，插件的使用通常通过配置 pom.xml 文件来完成。每个插件…...

编程日记 2025/5/6 15:13:18

LeetCode 283题：移动零

LeetCode 283题：移动零 (Move Zeroes) LeetCode 第283题要求将数组中的所有零移动到数组的末尾，同时保持非零元素的相对顺序。题目描述给定一个数组 nums，编写一个函数将所有的 0 移动到数组的末尾，同时保持非零元素的相对顺序…...

编程日记 2025/5/5 4:22:59

常见的开源协议及注意事项【精简版】

注： 以下内容出自Github Copilot。常见的开源协议有以下几种，每种协议都有其特定的使用场景和注意事项： MIT许可证： 特点：非常宽松，允许用户自由使用、复制、修改、合并、发布、分发、再许可和/或销售软件…...

编程日记 2025/5/6 13:48:22

【Oracle专栏】2个入参，生成唯一码处理

Oracle相关文档，希望互相学习，共同进步风123456789～-CSDN博客 1.背景业务需要：2个参数，如 aidbankid ，两个值是联合主键，需要生成一个固定唯一码，长度有限制32位，为了…...

编程日记 2025/5/6 14:07:32

component-动态控制 div width 的值根据传入的变量决定width的值 vue

1.实现根据参数的值，div显示不同的长度 <div class"node-line" :style"lineProgress"></div> <script>export default {name: "trainSummaryInfo",data(){return{linePercentage:200,}},computed:{lineProgress…...

编程日记 2025/5/6 9:29:14

＜2025 网络安全＞《网络安全政策法规-关键信息基础设施安全保护条例》

1 政策出台背景 ‌《关键信息基础设施安全保护条例》的实施背景主要包括以下几个方面‌： 首先，‌关键信息基础设施在经济社会中的重要地位使其成为网络安全的核心保护对象‌。关键信息基础设施包括公共通信和信息服务、能源、交通、水利、金融、公共服…...

编程日记 2025/5/6 14:48:28

【MySQL数据库】基础总结

目录前言一、概述二、 SQL 1. SQL通用语法 2. SQL分类 3. DDL 3.1 数据库操作 3.2 表操作 4. DML 5. DQL 5.1 基础查询 5.2 条件查询 5.3 聚合函数 5.4 分组查询 5.5 排序查询 5.6 分页查询 6. DCL 6.1 管理用户 6.2 权限控制三、数据类型 1. 数值类…...

编程日记 2025/5/6 14:54:59

acwing_5721_化学方程式配平

acwing_5721_化学方程式配平这是一道T3的题目，操作起来可能有些棘手，但是耐下心来做一遍会有收获的！ 下面是对于大佬的题解进行的注释 #include <iostream> #include <string> #include <map> #include <vector>…...

编程日记 2025/5/6 13:16:43

C++ 中的 template ＜typename T＞用法 ← 泛型

【语法解析】 ● C 中的 template <typename T> 用法 template <typename T> 是C编程语言中的一个模板声明，用于定义一个模板，其中 T 是一个模板参数，可以是任何类型。这种机制允许程序员编写与类型无关的代码，从而提…...

编程日记 2025/5/3 9:08:58

C语言操作符_位操作符、赋值操作符、单目操作符

1.位操作符 & - 按（2进制）位与 | - 按（2进制）位或 ^ - 按（2进制）位异或只适用于整型例：实现交换两个变量的值，要求不能新建变量 //3^3 0 -> a^a 0 //011 //011 //000 …...

编程日记 2025/5/6 13:34:37

C++ 鼠标轨迹算法 - 防止游戏检测

一.简介鼠标轨迹算法是一种模拟人类鼠标操作的程序，它能够模拟出自然而真实的鼠标移动路径。鼠标轨迹算法的底层实现采用C/C语言，原因在于C/C提供了高性能的执行能力和直接访问操作系统底层资源的能力。鼠标轨迹算法具有以下优势： 模拟…...

编程日记 2025/5/5 17:24:21

计算机网络笔记数据链路层3（局域网，广域网，网桥，交换机）

局域网: LAN:在某一区域内由多台计算机互联成的计算机组，使用广播信道特点： 覆盖范围有限：通常局限在几千米范围内，比如一栋办公楼、一个校园或一个工厂等相对较小的地理区域。数据传输速率高：一般能达到 10Mbps…...

编程日记 2025/5/6 14:04:43

【Qnx】Qnx常用工具

Qnx常用分析工具近期项目中Qnx端常用到的工具，总结一下。查看进程 Display information about the processes in the system (QNX Neutrino) pidin使用pidin命令，可以查看Qnx系统运行的进程信息，包括PID、TID、NAME、PRIO(优先级)、STATE…...

编程日记 2025/5/6 13:26:39

基于 Selenium 实现上海大学校园网自动登录

基于 Selenium 实现上海大学校园网自动登录一、技术方案核心工具： Selenium：一个用于自动化测试的工具，能够模拟用户在浏览器上的操作。Edge WebDriver：用于控制 Edge 浏览器的驱动程序。功能设计： 检测网络状…...

编程日记 2025/5/6 13:43:39

相机小孔成像模型与透视变换

0 背景本文用于记录小孔相机成像的数学模型推导，并讨论特定条件下两个相机之间看到图像的变换关系。 1 小孔成像模型小孔成像模型如上图所示。物理世界发光点P，经过小孔O投影到物理成像平面，形成像点I’。简易起见，构造虚拟成…...

编程日记 2025/5/6 14:14:20

微信小程序订阅消息提醒-云函数

微信小程序消息订阅分2种： 1.一次性订阅：用户订阅一次就可以推送一次，如果需要多次提醒需要多次订阅。 2.长期订阅：只有公共服务领域，如政务、医疗、交通、金融和教育等。‌在用户订阅后，在很长一段时间内…...

编程日记 2025/5/6 14:28:55

语音技术与人工智能：智能语音交互的多场景应用探索

引言近年来，智能语音技术取得了飞速发展，逐渐渗透到日常生活和各行各业中。从语音助手到智能家居控制，再到企业客服和教育辅导，语音交互正以前所未有的速度改变着人机沟通的方式。这一变革背后，人工智能技术无疑是关键…...

编程日记 2025/4/27 19:51:20

ros2笔记-6.2 使用urdf创建机器人模型

本节主要跟着小鱼老师的视频操作，不同的仿真平台有不同的建模语言，但是几乎都支持URDF。本节使用URDF创建一个机器人模型。 6.2.1 帮机器人创建一个身体 URDF使用XML来描述机器人的结构和传感器、执行器等信息。在chapt6/chap6_ws/src创建功能包:r…...

编程日记 2025/5/6 13:28:30

SQL刷题快速入门（二）

其他章节：SQL刷题快速入门（一） 承接上一章节，本章主要讲SQL的运算符、聚合函数、SQL保留小数的几种方式三个部分运算符 SQL 支持多种运算符，用于执行各种操作，如算术运算、比较、赋值、逻辑运算等。以下…...

编程日记 2025/5/4 18:00:24

大数据技术实训：Zookeeper集群配置

一、本地模式安装部署 1）安装前准备 （1）安装jdk （2）拷贝Zookeeper安装包到Linux系统下 （3）解压到指定目录 tar -zxvf zookeeper-3.5.7.tar.gz -C /opt/module/ 2）配置修改 &am…...

编程日记 2025/4/26 4:28:39

SpringBoot日常：集成Kafka

文章目录 1、pom.xml文件2、application.yml3、生产者配置类4、消费者配置类5、消息订阅6、生产者发送消息7、测试发送消息本章内容主要介绍如何在springboot项目对kafka进行整合，最终能达到的效果就是能够在项目中通过配置相关的kafka配置，就能进行消息…...

编程日记 2025/5/1 17:25:03

初学stm32 --- DAC输出三角波和正弦波

输出三角波实验简要： 1，功能描述通过DAC1通道1(PA4)输出三角波，然后通过DS100示波器查看波形 2，关闭通道1触发(即自动) TEN1位置0 3，关闭输出缓冲 BOFF1位置1 4，使用12位右对齐模式将数字量写入DAC_…...

编程日记 2025/5/1 7:57:51

从绝对误差到相对误差：C++ 浮点数比较详解

一般情况下,对于比较两个整数的大小关系,我们通常使用简单的比较运算符进行比较即可得出结论; 考虑下面的程序: #include <iostream> #include<cmath> #include <algorithm>int main() {int a {1};int b {2};std::cout << std::boolalpha;std::cout …...

编程日记 2025/4/29 21:00:34

Chrome_60.0.3112.113_x64 单文件版下载

单文件，免安装，直接用~ Google Chrome, 免費下載. Google Chrome 60.0.3112.113: Chrome 是 Google 開發的網路瀏覽器。它的特點是速度快,功能多。下载地址: https://blog.s3.sh.cn/thread-150-1-1.htmlhttps://blog.s3.sh.cn/thread-150-1-1.html...

编程日记 2025/4/30 21:16:51

《自动驾驶与机器人中的SLAM技术》ch1：自动驾驶

目录 1.1 自动驾驶技术 1.2 自动驾驶中的定位与地图 1.1 自动驾驶技术 1.2 自动驾驶中的定位与地图 L2 在技术实现上会更倾向于实时感知，乃至可以使用感知结果直接构建鸟瞰图（bird eye view, BEV），而 L4 则依赖离线地图。高精地…...

编程日记 2025/4/25 20:46:47

httpx.AsyncClient报错ProxyError: 504 Gateway Time-out

## 场景： 同一个URL，用requests.get能正常获取网页内容，用httpx.get和httpx.AsyncClient.get就不行，要么就报超时，要么就报ProxyError: 504 Gateway Time-out import anyio, httpx, requestsurl https://my-domain.…...

编程日记 2025/5/6 14:12:07

常见的http状态码 + ResponseEntity

常见的http状态码 ResponseStatus(HttpStatus.CREATED) 是 Spring Framework 中的注解，用于指定 HTTP 响应状态码。 1. 基本说明 HttpStatus.CREATED 对应 HTTP 状态码 201表示请求成功且创建了新的资源通常用于 POST 请求的处理方法上 2. 使用场景和示例基本…...

编程日记 2025/5/4 13:56:58

完全自定义Qt翻译功能，不使用Qt Linguist的.ts 和 .qm类型翻译

这篇文章展示了集成Qt Linguist 的功能。但是有时候Qt的翻译功能比较繁琐，我们简单项目只需要使用本地化功能，将中文字符串导入到项目中，避免编码格式问题导致的乱码。只需要使用一个简单的json或者其他格式的本地文件作为映射的key/value.…...

编程日记 2025/5/4 22:07:08

std::array

std::array 是 C 标准库中的一个容器，定义在 <array> 头文件中。它是一个固定大小的数组容器，封装了 C 风格数组，并提供了更多的功能和安全性。与 C 风格数组相比，std::array 具有以下优点： （1&#…...

编程日记 2025/5/3 6:41:46

Go语言中的接收器（Receiver）详解

在 Go 语言中，接收器（Receiver） 是指在方法声明中与方法绑定的对象。它是 Go 语言实现面向对象编程（OOP）特性的核心之一。接收器的作用是将方法绑定到某个类型的实例（值或者指针），让…...

编程日记 2025/4/30 21:55:33

linux下实现U盘和sd卡的自动挂载

linux下实现U盘和sd卡的自动挂载 Chapter0 linux下实现U盘和sd卡的自动挂载 Chapter0 linux下实现U盘和sd卡的自动挂载原文链接：https://blog.csdn.net/EmSoftEn/article/details/45099699 目的：使U盘和SD卡在Linux系统中进行插入和拔除时能自动挂载和…...

编程日记 2025/5/5 14:45:50

TVS管工作原理及其选型

工作原理当TVS管两端的方向电压大于一定值时，TVS会被反向击穿，瞬间形成一个导通回路，将大电流导出，从而将TVS两端的电压控制在一个固定电压，来保护与TVS管并联的电路。单向&双向TVS工作特性曲线 Vrwm→反向导通…...

编程日记 2025/5/5 14:16:58

Web前端界面开发

前沿：介绍自适应和响应式布局自适应布局：-----针对页面1个像素的变换而变化就是我们上一个练习的效果我们的页面效果，随着我们的屏幕大小而发生适配的效果（类似等比例） 如：rem适配和 vw/vh适配 …...

编程日记 2025/5/1 17:12:53

预编译SQL

预编译SQL 预编译SQL是指在数据库应用程序中，SQL语句在执行之前已经通过某种机制（如预编译器）进行了解析、优化和准备，使得实际执行时可以直接使用优化后的执行计划，而不需要每次都重新解析和编译。这么说可能有一些抽…...

编程日记 2025/5/1 20:54:58

学英语学Elasticsearch：04 Elastic integrations 工具箱实现对第三方数据源的采集、存储、可视化，开箱即用

📢📢📢： 先看关键单词，再看英文，最后看中文总结，再回头看一遍英文原文，效果更佳！！ 关键词 ingestion 摄取 /ɪnˈdʒɛstʃən/ observability 可观察性 …...

编程日记 2025/5/1 9:46:34

【开源免费】基于Vue和SpringBoot的城镇保障性住房管理系统（附论文）

本文项目编号 T 122 ，文末自助获取源码 \color{red}{T122，文末自助获取源码} T122，文末自助获取源码目录一、系统介绍二、数据库设计三、配套教程3.1 启动教程3.2 讲解视频3.3 二次开发教程四、功能截图五、文案资料5.1 选题背景5.2 国内…...

编程日记 2025/5/5 0:59:29

HTML和CSS相关的问题，为什么某些元素的字体无法加载？

当你在HTML和CSS中遇到字体无法加载的情况时，通常是由几个常见的问题引起的。以下是一些可能导致字体无法加载的原因，以及如何解决这些问题。常见原因及解决方法字体文件路径错误字体格式不兼容缺少字体的font-face声明字体加载顺序问题浏览器缓存问…...

编程日记 2025/4/29 10:49:53

[ Spring ] Install MongoDB on Ubuntu24

文章目录 Disable THP ServiceRemove File and Process Count LimitationEnable Swappiness for MongoDBInstall MongoDBEnable MongoDB ServiceCreate MongoDB Admin UserEnable MongoDB AuthenticationCreate a Normal DatabaseUpdate User RolesInsert DocumentUninstall Mo…...

编程日记 2025/5/5 17:20:06

前言