The Contents of a Deployment Descriptor
by Richard Monson-Haefel, Bill Burke, Sacha Labourey
Enterprise JavaBeans, Fourth Edition
- Enterprise JavaBeans, 4th Edition
- Preface
- I. Lay of the Land
- 1. Introduction
- 2. Architectural Overview
- 3. Resource Management and the Primary Services
- 4. Developing Your First Enterprise Beans
- Choosing and Setting Up an EJB Server
- Developing an Entity Bean
- Developing a Session Bean
- 5. The Remote and Local Client View
- 6. CMP: Basic Persistence
- 7. CMP: Entity Relationships
- The Seven Relationship Types
- Abstract Persistence Schema
- Database Modeling
- One-to-One, Unidirectional Relationship
- One-to-One, Bidirectional Relationship
- One-to-Many, Unidirectional Relationship
- The Cruise, Ship, and Reservation EJBs
- Many-to-One, Unidirectional Relationship
- One-to-Many, Bidirectional Relationship
- Many-to-Many, Bidirectional Relationship
- Many-to-Many, Unidirectional Relationship
- Co-Location and the Deployment Descriptor
- Cascade Delete and Remove
- The Seven Relationship Types
- 8. CMP: EJB QL
- Declaring EJB QL
- The Query Methods
- EJB QL Examples
- Simple Queries
- Simple Queries with Paths
- The IN Operator
- Using DISTINCT
- The WHERE Clause and Literals
- The WHERE Clause and Input Parameters
- The WHERE Clause and Operator Precedence
- The WHERE Clause and CDATA Sections
- The WHERE Clause and Arithmetic Operators
- The WHERE Clause and Logical Operators
- The WHERE Clause and Comparison Symbols
- The WHERE Clause and Equality Semantics
- The WHERE Clause and BETWEEN
- The WHERE Clause and IN
- The WHERE Clause and IS NULL
- The WHERE Clause and IS EMPTY
- The WHERE Clause and MEMBER OF
- The WHERE Clause and LIKE
- Functional Expressions
- EJB 2.1: The ORDER BY Clause
- Problems with EJB QL
- 9. Bean-Managed Persistence
- 10. The Entity-Container Contract
- The Primary Key
- The Callback Methods
- ejbHome( )
- EntityContext
- The Life Cycle of an Entity Bean
- Does Not Exist
- The Pooled State
- The Ready State
- Transitioning from the Pooled state to the Ready state via creation
- Transitioning from the Pooled state to the Ready state via a query method
- Transitioning from the Pooled state to the Ready state via activation
- Transitioning from the Ready state to the Pooled state via passivation
- Transitioning from the Ready state to the Pooled state via removal
- Life in the Ready State
- End of the Life Cycle
- 11. Session Beans
- The Stateless Session Bean
- The ProcessPayment EJB
- The database table (PAYMENT)
- The remote interface (ProcessPaymentRemote)
- Dependent objects (CreditCardDO and CheckDO classes)
- An application exception (PaymentException)
- The home interface (ProcessPaymentHomeRemote)
- The bean class (ProcessPaymentBean)
- Accessing environment properties (JNDI ENC)
- The ProcessPayment EJB’s deployment descriptor
- Local component interfaces
- The ProcessPayment EJB
- The Life Cycle of a Stateless Session Bean
- The Stateful Session Bean
- Getting Set Up for the TravelAgent EJB
- The TravelAgent EJB
- The remote interface (TravelAgent)
- Dependent object (TicketDO)
- The home interface (TravelAgentHomeRemote)
- Taking a peek at the client view
- TravelAgentBean: The bean class
- JNDI ENC and EJB references
- Remote EJB references in the JNDI ENC
- Local EJB references in the JNDI ENC
- The bookPassage( ) method
- Why use a Reservation entity bean?
- Listing behavior (listAvailableCabins( ))
- The TravelAgent deployment descriptor
- The Life Cycle of a Stateful Session Bean
- The Stateless Session Bean
- 12. Message-Driven Beans
- JMS and Message-Driven Beans
- JMS-Based Message-Driven Beans
- The Life Cycle of a Message-Driven Bean
- Connector-Based Message-Driven Beans
- EJB 2.1: Message Linking
- 13. Timer Service
- 14. EJB 2.1: Web Service Standards
- 15. EJB 2.1 and Web Services
- 16. Transactions
- ACID Transactions
- Declarative Transaction Management
- Isolation and Database Locking
- Nontransactional Beans
- Explicit Transaction Management
- Exceptions and Transactions
- Transactional Stateful Session Beans
- 17. J2EE
- 18. XML Deployment Descriptors
- The ejb-jar File
- The Contents of a Deployment Descriptor
- The Document Headerand Schema Declarations
- The Descriptor’s Body
- Describing Enterprise Beans
- Describing Relationships
- Describing Bean Assembly
- 19. EJB Design in the Real World
- II. JBoss Workbook
- 20. Introduction
- 21. JBoss Installation and Configuration
- 22. Exercises for Chapter 4
- 23. Exercises for Chapter 5
- 24. Exercises for Chapter 6
- 25. Exercises for Chapter 7
- 26. Exercises for Chapter 8
- 27. Exercises for Chapter 9
- 28. Exercises for Chapter 11
- 29. Exercises for Chapter 12
- Exercise 12.1: JMS as a Resource
- Exercise 12.2: The Message-Driven Bean
- 30. Exercises for Chapter 13
- 31. Exercises for Chapter 15
- A. Database Configuration
- Index
- Colophon
We’ve discussed XML deployment descriptors throughout this book—you probably know enough to write deployment descriptors on your own. However, it is still worthwhile to take a tour through a complete descriptor. Example 18-1 is a complete deployment descriptor for the Cabin EJB, which we created in Chapter 4. Other than the type of schema used (XSD or DTD) and the fact that EJB 2.1 uses XML namespaces, the elements are the same in EJB 2.1 and 2.0. The Cabin EJB’s deployment descriptor contains most of the tags that are needed to describe entity beans; session and message-driven beans are not much different. The differences between the versions are small but significant. We’ll use this deployment descriptor to guide our discussion in the following sections.
Example 18-1. Cabin EJB deployment descriptor
<?xml version="1.0" encoding="UTF-8"?>
...
<ejb-jar ...>
<enterprise-beans>
<entity>
<description>
This Cabin enterprise bean entity represents a cabin
on a cruise ship.
</description>
<ejb-name>CabinEJB</ejb-name>
<home>com.titan.cabin.CabinHomeRemote</home>
<remote>com.titan.cabin.CabinRemote</remote>
<local-home>com.titan.cabin.CabinHomeLocal</local-home>
<local>com.titan.cabin.CabinLocal</local>
<ejb-class>com.titan.cabin.CabinBean</ejb-class>
<persistence-type>Container</persistence-type>
<prim-key-class>com.titan.cabin.CabinPK</prim-key-class>
<reentrant>False</reentrant>
<cmp-version>2.x</cmp-version>
<abstract-schema-name>Cabin</abstract-schema-name>
<cmp-field><field-name>id</field-name></cmp-field>
<cmp-field><field-name>name</field-name></cmp-field>
<cmp-field><field-name>deckLevel</field-name></cmp-field>
<cmp-field><field-name>shipId</field-name></cmp-field>
<cmp-field><field-name>bedCount</field-name></cmp-field>
<primkey-field>id</primkey-field>
</entity>
</enterprise-beans>
<assembly-descriptor>
<security-role>
<description>
This role represents everyone who is allowed full access
to the Cabin EJB.
</description>
<role-name>everyone</role-name>
</security-role>
<method-permission>
<role-name>everyone</role-name>
<method>
<ejb-name>CabinEJB</ejb-name>
<method-name>*</method-name>
</method>
</method-permission>
<container-transaction>
<method>
<ejb-name>CabinEJB</ejb-name>
<method-name>*</method-name>
</method>
<trans-attribute>Required</trans-attribute>
</container-transaction>
</assembly-descriptor>
</ejb-jar>-
No Comment
..................Content has been hidden....................
You can't read the all page of ebook, please click here login for view all page.