For Java EE 7, the Java EE documentation team intends to migrate our examples to Maven, away from the Ant-based Java BluePrints and native NetBeans build files we've used since J2EE 1.4. One of the main advantages to using Maven is that our examples will be able to be run in any Maven-aware IDE as well as using the command line mvn tool.
This document describes the Maven artifacts we intend to publish to the java.net Maven repository.
|GroupId||org.glassfish.javaeetutorial||All artifacts will be organized under this GroupId.|
|ArtifactId||artifact name||The name of the artifact. For example, the artifact name for the hello1 example application is "hello1".|
|Version||Java EE version-major release-minor release-status||All artifacts for Java EE 7 should begin with with 7.0. The major and minor releases are independent of the Java EE version, and are specific to the artifact. Start both the major and minor release at 0. The status is one of SNAPSHOT (development) or STAGING (pre-release). Final releases omit the status. For example, the hello1 example will start off with a version number of 7.0.0-SNAPSHOT while it is being developed, 7.0.0-STAGING before the first release, and 7.0.0 for the first release.|
|Type||packaging format of final artifact||One of jar, zip, war, or ear.|
The Tutorial examples are divided into categories by technology area. The Group ID and base package name for each technology area is defined in the following table.
|Technology area||Group ID||Package name|
|Java EE Connectors||org.glassfish.javaeetutorial.connectors||javaeetutorial.connectors|
|Java Persistence API||org.glassfish.javaeetutorial.persistence||javaeetutorial.persistence|
To simplify development and provide a standardized look-and-feel for our example applications, we'll provide archetypes for the different kinds of example applications described in the Tutorial.
The web application archetype will provide the basic structure of a Java EE 7 web application. This archetype uses the javaeetutorial-common-web artifact ID.
The case study archetype will provide the basic structure of a case study example application. This archetype uses the javaeetutorial-common-casestudies artifact ID.