| ------ |
| Usage |
| ------ |
| Stephane Nicoll |
| <snicoll@apache.org> |
| Pete Marvin King |
| ------ |
| 2008-07-07 |
| ------ |
| |
| ~~ Licensed to the Apache Software Foundation (ASF) under one |
| ~~ or more contributor license agreements. See the NOTICE file |
| ~~ distributed with this work for additional information |
| ~~ regarding copyright ownership. The ASF licenses this file |
| ~~ to you 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. |
| |
| ~~ NOTE: For help with the syntax of this file, see: |
| ~~ http://maven.apache.org/doxia/references/apt-format.html |
| |
| |
| Usage |
| |
| The EJB Plugin is used to package an EJB module. There are two ways to use the EJB Plugin: |
| |
| * If the packaging type defined in the <<<pom.xml>>> is <<<ejb>>>, the <<<package>>> lifecycle phase can be used |
| |
| +--------------+ |
| mvn package |
| +--------------+ |
| |
| * or using the <<<ejb:ejb>>> goal |
| |
| +--------------+ |
| mvn ejb:ejb |
| +--------------+ |
| |
| [] |
| |
| The plugin doesn't do any EJB specific processing during the generation of the jar except for validating the existence |
| of an EJB deployment descriptor if the EJB version is 2.0+, but it provides the following customization: |
| |
| * The EJB version to use |
| |
| * {{{examples/generating-ejb-client.html}Generating and customizing an ejb-client}} |
| |
| <<Note:>> The dependencies will not be package with the EJB jar. |
| |
| * Specifying the EJB version to use |
| |
| In EJB3, the <<<ejb-jar.xml>>> deployment descriptor is not mandatory anymore. By default |
| the plugin assumes version 2.1. To use another version, configure the plugin as follows: |
| |
| +-------- |
| <build> |
| <plugins> |
| <plugin> |
| <groupId>org.apache.maven.plugins</groupId> |
| <artifactId>maven-ejb-plugin</artifactId> |
| <version>${project.version}</version> |
| <configuration> |
| <ejbVersion>3.0</ejbVersion> |
| </configuration> |
| </plugin> |
| </plugins> |
| </build> |
| +--------- |