资源:资源

全名

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-resourcesdefault-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.buildFiltersResourcesMojo.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-resourcesdefault-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.buildFiltersResourcesMojo.filters
  • 类型布尔值
  • : 2.4
  • 要求
  • 默认值

使用默认分隔符

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