Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Structure

Related Documents

Conventions

1 Introductory Tutorial

Overview

Creating the Database Schema

Creating a New Project

Setting the Project's Classpath

Enabling Your Java Classes

Generating the Class Definitions

Logging into the Database

Creating Tables

Creating Tables Using the Mapping Workbench

Creating the Table Definitions

Creating the Tables on the Database

Importing Tables from the Database

Mapping Classes and Tables in the Descriptor

Mappings

Descriptors

Mapping Classes to Tables

Preparing the Primary Keys

Setting the Sequence Table

Implementing Direct-to-field Mappings

Setting the Sequence Name

Creating One-to-one Mappings Between Objects

Foreign Key References

Creating One-to-many Mappings

Setting up Database Sessions

Logging into a Database

Creating the Tables in Code

Using Descriptors in an Application

Transactions and Units of Work

Reading and Writing Java Class Instances

Using a Unit of Work to Write an Object

Using a Session to Read an Object

Conclusion

2 Advanced Tutorial

Creating the Database Schema

Creating a New Project

Mapping Classes to Tables

Using the Automap Tool

Implementing Indirection

Preparing Java Code for Indirection

Implementing Indirection in the Mapping Workbench

Implementing Indirection in the Tutorial

Implementing a One-to-one self Relationship

Creating Other One-to-one Mappings

Implementing a One-to-many Self-relationship

Creating Other One-to-many Mappings

Using Multiple Tables

Implementing Object Type Mapping

Implementing an Aggregate Object

Implementing a Direct Collection Mapping

Implementing a Many-to-many Mapping

Implementing Inheritance

Implementing a Transformation Mapping

Mapping the Remaining Attributes

Generating Code

Index