EAR 插件允许自动生成描述符部署,例如application.xml。这一代已经由目标的参数定制,请参阅目标描述。
EAR Plugin 的配置与其他插件的配置没有任何不同。配置应类似于:
<project> [...] <build> [...] <plugins> [...] <plugin> <artifactId>maven-ear-plugin</artifactId> <version>2.4.2</version> <configuration> <!-- configuration elements goes here --> </configuration> </plugin> [...] </project>
在 pom.xml 中配置 EAR 插件时,不要在其中声明任何 <executions> 元素,因为它在ear项目的打包阶段总是至少调用一次。
当您的项目 <packaging> 为ear时,EAR 插件将替换 Jar 插件。所以要生成你的 EAR 包,你只需要像这样调用包阶段:
mvn package
EAR 的默认资源目录是由earSourcesDirectory参数定义的src/main/application 。如果需要,可以使用过滤参数过滤此目录的内容。
有关更多详细信息,请查看示例。
任何 EAR 模块都可以进一步定制如下:
可以使用 contextRoot 参数自定义 Web 模块的上下文根。
请注意,第三方库(即 JarModule)不包含在生成的 application.xml 中(只有 ejb-client 应该包含在java条目中)。但是,可以通过指定includeInApplicationXml标志将 jar 依赖项包含在生成的 application.xml 中。
还可以通过指定defaultLibBundleDir参数为所有第三方库指定默认捆绑目录。
可以在 security 参数下指定安全设置。
默认情况下应该解包的工件类型可以使用 unpackTypes 参数指定
用于存储在 EAR 中的工件的文件名映射可以使用fileNameMapping参数来指定。此参数的有效值为standard(默认)和full。通过将full指定为文件名映射,工件以groupId为前缀,其中的点已替换为破折号。
有关 EAR 模块的更多信息,请参阅模块配置页面。
您可以查看示例以获取有关这些高级配置的更多信息。
EAR 插件可以自动生成 jboss-app.xml。为此,必须配置“jboss”元素并采用以下子元素:
下面的 pom 片段完全配置了以下 loader 存储库
<loader-repository loaderRepositoryClass='dot.com.LoaderRepository'> dot.com:loader=unique-archive-name <loader-repository-config configParserClass='dot.com.LoaderParser'> java2ParentDelegation=true </loader-repository-config> </loader-repository>
<configuration> <jboss> [...] <loader-repository loaderRepositoryClass="dot.com.LoaderRepository"> dot.com:loader=unique-archive-name </loader-repository> <loader-repository-config configParserClass="dot.com.LoaderParser"> java2ParentDelegation=true </loader-repository-config> </jboss> </configuration>
<configuration> <jboss> [...] <data-sources> <data-source>main-ds.xml</data-source> <data-source>config/secondary-ds.xml</data-source> [...] </data-sources> </jboss> </configuration>
Hibernate 归档 (HAR) 和服务归档 (SAR) 将被自动识别并添加到 jboss-app.xml 文件中。
您可以查看示例以获取有关 JBoss 支持的更多信息。