Sun Java System Application Server

The Custom JNDI Resource Factory Sample Application

This sample application demonstrates:

How to create and deploy an application that uses a custom JNDI resource factory
How to use JNDI custom factories in a Java Enterprise Edition (J2EE) 1.4 platform-compliant application components.

The JNDI custom factory described here creates samples.jndi.custom.share.CustomBean beans. This sample application also provides an application client component that illustrates how to use the custom factory to obtain a CustomBean.

Relative to install_dir/samples/jndi/apps/custom/, the directory structure of this sample application is:

custom-client/src/conf - Contains the application client deployment descriptors required for deployment on the application server
custom-client/src/java/samples/jndi/custom/client - Contains the source code for the application client
custom-share/src/java/samples/jndi/custom/share - Contains the source code for the custom bean (CustomBean) object and the class implementing the Custom JNDI Resource Factory (MyJndiCustomFactory)

Building, Deploying, and Running the Application

The general instructions for building, deploying, and running sample applications are provided in Building, Deploying, and Running Sample Applications. In reading this document, use the following application-specific variables for this application:

install_dir is the directory where Application Server is installed.
app_dir is the application base directory: install_dir/samples/jndi/apps/custom.
appname is the application name: jndi-custom.
The prebuilt EAR file is jndi-custom.ear.

Follow this general procedure:

Build the Application. The build file, build.xml, is in the app_dir directory, specifically, install_dir/samples/jndi/apps/custom.
Deploy the Application. The EAR file is install_dir/samples/jndi/apps/custom/jndi-custom.ear.
Note: When you deploy this application, an application server custom resource associated with the Custom JNDI Resource Factory is also created. This custom resource will be looked up by the application components when they need to obtain objects created by the custom JNDI Factory (CustomBean objects). See the create-custom-resource target in the main build.xml file for more details.
Run the application as described below.

Running the Application

To run the application, execute the following commands:

cd  install_dir/samples/jndi/apps/custom
asant run

This command invokes the application client for this sample application. The application client looks up the JNDI name of the resource associated with the custom JNDI resource factory (created during deployment) and displays the values of the bean properties.