80e3738620
git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@113145 13f79535-47bb-0310-9956-ffa450edef68
285 lines
12 KiB
XML
285 lines
12 KiB
XML
<?xml version="1.0"?>
|
|
<document>
|
|
|
|
<properties>
|
|
<author email="dion@multitask.com.au">dIon Gillard</author>
|
|
<author email="kevino@jacus.com.au">Kevin O'Neill</author>
|
|
<author email="plynch@apache.org">Peter Lynch</author>
|
|
<title>Maven J2EE Plug-in Properties Documentation</title>
|
|
</properties>
|
|
|
|
<body>
|
|
<section name="Maven J2EE Plug-in Properties">
|
|
<p>
|
|
The following is an overview of the various properties (and
|
|
default values) used by the Maven J2EE Plug-in <a
|
|
href="goals.html">goals</a>. These properties
|
|
control various aspects of the J2EE build. Most of these
|
|
properties are optional and have defaults; however, there are
|
|
mandatory properties that must be set as described in this document.
|
|
</p>
|
|
<p>
|
|
These properties can be overridden to change the default behavior of
|
|
the Maven J2EE Plug-in. If you need to override any of these properties,
|
|
please refer to the
|
|
<a href="http://maven.apache.org/start/integrate.html">Integration</a>
|
|
document for the preferred method of setting properties in your project.
|
|
</p>
|
|
<table>
|
|
<tr><th>Section</th><th>Description</th></tr>
|
|
<tr>
|
|
<td><a href="#War Settings">War</a></td>
|
|
<td>
|
|
These properties specify various settings that control the build
|
|
of a war file by the J2EE Plug-in.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="#EJB Settings">EJB</a></td>
|
|
<td>
|
|
These properties specify various settings that control the build
|
|
of a ejb jar by the J2EE Plug-in.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="#Ear Settings">Ear</a></td>
|
|
<td>
|
|
These properties specify various settings that control the build
|
|
of an ear file by the J2EE Plug-in.
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</section>
|
|
|
|
|
|
<section name="War Settings">
|
|
<table>
|
|
<tr><th>Property</th><th>Optional?</th><th>Description</th></tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.war.name">maven.j2ee.war.name</a></td>
|
|
<td>No</td>
|
|
<td>
|
|
Specifies the name of the web application to be built.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.war.src">maven.j2ee.war.src</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the directory in the local file system that is
|
|
used as the base directory for finding web applications. It defaults
|
|
to <code><a href="../properties.html#Directory Layout Settings">${maven.src.dir}</a>/webapps</code>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.war.content">maven.j2ee.war.content</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the directory in the local file system that holds
|
|
web content to be placed in the war file. It defaults
|
|
to ${maven.j2ee.war.src}/${maven.j2ee.war.name}
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.war.classes.includes">maven.j2ee.war.classes.includes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the pattern of files in the directory specified by
|
|
<code><a href="../properties.html#Directory Layout Settings">${maven.build.dest}</a></code>
|
|
to be included in the <code>/WEB-INF/classes</code> of the resulting
|
|
war file. It defaults to <code>**</code>, that is, all files.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.war.classes.excludes">maven.j2ee.war.classes.excludes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the pattern of files in the directory specified by
|
|
<code><a href="../properties.html#Directory Layout Settings">${maven.build.dest}</a></code>
|
|
that are <strong>not</strong> to be included in the
|
|
<code>/WEB-INF/classes</code> of the resulting war file.
|
|
It defaults to <code>**/package.html</code>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.war.lib.includes">maven.j2ee.war.lib.includes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
<p>WARNING: This property is temporarily unused.</p>
|
|
Specifies the pattern of files in the
|
|
<a href="../project-descriptor.html#dependencies">project dependencies</a>
|
|
to be included in the <code>/WEB-INF/lib</code> of the resulting
|
|
war file. It defaults to <code>*.jar</code>, that is, all dependencies.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.war.lib.excludes">maven.j2ee.war.lib.excludes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
<p>WARNING: This property is temporarily unused.</p>
|
|
Specifies the pattern of files in the
|
|
<a href="http://maven.apache.org/reference/project-descriptor.html#dependencies">project dependencies</a>
|
|
not to be included in the <code>/WEB-INF/lib</code> of the resulting
|
|
war file. It defaults to blank, that is, no dependencies are excluded.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.war.webxml">maven.j2ee.war.webxml</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the deployment descriptor to be used when building the war
|
|
file. It will be placed in <code>/WEB-INF/web.xml</code> of the resulting
|
|
war file. It defaults to <code><a href="../properties.html#Directory Layout Settings">${maven.conf.dir}</a>/${maven.j2ee.war.name}-web.xml</code>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</section>
|
|
|
|
<section name="EJB Settings">
|
|
<table>
|
|
<tr><th>Property</th><th>Optional?</th><th>Description</th></tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ejb.name">maven.j2ee.ejb.name</a></td>
|
|
<td>No</td>
|
|
<td>
|
|
Specifies the name of the ejb jar to be built.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ejb.conf.dir">maven.j2ee.ejb.conf.dir</a></td>
|
|
<td>No</td>
|
|
<td>
|
|
Specifies the directory to be used to find the deployment descriptor
|
|
and other files to be placed in <code>META-INF</code> directory of
|
|
the resulting ejb jar. It defaults to
|
|
<code><a href="../properties.html#Directory Layout Settings">${maven.conf.dir}</a>/<a href="properties.html#maven.j2ee.ejb.name">${maven.j2ee.ejb.name}</a></code>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<a name="maven.j2ee.ejb.conf.includes">maven.j2ee.ejb.conf.includes
|
|
</a>
|
|
</td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the a pattern of files to be included in the
|
|
<code>META-INF</code> directory of the resulting ejb jar, relative
|
|
to the <code>${maven.j2ee.ejb.conf.dir}</code>. It defaults to
|
|
<code>ejb-jar.xml</code>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<a name="maven.j2ee.ejb.conf.excludes">maven.j2ee.ejb.conf.excludes
|
|
</a>
|
|
</td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the a pattern of files to be excluded from the
|
|
<code>META-INF</code> directory of the resulting ejb jar, relative
|
|
to the <code>${maven.j2ee.ejb.conf.dir}</code>. It defaults to
|
|
blank.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ejb.includes">maven.j2ee.ejb.includes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the pattern of files in the
|
|
<a href="../properties.html#Directory Layout Settings">${maven.build.dest}</a>
|
|
directory to be included in the generated ejb jar. Defaults to <code>**/*</code>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ejb.excludes">maven.j2ee.ejb.excludes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the pattern of compiled class files to be <strong>excluded</strong>
|
|
from the generated ejb jar. Defaults to <code>**/package.html</code>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ejb.local.includes">maven.j2ee.ejb.local.includes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
If this property exists then a jar file with the name
|
|
<code><a href="properties.html#maven.j2ee.ejb.name">${maven.j2ee.ejb.name}</a>-local.jar</code>
|
|
containing the matching files will be generated in
|
|
<code><a href="../properties.html#Directory Layout Settings">${maven.build.dir}</a>/ejb</code>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ejb.local.excludes">maven.j2ee.ejb.local.excludes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Files to be <strong>excluded</strong> from the
|
|
<code><a href="properties.html#maven.j2ee.ejb.name">${maven.j2ee.ejb.name}</a>-local.jar</code>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ejb.remote.includes">maven.j2ee.ejb.remote.includes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
If this property exists then a jar file with the name
|
|
<code><a href="properties.html#maven.j2ee.ejb.name">${maven.j2ee.ejb.name}</a>-remote.jar</code>
|
|
containing the matching files will be generated in
|
|
<code><a href="../properties.html#Directory Layout Settings">${maven.build.dir}</a>/ejb</code>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ejb.remote.excludes">maven.j2ee.ejb.remote.excludes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Files to be <strong>excluded</strong> from the
|
|
<code><a href="properties.html#maven.j2ee.ejb.name">${maven.j2ee.ejb.name}</a>-remote.jar</code>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</section>
|
|
|
|
|
|
<section name="Ear Settings">
|
|
<table>
|
|
<tr><th>Property</th><th>Optional?</th><th>Description</th></tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ear.name">maven.j2ee.ear.name</a></td>
|
|
<td>No</td>
|
|
<td>
|
|
Specifies the name of the enterprise application to be built.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ear.includes">maven.j2ee.ear.includes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the pattern of files in the
|
|
<code><a href="../properties.html#Directory Layout Settings">${maven.build.dir}</a></code>
|
|
directory to be included in the resulting ear file. It defaults to
|
|
<code>*.jar, *.war</code>, that is, all jar and war files.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ear.excludes">maven.j2ee.ear.excludes</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the pattern of files in the
|
|
<code><a href="../properties.html#Directory Layout Settings">${maven.build.dir}</a></code>
|
|
directory that are not to be included in the resulting ear file.
|
|
It defaults to blank, that is, nothing is excluded.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a name="maven.j2ee.ear.appxml">maven.j2ee.ear.appxml</a></td>
|
|
<td>Yes</td>
|
|
<td>
|
|
Specifies the deployment descriptor to be used when building the ear
|
|
file. It will be placed in <code>/application.xml</code> of the resulting
|
|
ear file. It defaults to <code><a href="../properties.html#Directory Layout Settings">${maven.conf.dir}</a>/${maven.j2ee.ear.name}-application.xml</code>
|
|
</td>
|
|
</tr>
|
|
|
|
</table>
|
|
</section>
|
|
</body>
|
|
</document>
|