The EAR Plugin allows to generate automatically the deployment descriptor, e.g. application.xml. This generation is already customized by the goal's parameters, see the goals description.
The configuration of the EAR Plugin is not any different to the configuration of the other plugins. The configuration should be similar to:
<project> [...] <build> [...] <plugins> [...] <plugin> <artifactId>maven-ear-plugin</artifactId> <version>2.5</version> <configuration> <!-- configuration elements goes here --> </configuration> </plugin> [...] </project>
When configuring the EAR Plugin in your pom.xml, you do not declare any <executions> elements in it because it is always invoked at least once during the package phase of an ear project.
The EAR Plugin replaces the JAR Plugin when your project <packaging> is ear. So to generate your EAR package, you need only call the package phase like so:
The default resource directory for an EAR is src/main/application as defined by the earSourcesDirectory parameter. The content of this directory may be filtered if necessary using the filtering parameter.
For more details, have a look at the examples.
Any EAR module might be further customized as follows:
The context root of a Web module might be customized using the contextRoot parameter.
Please note that third party libraries (i.e. JarModule) are not included in the generated application.xml (only ejb-client should be included in a java entry). However, a jar dependency could be included in the generated application.xml by specifying the includeInApplicationXml flag.
It is also possible to specify a default bundle directory for all third party libraries by specifying the defaultLibBundleDir parameter.
The security settings might be specified under the security parameter.
The artifact's types that should be unpacked by default can be specified using the unpackTypes parameter.
The file name mapping to use for artifacts stored in the EAR can be specified using the fileNameMapping parameter. Valid values for this parameter are standard (default), full and no-version. By specifying full as file name mapping, artifacts are prefixed by the groupId where dots have been replaced by dashes. no-version can be used as a replacement of the default mapping; the only difference is that the version is omitted.
For more information on EAR modules, please see the modules configuration page.
You can take a look at the examples for more information on these advanced configurations.
The EAR Plugin can generate the jboss-app.xml automatically. To do so, the <jboss> element must be configured and takes the following child elements:
The POM snippet below fully configures the following loader repository
<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 archives (HAR) and Service archives (SAR) will be recognized automatically and added the the jboss-app.xml file.
You can take a look at the examples for more information on the JBoss support.