The iPlanet Application Server Customizer

References (WAR)

You use the References tab to identify any of the following references in the source code of any of the web application components:

References to resource factories A resource factory is a provider of resources, such as a JDBC or a JMS driver. Resource factories are used within an EJB to acquire resources such as database connections.
References to other EJBs

When entering text in the EJB references fields, be sure to use the tab key or enter key after typing text, otherwise your entries will be lost.

Field/Column

Explanation

The following defines references to resource factories.

Resource Name

Enter the name of the resource in this column that a web application component references, for example, a database.

Description

Enter a description of the resource, for example, a JDBC connection to a database.

Resource Class

Click in the Resource Class column and choose a data source from the list box.
A resource class is a Java interface that specifies the type of data source, for example, javax.sql.DataSource.

Authorization

Choose the authorization type as follows: Application or Container.
Application specifies that the enterprise bean code signs on programmatically to the resource manager.
Container specifies that it will sign on to the resource manager on behalf of the enterprise bean.

JNDI Name

Enter the Java Naming and Directory Interface (JNDI) name by which the resource factory is known. The JNDI name will be the name of the module and the reference name of the resource factory.

The following defines references to EJBs.

Reference

Enter the name of the EJB that is referenced in the source code of a component of the web application and should match the string used for EJB lookup.

Bean Type

Click in the Bean Type column and choose the Bean Type:Session or Entity.

Linked to Bean

Optionally, enter the Java Naming and Directory Interface (JNDI) by which the EJB is known. The JNDI name will be the name of the module and the reference name of the EJB (My EjbJar1/MyEjb1). The reference name is specified on General tab of an EJB.
In most cases the actual bean that is referred to is not decided until the module is assembled into an application, at which point you will enter the JNDI name for the bean.

Bean Home Interface

Enter the Bean Home Interface for this EJB.

Bean Remote Interface

Enter the Bean Remote Interface for this EJB.

Add button

Click to add a row to the table for you to define a reference.

Remove button

Click to remove the selected row from the table.

See also
	Using the Deployment Descriptors for Servlets/JSPs

Legal Notices

Field/Column	Explanation
The following defines references to resource factories.
Resource Name	Enter the name of the resource in this column that a web application component references, for example, a database.
Description	Enter a description of the resource, for example, a JDBC connection to a database.
Resource Class	Click in the Resource Class column and choose a data source from the list box. A resource class is a Java interface that specifies the type of data source, for example, javax.sql.DataSource.
Authorization	Choose the authorization type as follows: Application or Container. Application specifies that the enterprise bean code signs on programmatically to the resource manager. Container specifies that it will sign on to the resource manager on behalf of the enterprise bean.
JNDI Name	Enter the Java Naming and Directory Interface (JNDI) name by which the resource factory is known. The JNDI name will be the name of the module and the reference name of the resource factory.
The following defines references to EJBs.
Reference	Enter the name of the EJB that is referenced in the source code of a component of the web application and should match the string used for EJB lookup.
Bean Type	Click in the Bean Type column and choose the Bean Type:Session or Entity.
Linked to Bean	Optionally, enter the Java Naming and Directory Interface (JNDI) by which the EJB is known. The JNDI name will be the name of the module and the reference name of the EJB (My EjbJar1/MyEjb1). The reference name is specified on General tab of an EJB. In most cases the actual bean that is referred to is not decided until the module is assembled into an application, at which point you will enter the JNDI name for the bean.
Bean Home Interface	Enter the Bean Home Interface for this EJB.
Bean Remote Interface	Enter the Bean Remote Interface for this EJB.
Add button	Click to add a row to the table for you to define a reference.
Remove button	Click to remove the selected row from the table.