耳朵:生成应用程序 xml

全名

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

说明

生成 EAR 部署描述符文件。

属性

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

必需参数

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

可选参数

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

参数详情

<应用程序ID>

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

<应用程序名称>

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

<artifactTypeMappings>

工件类型映射。
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 必需No

<defaultLibBundleDir>

库的默认捆绑目录。
  • 类型java.lang.String
  • 必需No

<说明>

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

<显示名称>

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

<ejbRefs>

ejb-ref条目。
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 必需No
  • 别名ejb-refs

<编码>

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

<环境条目>

要添加到自动生成的 application.xml 文件中的 env 条目。从 JavaEE6.
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 必需No
  • 别名env-entries

<文件名映射>

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

<generateApplicationXml>

是否应生成 application.xml。
  • 类型java.lang.Boolean
  • 必需No
  • 默认true

<generateModuleId>

如果没有指定,是否应该生成模块 ID。
  • 类型java.lang.Boolean
  • 必需No
  • 默认false

<生成的描述符位置>

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

<includeLibInApplicationXml>

是否应该在 application.xml 中添加库
  • 类型java.lang.Boolean
  • 必需No
  • 默认false

<初始化顺序>

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

<老板>

JBoss 特定配置。
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 必需No

<图书馆目录模式>

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

<mainArtifactId>

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

<模块>

耳模块配置。
  • 类型org.apache.maven.plugins.ear.EarModule[]
  • 必需No

<输出文件名映射>

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

<resourceRefs>

resource-ref条目。
  • 类型org.codehaus.plexus.configuration.PlexusConfiguration
  • 必需No

<安全>

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

<临时文件夹>

临时文件夹位置。
  • 类型java.io.File
  • 必需Yes
  • 默认${project.build.directory}

<使用基础版本>

使用outputFileNameMappingwith 版本时,请使用baseVersionversion. 当工件是 SNAPSHOT 时, version将始终返回一个带有 -SNAPSHOT后缀的值,而不是可能的时间戳值。
  • 类型java.lang.Boolean
  • 必需No

<版本>

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

<工作目录>

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