Guidelines: J2EE Application
Topics
Introduction
An J2EE Application is the largest independent unit of deployment in a J2EE application. For general information on J2EE Applications, see Concepts: J2EE Overview.
For information on assembling J2EE Applications, see Guidelines: Assembling J2EE Applications.
For information on deploying J2EE Applications, see Guidelines: Deploying J2EE Modules and Applications.
Modeling J2EE Applications
J2EE Applications are represented in the Implementation Model as UML artifacts with a <<EAR>> stereotype.
The composition of J2EE Module archives into a J2EE Application archive can be shown graphically by drawing an <<EJBModule>> dependency from contained EJB-JARs to the EAR, and by drawing a <<WebModule>> dependency from the contained WARs to the EAR.
The mapping of a J2EE Application to a specific node (i.e., application server) can be shown graphically be drawing a <<deploy>> dependency from the EAR to the application server node, as shown in the following diagram.
In addition to modeling what module archives are packaged in the application archive, you can also model properties, which are ultimately documented in the module and application archives' deployment descriptors.
An example of how to model some of these properties is provided below.
The above diagram shows the assembly of an EJB and a Web archive into an EAR. Notice the modeling of the the security roles, which are used by the application to determine which types of users can access parts of the system, down to the method level of granularity.
J2EE Application Deployment Descriptors
A J2EE Application contains a J2EE application deployment descriptor with a file name of "application.xml". The application deployment descriptor must be placed in the META-INF/ subdirectory.
The application deployment descriptor lists the modules that are packaged in the application, as well as instructions for customizing the application.
The contents of the application deployment descriptor are set when the J2EE Application is assembled. For more information on assembling J2EE Applications, see Guidelines: Assembling J2EE Applications.
For general information on deployment descriptors, see Concepts: Java 2 Platform Enterprise Edition (J2EE) Overview.
