maven-plugins/ejb/xdocs/index.xml
2005-10-01 07:06:46 +00:00

86 lines
3.1 KiB
XML

<?xml version="1.0"?>
<!--
/*
* Copyright 2001-2005 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
-->
<document>
<properties>
<title>Maven EJB Plug-in</title>
<author email="nathan.coast@blueyonder.co.uk">Nathan Coast</author>
<author email="vmassol@apache.org">Vincent Massol</author>
</properties>
<body>
<section name="Maven EJB Plug-in">
<p>
This plug-in provides your basic EJB JAR facilities.
</p>
<p>
For more information on the functionality provided by this plugin,
please see the <a href="goals.html">Goals</a> document.
</p>
<p>
For more information on how to customise the functionality provided
by this plugin, please see the <a href="properties.html">properties</a>
document.
</p>
</section>
<section name="Version 1.7.1+ release notes">
<ul>
<li>
Version 1.7.1 and greater of the EJB plugin require Maven 1.1 beta 2
or above. The reason is that we have introduced a new
<code>ejb-client</code> dependency type and that required modifying
Maven's core.
</li>
<li>
The EJB client is now generated by the main <code>ejb:ejb</code> goal
at the same time it generates the main EJB JAR. The generation is
controlled by the <code>maven.ejb.client.generate</code> property
(see the <a href="properties.html">properties</a> page for more
details) which defaults to false.
</li>
<li>
EJB client JARs are deployed in the Maven repository in the
<code>ejbs/</code> directory alongside the main EJB JARs.
</li>
<li>
In order to reference an EJB client JAR from another project you'll need
to specify an <code>ejb-client</code> type. Here's an example:
<source><![CDATA[
<dependency>
<groupId>groupId</groupId>
<artifactId>ejbClientJarArtifactId</artifactId>
<version>aversion</version>
<type>ejb-client</type>
</dependency>
]]></source>
</li>
<li>
The following goals have been deprecated:
<code>ejb:ejb-client</code>, <code>ejb:install-client</code> and
<code>ejb:deploy-client</code>. To generate, install and deploy the
EJB client JAR use the <code>ejb:ejb</code>, <code>ejb:install</code>
and <code>ejb:deploy</code> goals respectively and set the
<code>maven.ejb.client.generate</code> to true.
</li>
</ul>
</section>
</body>
</document>