Packaging: Sample "A"
iPlanet^TM Application Server Samples

If you already deployed the packaging sample A, you can run the application by clicking here.

This samples illustrates simple packaging: a single EAR file (pkgingA.ear) contains one EJB JAR file (pkgingAEJB.jar) and one WAR file (pkgingAWAR.war)

The file view and the component view of the pkgingAWAR.war file as shown in the Deployment Tool illustrate that the library class (DateLibrary.class) accessed by the servlets is included under WEB-INF/. The placement of the library class is according to the J2EE specification.

The file view and the component view of the pkgingAEJB.jar file illustrate that helper classes (i.e. Calculator.class) accessed by the beans need to be included in the package. Although both beans (CompoundInterest and SimpleInterest) use the same library class, the class needs to be included only once in the EJB JAR file. In addition, the naming convention used for EJB names illustrates a concept for naming EJBs so as to avoid conflict across modules and applications.

The component view of the final application (pkgingA.ear) shows the contents - pkgingAWAR.war and pkgingAEJB.jar. The file view is shown  here.

The following concepts are illustrated in this sample:

• Cross EJB invocation: Both EJBs make calls to each other.
   
• WAR to EJB JAR communication: servlets make calls to the EJBs.
   
• Naming scheme for EJBs: The EJBs are named in the format:
      <companyname>.<earname>.<modulename>.<EJBName>

For example, the SimpleInterest EJB is named "iplanet.pkgingA.pkgingAEJB.SimpleInterest". This naming scheme allows for unique naming of EJBs across all applications.

The rest of the document contains the following sections:

Assembling the application

Deploying the application

Running the application
 

Assembling the Application

• Go to install_dir/ias/ias-samples/pkging/pkgingA/src. Execute the command 'build'. This command executes the default target that compiles the Java sources, creates the EJB stubs and skeletons and packages the WAR, EJB JAR and the final EAR file. The prebuilt and ready-to-use EAR file under the sample directory can also be used for deployment.
• The resulting EAR file can be found at:

  install_dir/ias/ias-samples/pkging/pkgingA/assemble/ear/pkgingA.ear

Deploying the Application

Navigate to the directory containing the application's EAR file and run the iasdeploy command:

iasdeploy deployapp pkgingA.ear

This command deploys the application to the local machine.

Running the Application

Run the application by accessing the following link:

http://<hostname>:<port>/NASApp/pkgingA/index.html

Choose either "Simple Interest" or "Compound Interest". Enter the values on the input form and press "Submit".

Copyright (c) 2001 Sun Microsystems, Inc. All rights reserved.