Sun Java System Application Server Enterprise Edition 8.2 Developer's Guide

Subelements

The following table describes subelements for the ejb element.

Table A–41 ejb Subelements

Element  

Required  

Description  

ejb-name

only one 

Matches the ejb-name in the corresponding ejb-jar.xml file.

jndi-name

zero or more 

Specifies the absolute jndi-name.

ejb-ref

zero or more 

Maps the absolute JNDI name to the ejb-ref element in the corresponding J2EE XML file.

resource-ref

zero or more 

Maps the absolute JNDI name to the resource-ref in the corresponding J2EE XML file.

resource-env-ref

zero or more 

Maps the absolute JNDI name to the resource-env-ref in the corresponding J2EE XML file.

service-ref

zero or more 

Specifies runtime settings for a web service reference. 

pass-by-reference

zero or one 

Specifies the passing method used by an enterprise bean calling a remote interface method in another bean that is colocated within the same process. 

cmp

zero or one 

Specifies runtime information for a container-managed persistence (CMP) entity bean for EJB 1.1 and EJB 2.1 beans. 

principal

zero or one 

Specifies the principal (user) name in an enterprise bean that has the run-as role specified.

mdb-connection-factory

zero or one 

Specifies the connection factory associated with a message-driven bean. 

jms-durable-subscription-name

zero or one 

Specifies the durable subscription associated with a message-driven bean. 

jms-max-messages-load

zero or one 

Specifies the maximum number of messages to load into a Java Message Service session at one time for a message-driven bean to serve. The default is 1. 

ior-security-config

zero or one 

Specifies the security information for the IOR. 

is-read-only-bean

zero or one 

Specifies that this entity bean is read-only. 

refresh-period-in-seconds

zero or one 

Specifies the rate at which a read-only-bean must be refreshed from the data source. 

commit-option

zero or one 

Has valid values of B or C. Default value is B. 

cmt-timeout-in-seconds

zero or one 

Overrides the Transaction Timeout setting of the Transaction Service for an individual bean. 

use-thread-pool-id

zero or one 

Specifies the thread pool from which threads are selected for remote invocations of this bean. 

gen-classes

zero or one 

Specifies all the generated class names for a bean. 

bean-pool

zero or one bean-pool

Specifies the bean pool properties. Used for stateless session beans, entity beans, and message-driven bean pools. 

bean-cache

zero or one bean-pool

Specifies the bean cache properties. Used only for stateful session beans and entity beans. 

mdb-resource-adapter

zero or one 

Specifies runtime configuration information for a message-driven bean. 

webservice-endpoint

zero or more 

Specifies information about a web service endpoint. 

flush-at-end-of-method

zero or one 

Specifies the methods that force a database flush after execution. Used for entity beans. 

checkpointed-methods

zero or one 

Deprecated. Supported for backward compatibility. Use checkpoint-at-end-of-method instead.

checkpoint-at-end-of-method

zero or one 

Specifies that the stateful session bean state is checkpointed, or persisted, after the specified methods are executed. The availability-enabled attribute must be set to true.