用法

介绍

EAR 插件允许自动生成部署描述符，例如application.xml。这一代已经由目标的参数定制，请参阅目标描述。

配置 EAR 插件

EAR 插件的配置与其他插件的配置没有任何不同。配置应类似于：

<project>
  [...]
  <build>
    [...]
    <plugins>
      [...]
      <plugin>
        <artifactId>maven-ear-plugin</artifactId>
        <version>2.6</version>
        <configuration>
          <!-- configuration elements goes here -->
        </configuration>
      </plugin>
   [...]
</project>

在pom.xml中配置 EAR 插件时，不要在其中声明任何<executions>元素，因为它在ear项目的打包阶段总是至少调用一次。

执行和生成你的 EAR 包

当您的项目<packaging>为ear时，EAR 插件将替换 JAR 插件。所以要生成你的 EAR 包，你只需要像这样调用包阶段：

mvn package

复制资源

EAR 的默认资源目录是由earSourceDirectory参数定义的src/main/application 。如果需要，可以使用过滤参数过滤此目录的内容。

有关更多详细信息，请查看示例。

高级配置

任何 EAR 模块都可以进一步定制如下：

  • bundleDir：EAR 结构中将存储工件的目录。
  • bundleFileName：EAR 结构中工件的名称。
  • uri： EAR 结构中工件的完整路径。
  • exclude ：从生成的 EAR 中排除工件。
  • unpack：解压生成的 EAR 中的工件。

可以使用contextRoot参数自定义 Web 模块的上下文根。

请注意，第三方库（即 JarModule）不包含在生成的application.xml中（只有ejb-client应该包含在java条目中）。但是，可以通过指定includeInApplicationXml标志将jar依赖项包含在生成的application.xml中。

还可以通过指定defaultLibBundleDir参数为所有第三方库指定默认捆绑目录。

可以在security参数下指定安全设置。

默认情况下应该解包的工件类型可以使用unpackTypes参数指定。

用于存储在 EAR 中的工件的文件名映射可以使用fileNameMapping参数来指定。此参数的有效值为标准（默认）、完整和无版本。通过将full指定为文件名映射，工件以groupId为前缀，其中的点已替换为破折号。no-version可以用作默认映射的替换；唯一的区别是省略了版本。

有关 EAR 模块的更多信息，请参阅模块配置页面。

您可以查看示例以获取有关这些高级配置的更多信息。

JBoss 支持

EAR 插件可以自动生成jboss-app.xml。为此，必须配置<jboss>元素并采用以下子元素：

  • version：要使用的目标 JBoss 版本，3.2、4、4.2 或 5（默认为 4）。
  • library-directory：可以在 EAR 中找到库的目录（仅限 JBoss 4.2+）。
  • security-domain：安全管理器的 JNDI 名称（仅限 JBoss 4+）。
  • unauthenticated-principal：未经身份验证的主体（仅限 JBoss 4+）。
  • loader-repository : UnifiedLoaderRepository MBean 的名称，用于 EAR 以提供部署在 ear 中的类的 ear 级别范围。它可以有一个loaderRepositoryClass属性，该属性定义要使用的类加载器存储库类。
  • loader-repository-config：类加载器存储库配置。如果没有定义loader-repository元素，则添加一个默认元素。它可以有一个configParserClass属性，该属性定义要使用的类加载器的配置解析器类。

    下面的 POM 片段完全配置了以下加载程序存储库

    <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>
  • jmx-name：EAR MBean 的对象名称。
  • module-order：指定在application.xml文件中指定的模块被加载的顺序（仅限 JBoss 4.2+）。
  • data-sources：指定要添加到jboss-app.xml中的所需数据源，用法如下：
    <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 支持的更多信息。