Creating and Editing the Deployment Descriptors 

Purpose

The deployment descriptors contain the deployment properties of the enterprise beans in your EJB application. The SAP NetWeaver Developer Studio generates the empty standard (ejb-jar.xml) and the J2EE Engine-specific (ejb-j2ee-engine.xml) deployment descriptors when you create an EJB Module project. After you create the enterprise beans for your application, the SAP NetWeaver Developer Studio generates the default content for the deployment descriptors. You can then edit the content and specify additional deployment properties for your enterprise beans.

The J2EE Engine-specific deployment descriptor that contains the object-relational mapping for your container-managed entity beans (persistent.xml) is not generated when you create the EJB Module project; it is generated when you create the first container-managed entity bean in your EJB application.

Process Flow

ejb-jar.xml

...

       1.      To modify the ejb-jar.xml, from the J2EE Explorer pane, choose your EJB Module project → ejb-jar.xml.

       2.      From the context menu, choose Open.

The right-hand pane displays the properties that you can specify in ejb-jar.xml. They are organized in tabs according to the structure of the ejb-jar.xml. There you can:

¡        Set the EJB JAR properties

¡        Specify bean-specific deployment properties

¡        Declare environment entries

¡        Declare EJB references

¡        Set security permissions

¡        Declare resource references

¡        Specify the deployment properties of finder/select queries (for container-managed entity beans only)

¡        Define relationships between container-managed entity beans

¡        Define transaction attributes

ejb-j2ee-engine.xml

...

       1.      To modify the ejb-j2ee-engine.xml, from the J2EE Explorer pane, choose your EJB Module project → ejb-j2ee-engine.xml.

       2.      From the context menu, choose Open.

The right-hand pane displays the properties that you can specify in ejb-j2ee-engine.xml. They are organized in tabs according to the structure of the ejb-j2ee-engine.xml. There you can:

¡        Specify arbitrary JNDI names for your beans

¡        Specify the bean’s container size

¡        Specify JNDI names for the beans references

¡        Specify stateful session beans’ timeouts

¡        Specify isolation levels

¡        Specify the pool properties

¡        Enable stateful session failover for your stateful session beans

¡        Specify the interval for the generated by the EJB Container primary keys (for container-managed entity beans only)

¡        Specify the initial cache size of the Persistence Manager (for container-managed entity beans only)

¡        Specify the destination and the connection factory JNDI names (for message-driven beans only)

persistent.xml

...

       1.      To modify the persistent.xml, from the J2EE Explorer pane, choose your EJB Module project → persistent.xml.

       2.      From the context menu, choose Open.

The right-hand pane displays the properties that you can specify in persistent.xml. They are organized in tabs according to the structure of the persistent.xml. There you can:

¡        Specify the data source and the database vendor

¡        Choose the type of the locking mechanism your entity beans will use

¡        Specify the bean’s Object/Relational mapping

¡        Specify the deployment properties of finder/select queries