Contents

List of Examples

List of Figures

List of Tables

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