Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Understanding Entity Beans With Container-Managed Persistence

• What is an Entity Bean?
• Entity Beans With Container-Managed Persistence
• Container-Managed Persistent Fields
• Container-Managed Relationships
• Callback Methods
• Querying for an Entity Bean
• Understanding EJB QL
• Understanding Query Syntax
• Understanding Finder Methods
• Understanding Select Methods
• Avoiding Database Resource Contention
• Entity Bean Database Isolation Levels and Resource Contention
• Entity Bean Concurrency Modes and Resource Contention
• Combining Entity Bean Database Isolation Level and Concurrency Mode
• Entity Bean Concurrency Modes and Clustering
• When to Use an Entity Bean With Container-Managed Persistence?

2 Understanding Orion CMP Application Development

• Developing, Packaging and Deploying EJB Applications
• Understanding the EJB Application Directory Structure
• Using EJB Development Tools
• Using JDeveloper
• Packaging and Deploying EJB CMP Applications
• Understanding EJB Deployment Descriptor Files
• Deploying the CMP EJB Application to OC4J

3 Understanding Orion CMP Support in OC4J

• EJB 2.0 Support
• Persistence Manager
• Orion Persistence Manager
• TopLink Persistence Manager
• Migrating to the TopLink Persistence Manager
• Key Features of the TopLink Migration Tool
• Using the TopLink Migration Tool From the Command Line
• Post-Migration Changes
• Troubleshooting Your Migration

4 Implementing an EJB 2.0 Entity Bean With Container-Managed Persistence

• Implementing an EJB 2.0 Entity Bean With Container-Managed Persistence
• Implementing the Entity Bean Home Interface
• Declaring the Home Interface in the Deployment Descriptor
• Implementing the Entity Bean Component Interface
• Declaring the Component Interface in the Deployment Descriptor
• Implementing the Entity Bean Class
• Defining the Entity Bean Class in the Deployment Descriptor

5 Configuring an EJB 2.0 Entity Bean With Container-Managed Persistence

• Configuring Primary Key
• Configuring Primary Key Field
• Configuring Primary Key Class
• Configuring Foreign Key in a Composite Primary Key
• Configuring Automatic Primary Key Generation
• Configuring Container-Managed Persistent Fields
• Configuring Default Mapping of Persistent Fields to the Database
• Configuring Explicit Mapping of Persistent Fields to the Database
• Configuring Container-Managed Relationship Fields
• Configuring Default Mapping of Relationship Fields to the Database
• Conversion of CMP Types to Database Types
• Configuring Explicit Mapping of Relationship Fields to the Database
• Configuring orion-ejb-jar.xml to Map Bean Relationships to Database Tables
• Explicit One-to-One Relationship Mapping
• Explicit One-to-Many Relationship Mapping
• Configuring Database Isolation Levels
• Configuring Concurrency Modes
• Configuring Exclusive Write Access to the Database
• Configuring Callback Methods for EJB 2.0 Entity Beans With Container-Managed Persistence

6 Implementing Query Methods for an Entity Bean With Container-Managed Persistence

• Implementing EJB QL Finder Methods
• Specifying Finder Methods Using EJB QL Syntax
• Defining Finder Methods in the Home Interface
• Using the Deployment Descriptor to Provide the Finder Methods Definition
• Specifying Finder Methods Using OC4J-specific Syntax
• Adding Finder Methods to the Home Interface
• Using the OC4J-specific Deployment Descriptor to Define Finder Methods
• Implementing EJB QL Select Methods
• Defining the Return Type for the Select Method

A XML Reference for orion-ejb-jar.xml Elements

• OC4J-specific Deployment Descriptor for EJB
• Enterprise Beans Section
• Entity Bean Section
• AC4J Active EJB Section
• Method Definition
• Assembly Descriptor Section
• Element Description

Index