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