Contents

Title and Copyright Information

Send Us Your Comments

Preface

1 Introduction

TopLink Container-Managed Persistence

TopLink for Java

TopLink Mapping Workbench

Understanding container-managed persistence

Enterprise JavaBeans (EJBs)

EJB 2.0 Support

Terminology and definitions

Java objects and Entity Beans

2 Mapping Entity Beans

Using TopLink Mapping Workbench

Mappings

Creating mappings

Direct mappings

Relationship mappings

Mappings between entity beans

Mappings between entity beans and Java objects

One-to-one mappings

One-to-many mappings

Many-to-many mappings

Aggregate object mappings

Aggregate collection mappings

Sequencing with Entity Beans

Inheritance

Indirection

3 Configuring TopLink Container-Managed Persistence

Software requirements

Configuring TopLink CMP

Testing TopLink Container-Managed Persistence with entity beans

Running the BEA WebLogic Server with TopLink

Configuration troubleshooting

4 EJB Entity Bean Deployment

Overview of deployment

Understanding Deployment

Requirements before deployment

Steps in the deployment process

Configuring entity bean deployment descriptors

Configuring the ejb-jar.xml file

Updating the ejb-jar.xml file

Configuring the weblogic-ejb-jar.xml file

Persistence descriptor

Enabling Call by Reference

Unsupported tags in the weblogic-ejb-jar.xml file

Configuring the toplink-ejb-jar.xml file

Defining required project options: the Session Section

Generating the run-time classes

Running the Weblogic EJB Compiler

Installing the beans in the server

Connection pools and data sources

Creating JDBC connection pools

Creating JTS and non-JTS data sources

Using the defined connection pool

Using the defined data source

Problems with deployment

Message Logging

Hot deployment of EJBs

Running an EJB Client

5 Defining and Executing Finders

Defining finders in TopLink

ejb-jar.xml Finder Options

Query Section - XML Elements

Choosing the best finder type for your query

Using EJBQL

Creating an EJBQL finder

Using the TopLink Expression framework

Creating an Expression Finder

Building an expression

Creating amendment methods for Expression finders

Using Dynamic finders

Creating a Dynamic finder

Using findAll

Using findByPrimaryKey

Using redirect finders

Using SQL

Creating an SQL finder

Using ejbSelect

Understanding select methods

Advanced finder options

Caching options

Disabling caching of returned finder results

Refreshing finder results

Managing large result sets

Building the query

Executing the finder from the client in EJB 1.1

Executing the finder from the client in EJB 2.0

6 Run-time Considerations

Transaction support

TopLink within the BEA WebLogic Server

When updates occur

Valid transactional states

Maintaining bi-directional relationships

One-to-Many relationship

Managing dependent objects (EJB 1.1)

Serializing Java objects between client and server

Merging changes to regular Java objects

Managing collections of EJBObjects (EJB 1.1)

7 Customization

Customizing TopLink descriptors and mappings

Creating projects and TopLink descriptors in Java

Customizing TopLink descriptors with amendment methods

Working with TopLink ServerSession and Login

Understanding ServerSession

Understanding DatabaseLogin

Customizing ServerSession and DatabaseLogin

Additional configuration changes

Using the DeploymentCustomization interface

Using a BEA WebLogic Startup class

8 Clustering

Terminology

TopLink in a Cluster

Relationships

Static partitioning

Pinning

Using User Transactions

Using session beans

Caching issues

Explicit query refreshes

Refresh Policy

Cache Usage

Cache Synchronization

Remote Merge

Synchronous Mode

Asynchronous Mode

Configuring Cache Synchronization

Cache Locking

Using cache locking

9 The EJB 2.0 Single Bean Example Application

Running the Single Bean example

Configuring the example database

Understanding the Single Bean example

Single Bean example: packages, classes, and file

The Object model

Database schema

Entity Development

Create the interfaces

Create and implement the bean classes

Create the deployment descriptors

ejb-jar.xml

weblogic-ejb-jar.xml

toplink-ejb-jar.xml

Map the entities to the database

Creating a TopLink project

Generate the deployable JAR file

Using the Build Script

Deploy the JAR file

A EJB Architectures Summary

Introduction to EJB architectures

Remote Entities

Remote Session beans

Session Façade - Combining Session and Entity beans

Thin Client

Dependent Lightweight Objects

Local Entities

Dependent Value Objects

Dependent Java Objects

Conclusion

B The toplink-ejb-jar DTD

DTD listing

Index