Using the EJB Wizard to Create an Entity EJB

Using the EJB Property Sheets

Once you have created your EJB module (and any libraries, help files or other documentation that may be referenced by the module), you can edit any specfic descriptors in the bean Property sheets. The information that you specify in the Property sheets will appear in the deployment XML files for EJBs and associated EJB modules as <ejbname>.ejbias and <ejbmodulename>.ejbmodule. file.

The Document Type Definition (DTD) specifition defines the XML grammar for the Property sheets. The Property Sheet DTDs were installed during your installation of the iPlanet Application Server at <iAS install directory>ias/APPS. Examine these DTD specifications or consult the latest J2EE specifications at http://java.sun.com/j2ee/docs.html for more complete information about each field in the property sheet tabs.

The EJB Property sheets consist of the following tabs:

Properties - Specifies overall attributes for the EJB.
References - Specifies the declaration of a reference to another enterprise bean or other resources.
iPlanet AS - Specifies iPlanet Application Server specific attributes for the EJB.

Properties

You use the Property tab to specify general attributes for the EJB JAR file. The EJB module property tab also contains these general attributes for the JAR file. If you wish to set the security roles at the EJB module level, see the Advanced Features page.

Field/Column

Explanation

Application Servers

Select the iPlanet Application Server checkbox to identify the server on which the EJB will be deployed.

Bean Class

Navigate to the desired Bean Class.

Bean Type

Enter whether the bean is a stateless session or entity bean.

Description

Enter a description of the EJB.

Home Interface

Navigate to the desired Home Interface class.

Large Icon

Enter the location within the EJB application of a file (.GIF, .JPEG) that contains a large (32X32 pixel) icon image used to represent the application.

Name

Enter the fully qualified enterprise bean name that matches the enterprise bean in the ejb-jar file's deployment descriptor.

Remote Interface

Navigate to the desired Remote Interface class.

Small Icon

Enter the location within the EJB application of a file (.GIF, .JPEG) that contains a small (16X16 pixel) icon image used to represent the application.

Transaction Type

Select whether your EJB is a Container bean or a session bean.

References

Use the References tab to declare a reference to another enterprise bean.

Field/Column

Explanation

EJB References

Add the declaration of a reference to another enterprise bean's home prefixed with "ejb/". Include a description of the reference bean; the expected type of the referenced enterprise bean (entity or session); and the expected home and remote interfaces.

Environment Entry

Add an environment entry name; the type field must be the fully-qualified Java type of the environment entry value expected by the EJB code; the value field contains the value of an EJB environment entry.

Resource Factory References

Add a name and description for the reference to an external resource; the indication of the resource manager connection factory type expected by the EJB code ; and the type authorization (application or container).

Security Role References

Add a name and description that declares the security role reference in the EJB code; and the link to a defined security role.

iPlanet AS

Fields with an * (asterich) are automatically generated at deploy time. Do not change the values of these * fields.

Field/Column

Explanation

Allow IIOP Client Access

Set to True to allow client access; false (default) disables access.

CMP Deployment Descriptor File *

Identify the CMP descriptor filename as declared in the J2EE XML file for the CMP.

DB Table Name

Identify the name of the database table as declared in the J2EE XML file.

EJB Reference Mappings

Identify the absolute JNDI name that the EJB references in the corresponding J2EE XML file.

Global Unique Identifier

The unique identifier for the iPlanet server as set in the Global options settings.

Is Failover Required

Indicate if the bean is rich client enabled by selecting True. The default value is False.

Map DB to EJB Fields

Maps the columns in your database table to corresponding EJB field names.

Pass By Value

Set to True or False.

Passivation Timeout

Enter the passivation timeout in seconds used by the container.

Persistence Manager Class

Identify the persistence manager factory class.

Pool Manager Settings

Select from Commit Option C (default) and Commit Option B to apply to the ready cache. Also identify the ready pool timeout, in seconds, used by the container (default is 0). The maxsize of the ready cache as an integer (default is 0). The Free pool maxsize is a storage place for the absolute JNDI name.

Resource Reference Mappings

Identify the absolute JNDI name that the resource references in the corresponding J2EE XML file.

Session Timeout Value

Thread-Safe

Set to either True or False.

See also
	Creating an EJB About Entity Beans About Session Beans

Legal Notices

Field/Column	Explanation
Application Servers	Select the iPlanet Application Server checkbox to identify the server on which the EJB will be deployed.
Bean Class	Navigate to the desired Bean Class.
Bean Type	Enter whether the bean is a stateless session or entity bean.
Description	Enter a description of the EJB.
Home Interface	Navigate to the desired Home Interface class.
Large Icon	Enter the location within the EJB application of a file (.GIF, .JPEG) that contains a large (32X32 pixel) icon image used to represent the application.
Name	Enter the fully qualified enterprise bean name that matches the enterprise bean in the ejb-jar file's deployment descriptor.
Remote Interface	Navigate to the desired Remote Interface class.
Small Icon	Enter the location within the EJB application of a file (.GIF, .JPEG) that contains a small (16X16 pixel) icon image used to represent the application.
Transaction Type	Select whether your EJB is a Container bean or a session bean.

Field/Column	Explanation
EJB References	Add the declaration of a reference to another enterprise bean's home prefixed with "ejb/". Include a description of the reference bean; the expected type of the referenced enterprise bean (entity or session); and the expected home and remote interfaces.
Environment Entry	Add an environment entry name; the type field must be the fully-qualified Java type of the environment entry value expected by the EJB code; the value field contains the value of an EJB environment entry.
Resource Factory References	Add a name and description for the reference to an external resource; the indication of the resource manager connection factory type expected by the EJB code ; and the type authorization (application or container).
Security Role References	Add a name and description that declares the security role reference in the EJB code; and the link to a defined security role.

Field/Column	Explanation
Allow IIOP Client Access	Set to True to allow client access; false (default) disables access.
CMP Deployment Descriptor File *	Identify the CMP descriptor filename as declared in the J2EE XML file for the CMP.
DB Table Name	Identify the name of the database table as declared in the J2EE XML file.
EJB Reference Mappings	Identify the absolute JNDI name that the EJB references in the corresponding J2EE XML file.
Global Unique Identifier	The unique identifier for the iPlanet server as set in the Global options settings.
Is Failover Required	Indicate if the bean is rich client enabled by selecting True. The default value is False.
Map DB to EJB Fields	Maps the columns in your database table to corresponding EJB field names.
Pass By Value	Set to True or False.
Passivation Timeout	Enter the passivation timeout in seconds used by the container.
Persistence Manager Class	Identify the persistence manager factory class.
Pool Manager Settings	Select from Commit Option C (default) and Commit Option B to apply to the ready cache. Also identify the ready pool timeout, in seconds, used by the container (default is 0). The maxsize of the ready cache as an integer (default is 0). The Free pool maxsize is a storage place for the absolute JNDI name.
Resource Reference Mappings	Identify the absolute JNDI name that the resource references in the corresponding J2EE XML file.
Session Timeout Value
Thread-Safe	Set to either True or False.