耳朵:生成应用程序 xml

全名

org.apache.maven.plugins:maven-ear-plugin:3.0.0:generate-application-xml

说明

生成 EAR 部署描述符文件。

属性

  • 需要执行一个 Maven 项目。
  • 需要对范围内的工件进行依赖解析:test
  • 默认绑定到生命周期阶段generate-resources

必需参数

姓名 类型 自从 描述
<输出文件名映射> 细绳 3.0.0 用于 EAR 文件中包含的所有依赖项的文件名映射。工件与 EAR 文件中使用的文件名之间的映射。详情请参阅Maven 映射参考
默认值为@{groupId}@-@{artifactId}@-@{version}@@{dashClassifier?}@.@{extension}@
<临时文件夹> 文件 - 临时文件夹位置。
默认值为${project.build.directory}
<工作目录> 文件 - 在构建期间将资源复制到的目录。
默认值为${project.build.directory}/${project.build.finalName}

可选参数

姓名 类型 自从 描述
<应用程序ID> 细绳 2.9 定义生成部署描述符时使用的应用程序 ID。
<应用程序名称> 细绳 - 自动生成 application.xml 文件时要使用的应用程序的应用程序名称。从 JavaEE6.
<artifactTypeMappings> 丛配置 - 工件类型映射。
<defaultLibBundleDir> 细绳 - 库的默认捆绑目录。
<说明> 细绳 - 自动生成 application.xml 文件时要使用的应用程序的描述。
默认值为${project.description}
<显示名称> 细绳 - 自动生成 application.xml 文件时要使用的应用程序的显示名称。
默认值为${project.artifactId}
<ejbRefs> 丛配置 - ejb-ref条目。
别名是ejb-refs
<编码> 细绳 - 自动生成的部署文件的字符编码。
默认值为UTF-8
<环境条目> 丛配置 - 要添加到自动生成的 application.xml 文件中的 env 条目。从 JavaEE6.
别名是env-entries
<文件名映射> 细绳 - 已弃用。没有给出理由
<generateApplicationXml> 布尔值 - 是否应生成 application.xml。
默认值为true
<generateModuleId> 布尔值 - 如果没有指定,是否应该生成模块 ID。
默认值为false
<生成的描述符位置> 细绳 - 将自动生成部署描述符文件的目录。
默认值为${project.build.directory}
<includeLibInApplicationXml> 布尔值 - 是否应在 application.xml 中添加库
默认值为false
<初始化顺序> 布尔值 - 定义在自动生成 application.xml 文件时要使用的初始化顺序元素的值。当设置为 true 时,模块必须按照它们在此部署描述符中列出的顺序进行初始化,但可以按任何顺序初始化的应用程序客户端模块除外。如果 initialize-in-order 未设置或设置为 false,则初始化顺序未指定并且可能取决于产品。从 JavaEE6.
<老板> 丛配置 - JBoss 特定配置。
<图书馆目录模式> 细绳 - 定义应如何将library-directory元素写入 application.xml 文件。可以设置三个特殊值:
  • DEFAULT (默认)使用defaultLibBundleDir参数的值生成一个 library-directory元素
  • EMPTY生成一个空的 library-directory元素。根据规范,这将禁用对 ear 文件的lib目录中的 jar 文件的扫描
  • NONE根本不写 library-directory 元素。一个可以在 Oracle Weblogic 中用于将类加载委托给容器的极端案例
从 JavaEE5.
默认值为DEFAULT
<mainArtifactId> 细绳 - 当有多个候选对象时,用于定义主要工件(例如,没有分类器的工件)的 id。
<模块> 耳模块[] - 耳模块配置。
<resourceRefs> 丛配置 - 资源引用条目。
<安全> 丛配置 - 要添加到自动生成的 application.xml 文件的安全角色。
<使用基础版本> 布尔值 - outputFileNameMapping与版本一起使用时,请使用baseVersionversion。当工件是 SNAPSHOT 时, 版本将始终返回带有 -SNAPSHOT后缀的值,而不是可能的时间戳值。
<版本> 细绳 - 要生成的 application.xml 的版本。有效值为 1.3、1.4、5、6、7 和 8。
默认值为7

参数详情

<应用程序ID>

定义生成部署描述符时使用的应用程序 ID。
  • 类型java.lang.String
  • : 2.9
  • 要求

<应用程序名称>

自动生成 application.xml 文件时要使用的应用程序的应用程序名称。从 JavaEE6.
  • 类型java.lang.String
  • 要求

<artifactTypeMappings>

工件类型映射。
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 要求

<defaultLibBundleDir>

库的默认捆绑目录。
  • 类型java.lang.String
  • 要求

<说明>

自动生成 application.xml 文件时要使用的应用程序的描述。
  • 类型java.lang.String
  • 要求
  • 默认值${project.description}

<显示名称>

自动生成 application.xml 文件时要使用的应用程序的显示名称。
  • 类型java.lang.String
  • 要求
  • 默认值${project.artifactId}

<ejbRefs>

ejb-ref条目。
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 要求
  • 别名ejb-refs

<编码>

自动生成的部署文件的字符编码。
  • 类型java.lang.String
  • 要求
  • 默认值UTF-8

<环境条目>

要添加到自动生成的 application.xml 文件中的 env 条目。从 JavaEE6.
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 要求
  • 别名环境条目

<文件名映射>

已弃用。没有给出理由
仅在此处确定迁移问题。使用此参数将导致构建失败。如果您需要文件名映射,请改用 outputFileNameMapping
  • 类型java.lang.String
  • 要求

<generateApplicationXml>

是否应生成 application.xml。
  • 类型java.lang.Boolean
  • 要求
  • 默认值

<generateModuleId>

如果没有指定,是否应该生成模块 ID。
  • 类型java.lang.Boolean
  • 要求
  • 默认值

<生成的描述符位置>

将自动生成部署描述符文件的目录。
  • 类型java.lang.String
  • 要求
  • 默认值${project.build.directory}

<includeLibInApplicationXml>

是否应该在 application.xml 中添加库
  • 类型java.lang.Boolean
  • 要求
  • 默认值

<初始化顺序>

定义在自动生成 application.xml 文件时要使用的初始化顺序元素的值。当设置为 true 时,模块必须按照它们在此部署描述符中列出的顺序进行初始化,但可以按任何顺序初始化的应用程序客户端模块除外。如果 initialize-in-order 未设置或设置为 false,则初始化顺序未指定并且可能取决于产品。从 JavaEE6.
  • 类型java.lang.Boolean
  • 要求

<老板>

JBoss 特定配置。
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 要求

<图书馆目录模式>

定义应如何将library-directory元素写入 application.xml 文件。可以设置三个特殊值:
  • DEFAULT (默认)使用defaultLibBundleDir参数的值生成一个 library-directory元素
  • EMPTY生成一个空的 library-directory元素。根据规范,这将禁用对 ear 文件的lib目录中的 jar 文件的扫描
  • NONE根本不写 library-directory 元素。一个可以在 Oracle Weblogic 中用于将类加载委托给容器的极端案例
从 JavaEE5.
  • 类型java.lang.String
  • 要求
  • 默认默认

<mainArtifactId>

当有多个候选对象时,用于定义主要工件(例如,没有分类器的工件)的 id。
  • 类型java.lang.String
  • 要求

<模块>

耳模块配置。
  • 类型org.apache.maven.plugins.ear.EarModule[]
  • 要求

<输出文件名映射>

用于 EAR 文件中包含的所有依赖项的文件名映射。工件与 EAR 文件中使用的文件名之间的映射。详情请参阅Maven 映射参考
  • 类型java.lang.String
  • 3.0.0
  • 要求
  • 默认值@{groupId}@-@{artifactId}@-@{version}@@{dashClassifier?}@.@{extension}@

<resourceRefs>

资源引用条目。
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 要求

<安全>

要添加到自动生成的 application.xml 文件的安全角色。
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 要求

<临时文件夹>

临时文件夹位置。
  • 类型java.io.File
  • 要求
  • 默认值${project.build.directory}

<使用基础版本>

outputFileNameMapping与版本一起使用时,请使用baseVersionversion。当工件是 SNAPSHOT 时, 版本将始终返回带有 -SNAPSHOT后缀的值,而不是可能的时间戳值。
  • 类型java.lang.Boolean
  • 要求

<版本>

要生成的 application.xml 的版本。有效值为 1.3、1.4、5、6、7 和 8。
  • 类型java.lang.String
  • 要求
  • 默认值7

<工作目录>

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