资源:资源

全名:

org.apache.maven.plugins:maven-resources-plugin:2.6:resources

说明:

将主源代码的资源复制到主输出目录。始终使用 project.build.resources 元素来指定要复制的资源。

属性:

  • 需要执行一个 Maven 项目。
  • 目标是线程安全的并支持并行构建。
  • 默认绑定到生命周期阶段:process-resources。

必需参数

姓名 类型 自从 描述
输出目录 文件 - 要将资源复制到其中的输出目录。
默认值为:${project.build.outputDirectory}。

可选参数

姓名 类型 自从 描述
分隔符 列表 2.4

用于在资源中过滤的表达式的分隔符集。这些定界符以“beginToken*endToken”的形式指定。如果没有给出“*”,则假定开始和结束的分隔符相同。

因此,默认过滤分隔符可以指定为:

<delimiters>
  <delimiter>${*}</delimiter>
  <delimiter>@</delimiter>
</delimiters>

由于'@'分隔符在两端是相同的,我们不需要指定'@*@'(尽管我们可以)。


编码 细绳 - 过滤资源时要应用的字符编码方案。
默认值为:${project.build.sourceEncoding}。
用户属性是:编码。
转义字符串 细绳 2.3 不会插入以字符串开头的表达式 ${foo} 将替换为 ${foo}
用户属性是:maven.resources.escapeString。
转义Windows路径 布尔值 2.4 是否在 windows 风格的路径中转义反斜杠和冒号。
默认值为:true。
用户属性是:maven.resources.escapeWindowsPaths。
过滤器 列表 - 要使用的额外过滤器属性文件列表,以及在 POM 构建/过滤器部分中指定的系统属性、项目属性和过滤器属性文件,这些文件应该用于当前 mojo 执行期间的过滤。
通常,这些将从插件的执行部分配置,为特定执行提供一组不同的过滤器。例如,从 Maven 2.2.0 开始,您可以选择使用 id 的 default-resources和 default-testResources配置执行,以便为两种不同类型的资源提供不同的配置。通过提供extraFilters配置,您可以区分哪些过滤器用于哪种类型的资源。
包括空目录 布尔值 2.3 复制资源中包含的任何空目录。
默认值为:false。
用户属性是:maven.resources.includeEmptyDirs。
mavenFilteringHints 列表 2.4

实现 MavenResourcesFiltering.filterResources()的丛组件提示列表。它们将在资源复制/过滤后执行。


非过滤文件扩展 列表 2.3 不应用过滤的附加文件扩展名(已定义为:jpg、jpeg、gif、bmp、png)
覆盖 布尔值 2.3 即使目标文件较新,也要覆盖现有文件。
默认值为:false。
用户属性是:maven.resources.overwrite。
支持MultiLineFiltering 布尔值 2.5 在行尾停止搜索 endToken
默认值为:false。
用户属性是:maven.resources.supportMultiLineFiltering。
使用构建过滤器 布尔值 2.4 如果为 false,则在此 mojo 执行中处理资源时不要使用 POM 的 build/filters 部分中指定的过滤器。
另请参阅:ResourcesMojo.buildFilters和 ResourcesMojo.filters
默认值为:true。
使用默认分隔符 布尔值 2.4 (无描述)
默认值为:true。

参数详情

分隔符:

用于在资源中过滤的表达式的分隔符集。这些定界符以“beginToken*endToken”的形式指定。如果没有给出“*”,则假定开始和结束的分隔符相同。

因此,默认过滤分隔符可以指定为:

<delimiters>
  <delimiter>${*}</delimiter>
  <delimiter>@</delimiter>
</delimiters>

由于'@'分隔符在两端是相同的,我们不需要指定'@*@'(尽管我们可以)。

  • 类型:java.util.List
  • 从: 2.4
  • 要求:否

编码:

过滤资源时要应用的字符编码方案。
  • 类型:java.lang.String
  • 要求:否
  • 用户属性:编码
  • 默认值:${project.build.sourceEncoding}

转义字符串:

不会插入以字符串开头的表达式 ${foo} 将替换为 ${foo}
  • 类型:java.lang.String
  • 从: 2.3
  • 要求:否
  • 用户属性:maven.resources.escapeString

转义WindowsPaths:

是否在 windows 风格的路径中转义反斜杠和冒号。
  • 类型:布尔值
  • 从: 2.4
  • 要求:否
  • 用户属性:maven.resources.escapeWindowsPaths
  • 默认值:真

过滤器:

要使用的额外过滤器属性文件列表,以及在 POM 构建/过滤器部分中指定的系统属性、项目属性和过滤器属性文件,这些文件应该用于当前 mojo 执行期间的过滤。
通常,这些将从插件的执行部分配置,为特定执行提供一组不同的过滤器。例如,从 Maven 2.2.0 开始,您可以选择使用 id 的 default-resources和 default-testResources配置执行,以便为两种不同类型的资源提供不同的配置。通过提供extraFilters配置,您可以区分哪些过滤器用于哪种类型的资源。
  • 类型:java.util.List
  • 要求:否

包括空目录:

复制资源中包含的任何空目录。
  • 类型:布尔值
  • 从: 2.3
  • 要求:否
  • 用户属性:maven.resources.includeEmptyDirs
  • 默认值:假

mavenFilteringHints:

实现 MavenResourcesFiltering.filterResources()的丛组件提示列表。它们将在资源复制/过滤后执行。

  • 类型:java.util.List
  • 从: 2.4
  • 要求:否

非过滤文件扩展:

不应用过滤的附加文件扩展名(已定义为:jpg、jpeg、gif、bmp、png)
  • 类型:java.util.List
  • 从: 2.3
  • 要求:否

输出目录:

要将资源复制到其中的输出目录。
  • 类型:java.io.File
  • 要求:是
  • 默认值:${project.build.outputDirectory}

覆盖:

即使目标文件较新,也要覆盖现有文件。
  • 类型:布尔值
  • 从: 2.3
  • 要求:否
  • 用户属性:maven.resources.overwrite
  • 默认值:假

支持多线过滤:

停止在行尾搜索 endToken
  • 类型:布尔值
  • 从: 2.5
  • 要求:否
  • 用户属性:maven.resources.supportMultiLineFiltering
  • 默认值:假

使用构建过滤器:

如果为 false,则在此 mojo 执行中处理资源时不要使用 POM 的 build/filters 部分中指定的过滤器。
另请参阅:ResourcesMojo.buildFilters和 ResourcesMojo.filters
  • 类型:布尔值
  • 从: 2.4
  • 要求:否
  • 默认值:真

使用默认分隔符:

(没有说明)
  • 类型:布尔值
  • 从: 2.4
  • 要求:否
  • 默认值:真