Session bean assembly properties
A session bean encapsulates transient data that is associated with a particular EJB client. Unlike data in an entity bean, the data in a session bean is not stored in a persistent data source.
- EJB name
- Specifies a logical name for the enterprise bean. This name must be unique within the EJB module. There is no relationship between this name and the JNDI name.
- Display name
- Specifies a short name that is intended to be displayed by GUIs.
- Description
- Contains text that describes the session bean.
- EJB class
- Specifies the full name of the enterprise bean class (for example, com.ibm.ejs.doc.account.AccountBean).
- Remote - Home
- Specifies the full name of the enterprise bean's home interface class (for example, com.ibm.ejs.doc.account.AccountHome).
- Remote - Interface
- Specifies the full name of the enterprise bean's remote interface class (for example, com.ibm.ejs.doc.account.Account).
- Local interface - Home
- Specifies the full name of the enterprise bean's home interface class (for example, com.ibm.ejs.doc.account.AccountLocalHome).
- Local interface - Interface
- Specifies the full name of the enterprise bean's local interface class (for example, com.ibm.ejs.doc.account.AccountLocal).
- Session type
- Specifies whether the enterprise bean maintains a conversational state (is stateful) or does not (is stateless).
Data type String Range Valid values are Stateful and Stateless - Transaction type
- Specifies whether the enterprise bean manages its own transactions or whether the container manages transactions on behalf of the bean.
Data type String Range Valid values are Container or Bean - Small icon
- Specifies the name of a JPEG or GIF file that contains a small image (16x16 pixels). The image is used as an icon to represent the session bean in a GUI.
- Large icon
- Specifies the name of a JPEG or GIF file that contains a large image (32x32 pixels). The image is used as an icon to represent the session bean in a GUI.
- Security identity
- Specifies whether a principal's credential properties are to be handled as indicated in the Run-As mode property. If this setting is enabled (that is, set to true), the Run-As mode setting can be edited.
- Description
- Contains further information about the security instructions.
- Run-As mode
- Specifies the credential information to be used by the security service to determine the permissions that a principal has on various resources.
At appropriate points, the security service determines whether the principal is authorized to use a particular resource based on the principal's permissions. If the method call is authorized, the security service acts on the principal's credential properties according to the Run-As mode setting of the enterprise bean.
Data type Enumerated integer Range Valid values are Use identity of caller and Use identity assigned to specified role Additional information about valid values for this setting follows:
- Use identity of caller
- The security service makes no changes to the principal's credential properties.
- Use identity assigned to specified role
- A principal that has been assigned to the specified security role is used for the execution of the bean's methods. This association is part of the application binding in which the role is associated with a user ID and password of a user who is granted that role.
- Role name
- Specifies the name of a security role. If Run-As mode is set to Use identity assigned to specified role, a principal that has been granted this role is used.
- Description
- Contains further information about the security role.
- Timeout
- This property does not apply to session beans.
This property is an IBM extension to the standard J2EE deployment descriptor.
Data type Integer Units Seconds - Inheritance root
- Specifies whether the enterprise bean is at the root of an inheritance hierarchy.
This property is an IBM extension to the standard J2EE deployment descriptor.
- Bean Cache - Activate at
- Specifies the point at which an enterprise bean is activated and placed in the cache. Removal from the cache and passivation is also governed by this setting. This setting applies to stateful session beans only (not to stateless beans).
This property is an IBM extension to the standard J2EE deployment descriptor.
Data type String Default Once Range Valid values are Once and Transaction Additional information about valid values follows:
- Once
- Indicates that the bean is activated when it is first accessed in the server process, and passivated (and removed from the cache) at the discretion of the container, for example, when the cache becomes full.
- Transaction
- Indicates that the bean is activated at the start of a transaction and passivated (and removed from the cache) at the end of the transaction.
- Local Transactions - Unresolved action
- Specifies the action the container must take if resources are uncommitted by an application in a local transaction. A local transaction context is created when a method runs in what the EJB specification refers to as an unspecified transaction context.
This property is an IBM extension to the standard J2EE deployment descriptor.
Data type String Default Rollback Range Valid values are Commit and Rollback - Local Transactions - Boundary
- This property does not apply to session beans.
This property is an IBM extension to the standard J2EE deployment descriptor.
- JNDI name
- Specifies the JNDI name of the bean's home interface. This is the name under which the enterprise bean's home interface is registered and therefore, is the name that must be specified when an EJB client does a lookup of the home interface.
IBM is a trademark of the IBM Corporation in the United States, other countries, or both.