rar:rar

全名:

org.apache.maven.plugins:maven-rar-plugin:2.4:rar

说明:

构建 J2EE 资源适配器归档 (RAR) 文件。

属性:

  • 需要执行一个 Maven 项目。
  • 需要对范围内的工件进行依赖解析:test。
  • 目标是线程安全的并支持并行构建。
  • 默认绑定到生命周期阶段:包。

必需参数

姓名 类型 自从 描述
最终名称 细绳 - 要生成的 RAR 文件的名称。
默认值为:${project.build.finalName}。
输出目录 文件 - 生成的 RAR 的目录。
默认值为:${project.build.directory}。
rarSource 目录 文件 - 要包含在 RAR 中的额外文件的单个目录。
默认值为:${basedir}/src/main/rar。
工作目录 细绳 - 在构建期间将资源复制到的目录。
默认值为:${project.build.directory}/${project.build.finalName}。

可选参数

姓名 类型 自从 描述
档案 Maven存档配置 - 要使用的存档配置。请参阅Maven 存档器参考。
分类器 细绳 2.4 添加到生成的工件的分类器。如果给出,工件将被附加。如果没有给出,它只会根据 finalName 写入输出目录。
用户属性为:maven.rar.classifier。
分隔符 列表 2.3

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

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

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

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


编码 细绳 2.3 (无描述)
默认值为:${project.build.sourceEncoding}。
用户属性是:编码。
转义字符串 细绳 2.3 不会插入以字符串开头的表达式 ${foo} 将替换为 ${foo}
用户属性是:maven.resources.escapeString。
转义Windows路径 布尔值 2.3 是否在 windows 风格的路径中转义反斜杠和冒号。
默认值为:true。
用户属性是:maven.resources.escapeWindowsPaths。
过滤器RarSourceDirectory 布尔值 2.3 允许过滤链接{rarSourceDirectory}
默认值为:false。
用户属性为:rar.filterRarSourceDirectory。
过滤器 列表 2.3 要使用的额外过滤器属性文件列表,以及在 POM 构建/过滤器部分中指定的系统属性、项目属性和过滤器属性文件,这些文件应该用于当前 mojo 执行期间的过滤。
通常,这些将从插件的执行部分配置,为特定执行提供一组不同的过滤器。例如,从 Maven 2.2.0 开始,您可以选择使用 id 的 default-resources和 default-testResources配置执行,以便为两种不同类型的资源提供不同的配置。通过提供extraFilters配置,您可以区分哪些过滤器用于哪种类型的资源。
包括空目录 布尔值 2.3 复制资源中包含的任何空目录。
默认值为:false。
用户属性是:maven.resources.includeEmptyDirs。
包括罐子 布尔值 - 指定该项目生成的jar文件是否应包含在rar文件中;默认为真。
清单文件 文件 - 要在 rar 文件中使用的清单文件的位置。
默认值为:${basedir}/src/main/rar/META-INF/MANIFEST.MF。
非过滤文件扩展 列表 2.3 不应用过滤的附加文件扩展名(已定义为:jpg、jpeg、gif、bmp、png)
覆盖 布尔值 2.3 即使目标文件较新,也要覆盖现有文件。
默认值为:false。
用户属性是:maven.resources.overwrite。
raXml文件 文件 - 要在 rar 文件中使用的 ra.xml 文件的位置。
默认值为:${basedir}/src/main/rar/META-INF/ra.xml。
资源 列表 2.3 要包含在 rar 存档中的额外资源
跳过 布尔值 2.4 跳过 rar mojo 的执行。
用户属性为:maven.rar.skip。
支持MultiLineFiltering 布尔值 2.3 在行尾停止搜索 endToken
默认值为:false。
用户属性是:maven.resources.supportMultiLineFiltering。
使用默认分隔符 布尔值 2.3 (无描述)
默认值为:true。
warnOnMissingRaXml 布尔值 2.3 如果ra.xml文件丢失,是否发出警告。如果您希望在没有 ra.xml文件的情况下构建 RAR,请设置为false 。如果您针对 JCA 1.6 或更高版本进行构建,这可能会很有用。默认值为:true。用户属性是:warnOnMissingRaXml。

参数详情

存档:

要使用的存档配置。请参阅Maven 存档器参考。
  • 类型:org.apache.maven.archiver.MavenArchiveConfiguration
  • 要求:否

分类器:

添加到生成的工件的分类器。如果给出,工件将被附加。如果没有给出,它只会根据 finalName 写入输出目录。
  • 类型:java.lang.String
  • 从: 2.4
  • 要求:否
  • 用户属性:maven.rar.classifier

分隔符:

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

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

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

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

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

编码:

(没有说明)
  • 类型:java.lang.String
  • 从: 2.3
  • 要求:否
  • 用户属性:编码
  • 默认值:${project.build.sourceEncoding}

转义字符串:

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

转义WindowsPaths:

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

filterRarSourceDirectory :

允许过滤链接{rarSourceDirectory}
  • 类型:布尔值
  • 从: 2.3
  • 要求:否
  • 用户属性:rar.filterRarSourceDirectory
  • 默认值:假

过滤器:

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

最终名称:

要生成的 RAR 文件的名称。
  • 类型:java.lang.String
  • 要求:是
  • 默认值:${project.build.finalName}

包括空目录:

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

包括罐子:

指定该项目生成的jar文件是否应包含在rar文件中;默认为真。
  • 类型:java.lang.Boolean
  • 要求:否

清单文件:

要在 rar 文件中使用的清单文件的位置。
  • 类型:java.io.File
  • 要求:否
  • 默认值:${basedir}/src/main/rar/META-INF/MANIFEST.MF

非过滤文件扩展:

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

输出目录:

生成的 RAR 的目录。
  • 类型:java.io.File
  • 要求:是
  • 默认值:${project.build.directory}

覆盖:

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

raXml 文件:

要在 rar 文件中使用的 ra.xml 文件的位置。
  • 类型:java.io.File
  • 要求:否
  • 默认:${basedir}/src/main/rar/META-INF/ra.xml

资源:

要包含在 rar 存档中的额外资源
  • 类型:java.util.List
  • 从: 2.3
  • 要求:否

rarSourceDirectory:

要包含在 RAR 中的额外文件的单个目录。
  • 类型:java.io.File
  • 要求:是
  • 默认:${basedir}/src/main/rar

跳过:

跳过 rar mojo 的执行。
  • 类型:布尔值
  • 从: 2.4
  • 要求:否
  • 用户属性:maven.rar.skip

支持多线过滤:

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

使用默认分隔符:

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

warnOnMissingRaXml:

如果ra.xml文件丢失,是否发出警告。如果您希望在没有 ra.xml文件的情况下构建 RAR,请设置为false 。如果您针对 JCA 1.6 或更高版本进行构建,这可能会很有用。
  • 类型:布尔值
  • 从: 2.3
  • 要求:否
  • 用户属性:warnOnMissingRaXml
  • 默认值:真

工作目录:

在构建期间将资源复制到的目录。
  • 类型:java.lang.String
  • 要求:是
  • 默认值:${project.build.directory}/${project.build.finalName}