JNDI Custom Resource Sample Application


This document describes how to use the Java Naming and Directory Interface (JNDI) custom resource sample application with Sun Java System Web Server.

This document contains the following sections:

• Overview

• Compiling and Assembling the Application

• Deploying the Sample Application

• Running the Sample Application

• Undeploying the Sample Application

Overview

---

The JNDI custom resource sample demonstrates the use of this custom resource.  

Compiling and Assembling the Application

---

To compile and assemble the sample application, complete the following steps:

1. Compile and assemble the WAR file by changing to the source directory at install_root/samples/java/webapps/jndi/custom/src and running the ant command.
   
   The default target default is executed to build the WAR file.

   Note - Make sure that the necessary parameters for running the samples are specified in install_root/samples/java/webapps/common.properties.
   
   
2. Execute the following command:
   
   # ant create_custom
   
   To run this command successfully, Administration Server must be running, and necessary parameters such as config.name, vs.name,
   passwordfile.path etc. in install_root/samples/java/webapps/common.properties file must be specified correctly. (See 1. above)
   
   
3. Deploy the application.

   After you have re-created the sample application from scratch, you can proceed to Deploying the Sample Application.
    

4. (Optional.) Clean the web application project area.
   
   

   # ant clean

   
   This removes the assemble and build directories for the sample application. The WAR file is now ready for deployment.

  Deploying the Sample Application

---

To deploy the sample application, complete the following steps:

1. Change to the source directory at install_root/samples/java/webapps/jndi/custom/src.
   
    
2. Run the ant tool using the deploy task.
   
   

# ant deploy

If you want to verify the registration of the application, proceed to Verifying Deployment. Otherwise, proceed to Running the Sample Application.
 

Verifying Deployment

To verify the registration and deployment of the application, complete the following steps:

1. Change to the source directory at install_root/samples/java/webapps/jndi/custom/src.
   

2. Run the ant tool using the list_apps task.
   
   # ant list_apps
   
   The jndi-customresource module is listed as one of the components
   

Running the Sample Application

---


You can run the application through the following URL:

http://Sun_Java_System_Web_Server_hostname:port/jndi-customresource/customresource.jsp

"Hello" displays.

Undeploying the Sample Application

---

After successfully deploying and running the application, you might decide to undeploy it and remove the files. To undeploy the application, complete the following steps:

1. Change to the source directory at install_root/samples/java/webapps/jndi/custom/src.

2. Run the ant tool using the undeploy task.

   # ant undeploy



3. Run the ant tool using the delete_resource task.
   
   # ant delete_resource
   
    This removes the deployed resource.
   
   

---

Copyright © 2007 Sun Microsystems, Inc. All rights reserved.