List of Figures

• 1-1 TopLink Runtime Architecture
• 1-2 Solving Object-Persistence Impedance Mismatch
• 1-3 TopLink and Your Application Architecture
• 2-1 TopLink Development Process
• 2-2 TopLink Metadata
• 2-3 Three Tier Architecture
• 2-4 Two-Tier Architecture
• 2-5 Three-Tier Architecture Using Session Beans and Java Objects
• 2-6 Three-Tier CMP Architecture
• 2-7 Three-Tier BMP Architecture
• 2-8 Web Services Architecture
• 3-1 TopLink Components in Development Lifecycle
• 3-2 TopLink Workbench in Development Environment
• 4-1 Parts of the TopLink Editor
• 4-2 Sample TopLink Editor - Application Navigator
• 4-3 Sample TopLink Editor Tabs
• 4-4 Sample TopLink Editor - Structure Window
• 5-1 TopLink Workbench Window
• 5-2 Sample Menu Bar Menu
• 5-3 Sample Context Menu
• 5-4 Sample Navigator
• 5-5 Sample Active and Inactive Descriptors
• 5-6 Sample Editor
• 5-7 Sample Deficient Mapping
• 5-8 Preferences Dialog Box
• 5-9 Preferences-General Dialog Box
• 5-10 Preferences-General-Help Dialog Box
• 5-11 Preferences-Mappings Dialog Box
• 5-12 Preferences - Mappings - Class Dialog Box
• 5-13 Preferences-Mappings-EJB Preferences Dialog Box
• 5-14 Preferences-Mappings-Database Preferences Dialog Box
• 5-15 Preferences-Sessions Configuration Dialog Box
• 5-16 Preferences-Sessions Configuration-New Names Dialog Box
• 5-17 Preferences-Sessions Configuration-Platform Preferences Dialog Box
• 5-18 Sample Database Tables
• 5-19 New Table Dialog Box
• 5-20 Import Tables from Database Dialog Box
• 5-21 Duplicate Table Dialog Box
• 5-22 Fields Properties
• 5-23 Setting Primary Key for a Database Table
• 5-24 References Tab
• 5-25 New Reference Dialog Box
• 5-26 References Tab
• 5-27 SQL Creation Script Dialog Box
• 5-28 Generate Classes and Descriptors Dialog Box
• 5-29 Choose Relationships to Generate Dialog Box
• 5-30 Generate EJB Entity Classes and Descriptors Dialog Box
• 5-31 Sample XML Schemas
• 5-32 Schema Structure Tab
• 5-33 Import Schema Dialog Box
• 5-34 Schema Document Info Tab-Source Field
• 5-35 Schema Properties Dialog Box
• 5-36 Schema Document Info Tab-Namespaces Field
• 5-37 Add Class Dialog Box
• 5-38 Class Tab, Class Information Fields
• 5-39 Class Tab, Class Modifiers Fields
• 5-40 Class Tab, Interfaces Implemented Fields
• 5-41 Attributes Tab, Modifiers Fields
• 5-42 Attributes Tab, Type Declaration Fields
• 5-43 Attributes Tab, Accessors Fields
• 5-44 Class Info-Methods Tab
• 5-45 Methods Tab, Modifiers Fields
• 5-46 Methods Tab, Return Type Fields
• 5-47 Methods Tab, Method Parameters Fields
• 5-48 Select Classes Dialog Box
• 5-49 Manage Non-Descriptor Classes Dialog Box
• 5-50 Rename Package Dialog Box
• 6-1 SchemaManager Usage
• 7-1 List of Available Libraries
• 7-2 Creating a New Library Dialog Box
• 7-3 Version Control Assistance Dialog Box
• 8-1 Create TopLink Workbench Projects from OC4J Migration Dialog Box
• 12-1 DMS Spy Servlet Display
• 12-2 Using Result Set Pagination
• 15-1 Namespaces in TopLink
• 16-1 Example Inheritance Hierarchy
• 16-2 Optimistic Version Locking Policies and Cascading Example
• 17-1 How Classes and Objects Map to a Database Table
• 17-2 TopLink Indirection
• 17-3 Address Object Not Read
• 17-4 Initial Request
• 17-5 Subsequent Requests
• 17-6 Serialized Object Converter (relational)
• 17-7 Serialized Object Converter (nonrelational)
• 17-8 Type Conversion Mapping (relational)
• 17-9 Type Conversion Mapping (nonrelational)
• 17-10 Object Type XML Converter
• 17-11 Simple Type Translator
• 17-12 Mapping to an XML Document by Position
• 17-13 Mapping to an XML Document by Path and Name
• 17-14 Mapping to a Simple XML Document by Name
• 17-15 Mapping to a XML Document Using Self XPath
• 18-1 Sequencing Elements in a Class Database Table
• 18-2 TopLink Table Sequence Table
• 18-3 TopLink Unary Table Sequence Table
• 18-4 Example of Database Tables-Racquet Information
• 20-1 Database Property Sheet, Database Platform Options
• 20-2 Sequencing Tab
• 20-3 Database Property Sheet, Database Login Fields
• 20-4 Database Property Sheet, Development and Deployment Login Options
• 20-5 Defaults Tab, Named Queries Options
• 20-6 Options Tab, Table Generation Options
• 20-7 Options Tab, Table Creator Java Source Options
• 20-8 Options Tab, Project Java Source Options
• 20-9 Options Tab, Generate Deprecated Direct Mappings Option
• 21-1 Nested Aggregates
• 21-2 Inheritance Using a Superclass Table with Optional Fields
• 21-3 Inheritance Using Separate Tables for Each Subclass
• 23-1 Descriptor Info Tab, Associated Table Options
• 23-2 Descriptor Info Tab, Sequencing Options
• 23-3 Queries, Custom SQL Tab
• 23-4 Interface Alias Tab
• 23-5 Multitable Info Tab
• 23-6 Multitable Info Tab, Associated by Reference
• 27-1 Direct-to-Field Mapping
• 27-2 One-to-One Mappings
• 27-3 Variable One-to-One Mappings with Class Indicator
• 27-4 One-to-Many Relationships
• 27-5 Many-to-many Relationships
• 27-6 Direct Collection Mappings
• 27-7 Direct Map Mappings
• 27-8 Aggregate Object Mapping with a Single Source Object
• 27-9 Aggregate Object Mapping with Multiple Source Objects
• 27-10 Transformation Mappings
• 28-1 Direct Mapping General Tab, Database Field Option
• 28-2 General Tab, Reference Descriptor Field
• 28-3 General Tab, Batch Reading Option
• 28-4 Ordering Tab
• 28-5 Table Reference Tab, Table Reference Field
• 28-6 General Tab, Use Joining Option
• 30-1 DIrect to XML Mapping Property Sheet, Read Whole Document Option
• 32-1 Variable One-to-One Mapping using Class indicator Field
• 32-2 Class Indicator Info Tab
• 32-3 Class Indicator Info Tab, Configuring Primary Key
• 32-4 Variable One-to-One Relationship with Unique Primary Key
• 32-5 Query Key Associations Tab
• 34-1 Table Reference Tab, Relation Table Option
• 36-1 General Tab, Target Table Options
• 36-2 General Tab, Direct Value Field
• 37-1 Fields Tab
• 37-2 General Tab, Allow Null Option
• 38-1 General Tab, Direct Value Field
• 38-2 General Tab, Direct Key Field
• 38-3 Converter Tab, Key Converter Subtab
• 38-4 Converter Tab, Value Converter Subtab
• 48-1 Create TopLink Workbench Project using JAXB Dialog Box
• 52-1 Descriptor Info Tab, Schema Context Option
• 52-2 Choose Schema Context Dialog Box
• 52-3 Class Representing xsd:anyType
• 52-4 Descriptor Info Tab, Complex Type "anyType" Option
• 52-5 Descriptor Info Tab, Default Root Option
• 52-6 Choose Root Element Dialog Box
• 52-7 Descriptor Info Tab, Preserve Document Option
• 53-1 XML Direct Mapping to Simple Text Node
• 53-2 XML Direct Mapping to a Text Node in a Simple Sequence
• 53-3 XML Direct Mapping to a Text Node in a Subelement
• 53-4 XML Direct Mapping to Text Node by Position
• 53-5 XML Direct Mapping to an Attribute
• 53-6 XML Direct Mapping to a Specified Schema Type
• 53-7 XMLDirect Mapping to a List Field
• 53-8 Java Class for XML Direct Mapping to a Union Field
• 53-9 XML Direct Mapping to the First Valid Union Type
• 53-10 XML Direct Mapping to Another Valid Union Type
• 53-11 XML Direct Mapping to Union of Lists
• 53-12 Java Class for XML Direct Mapping to a Union of Unions
• 53-13 Java Class for XML Direct Mapping with Simple Type Translator
• 53-14 XML Direct Mapping with a Simple Type Translator
• 53-15 Composite Direct Collection XML Mapping to a Simple Sequence
• 53-16 Composite Direct Collection XML Mapping to a Subelement Sequence
• 53-17 Composite Direct Collection XML Mapping to Multiple Attributes
• 53-18 XML Composite Direct Collection Mapping to a Single Text Node
• 53-19 XML Composite Direct Collection Mapping to a Single Attribute
• 53-20 Composite XML Direct Collection Mapping to List of Unions
• 53-21 XML Composite Direct Collection Mapping to a Union of Lists
• 53-22 XML Composite Direct Collection Mapping with Specified Content Type
• 53-23 XML Composite Object Mapping into the Parent Record
• 53-24 XML Composite Object Mapping to an Element
• 53-25 XML Composite Object Mapping to Elements by Name
• 53-26 XML Composite Object Mapping to Elements by Position
• 53-27 XML Composite Collection Mapping
• 53-28 Java Classes for XML Any Object Mapping
• 53-29 XML Any Object Mapping to Address Type
• 53-30 XML Any Object Mapping to PhoneNumber Type
• 53-31 XML Any Object Mapping to String Type
• 53-32 Java Classes for XML Any Collection Mapping
• 53-33 XML Any Collection Mapping
• 53-34 XML Transformation Mappings
• 53-35 Class Diagram
• 53-36 Class Diagram
• 54-1 General Tab, Reference Descriptor Field
• 54-2 Mapping Tab, Maps to Wildcard Option
• 73-1 Connection Tab, Platform Option
• 73-2 Connection Tab, Connection Specification Options
• 76-1 Descriptor Info Tab, Schema Context Option
• 76-2 Choose Schema Context Dialog Box
• 76-3 Descriptor Info Tab, Default Root Element Option
• 76-4 Choose Root Element Dialog Box
• 76-5 Queries, Custom Calls Tab for EIS Calls
• 77-1 EIS Composite Mappings
• 77-2 EIS Reference Mappings
• 77-3 Possible EIS Mapping Architectures
• 77-4 EIS Direct Mappings
• 77-5 EIS Composite Direct Collection Mapping
• 77-6 EIS Composite Object Mappings
• 77-7 EIS Composite Collection Mappings
• 77-8 EIS One-to-One Mapping with Key on Source
• 77-9 EIS One-to-One Mapping with Key on Target
• 77-10 EIS One-to-Many Mapping with Key on Source
• 77-11 EIS One-to-Many Mapping with Key on Target
• 77-12 EIS Transformation Mappings
• 78-1 General Tab, Reference Descriptor Field
• 78-2 Selection Interaction Tab
• 83-1 General Tab, Foreign Keys Field
• 83-2 Specify Field Pair Dialog Box
• 84-1 Foreign Keys Field on General Tab
• 84-2 Delete All Interaction Tab
• 87-1 Simple TopLink Session Architecture
• 87-2 Typical TopLink Server Session with Client Session Architecture
• 87-3 Server Session and Client Session Usage
• 87-4 Multiple Client Sessions Reading the Database Using the Server Session
• 87-5 Writing with Client Sessions and Server Sessions
• 87-6 Isolated Client Sessions
• 87-7 TopLink Session Broker with Server Session Architecture
• 87-8 TopLink Database Session Architecture
• 87-9 Typical TopLink Server Session with Remote Session Architecture
• 87-10 An Architectural Overview of the Remote Session
• 88-1 Sessions Configurations in Navigator Window
• 88-2 Sessions Configuration Property Sheet
• 88-3 Create New Session Dialog Box, Server Session Option
• 88-4 Create New Session Broker Dialog Box
• 88-5 Create New Session Dialog Box, Database Session Option
• 89-1 General Tab, Project Subtab, Primary Project Option
• 89-2 Edit Primary Project Dialog Box
• 89-3 Logging Tab
• 89-4 General Tab, Project Subtab, Multiple Projects Options
• 89-5 General Tab, Multiple Projects Subtab
• 89-6 Options Tab, Profiler Options
• 89-7 Options Tab, Exception Handler Field
• 89-8 Options Tab, Session Customizer Class Field
• 89-9 General Tab, Server Platform Subtab
• 89-10 Options Tab, Event Listeners field
• 89-11 Connection Policy Tab
• 94-1 General Tab, Sessions Subtab
• 94-2 Sessions Dialog Box
• 97-1 Login Tab, Connection Subtab, User Name and Password Fields
• 97-2 Login Tab, Connection Subtab, External Connection Pooling Field, Database Driver
• 97-3 Connection Tab, External Connection Pooling Field, Java EE Data Source
• 97-4 Login Tab, Properties Subtab
• 98-1 Login Tab, Connection Subtab, Database Platform Option
• 98-2 Login Tab, Connection Subtab, Database Driver
• 98-3 Login Tab, Connection Subtab
• 98-4 Login Tab, Sequencing Subtab
• 98-5 Login Tab, Options Subtab, Table Qualifier Field
• 98-6 Login Tab, Options Subtab, JDBC Options
• 98-7 Login Tab, Options Subtab, Advanced Options
• 99-1 Login Tab, Connection Subtab, Platform Options
• 99-2 Login Tab, Connection Subtab
• 101-1 General Tab, Connection Count Options
• 101-2 Login Tab, Properties Subtab
• 101-3 Login Tab, Connection Subtab
• 101-4 Login Tab, Connection Subtab, Relational Session Connection Pool Options
• 101-5 Login Tab, Connection Subtab, EIS Session Connection Pool Options
• 101-6 Login Tab, Connection Subtab, Exclusive Connections Option
• 102-1 Object Life Cycle and the TopLink Caches
• 102-2 Cache Coordination
• 103-1 Cache Coordination Tab, Synchronous Field
• 103-2 Cache Coordination Tab, Channel Field
• 103-3 Cache Coordination Tab, Multicast Group Address Field
• 103-4 Cache Coordination Tab, Multicast Port Field
• 103-5 Cache Coordination Tab, JNDI Naming Service Options
• 103-6 Cache Coordination Tab, Naming Service Options
• 103-7 Cache Coordination Tab, Announcement Delay Field
• 103-8 Cache Coordination Tab, Remove Connection on Error Option
• 103-9 Edit Properties Dialog Box
• 103-10 Cache Coordination Tab, Packet Time to Live Field
• 104-1 Cache Coordination Tab, Topic Name Field, JMS
• 104-2 Cache Coordination Tab, Topic Connection Factory Name Field
• 104-3 Cache Coordination Tab, Topic Host URL Field
• 104-4 Cache Coordination Tab, Remove Connection on Error Option
• 107-1 Cache Coordination, Transport Class Option
• 110-1 Expression Builder Dialog Box
• 110-2 Choose Query Key
• 113-1 The Life Cycle of a Unit of Work
• 113-2 Example Object Model
• 113-3 Example Data Model
• 115-1 Conforming Example
• 115-2 Unit of Work when an External Transaction Exists
• 115-3 Unit of Work when No External Transaction Exists
• 116-1 Create New TopLink Workbench Project Dialog Box
• 116-2 Potential EJB Descriptors Dialog Box
• 116-3 Create New TopLink Workbench Project From Previous Version Dialog Box
• 116-4 Save Projects Dialog Box
• 116-5 Save As Dialog Box
• 116-6 Problem Report Dialog Box
• 117-1 General Tab, Project Save Location
• 117-2 General Tab, Classpath Options
• 117-3 Defaults Tab, Field Accessing Options
• 117-4 General Tab, Persistence Type Options
• 117-5 Defaults Tab, Descriptor Advanced Properties
• 117-6 Defaults Tab, Existence Checking Options
• 117-7 Options Tab, Project Deployment XML Options
• 117-8 Options Tab, Model Java Source options
• 117-9 Defaults Tab, Cache Identity Map Options
• 117-10 Defaults Tab, Cache Isolation Options
• 117-11 Defaults Tab, Coordination Options
• 117-12 Defaults Tab, Cache Expiry Options
• 117-13 General Tab, Comments Options
• 119-1 Descriptor Info Tab, Primary Key Options
• 119-2 Descriptor Info Tab, Read Only Option
• 119-3 Descriptor Info Tab, Conform Results in Unit of Work Option
• 119-4 Descriptor Info Tab, Descriptor Alias Field
• 119-5 Descriptor Info Tab, Comment Field
• 119-6 Queries Tab-Named Queries Subtab
• 119-7 Add Named Query Dialog Box
• 119-8 Named Queries, General Tab
• 119-9 Named Queries, Selection Criteria Tab
• 119-10 Named Queries, Order Tab
• 119-11 Named Queries, Optimization Tab
• 119-12 Add Joined Attribute Dialog Box
• 119-13 Named Queries, Attributes Tab
• 119-14 Add Report Query Attribute Dialog Box
• 119-15 Named Queries, Group/Order Tab
• 119-16 Add Ordering Attribute Dialog Box
• 119-17 Call Tab
• 119-18 Named Queries, Options Tab
• 119-19 Advanced Query Options Dialog Box
• 119-20 Descriptor Queries Settings Tab, Query Timeout Options
• 119-21 Descriptor Queries Settings Tab, Cache Refreshing Options
• 119-22 Queries, Query Keys Tab
• 119-23 Automatically Generated Query Keys for Phone and Email
• 119-24 Interface Descriptor Editor Window
• 119-25 Caching Tab, Identity Map Options
• 119-26 Caching Tab, Isolation Options
• 119-27 Caching Tab, Coordination Options
• 119-28 Caching Tab, Expiration Options
• 119-29 Caching Tab, Existence Checking Options
• 119-30 EJB Info Tab
• 119-31 Inheritance Tab, Read Subclasses on Query Option
• 119-32 Inheritance Tab, Child Descriptor Option
• 119-33 Inheritance Tab, Configuring Inheritance for a Root Descriptor
• 119-34 Example Inheritance Hierarchy
• 119-35 PERSON Table
• 119-36 Events Tab
• 119-37 Locking Tab for a Descriptor
• 119-38 Locking Tab for an EIS Root Descriptor
• 119-39 Returning Tab
• 119-40 Instantiation Tab
• 119-41 Copying Tab
• 119-42 After Load Tab
• 120-1 Mapping a BLOB in TopLink Workbench
• 120-2 Selecting Database Platform in TopLink Workbench
• 121-1 General Tab, Read-Only Option
• 121-2 General Tab, Indirection Options
• 121-3 General Tab, XPath Options
• 121-4 XPath Options for Composite Object Mappings
• 121-5 Choose XPath Dialog Box
• 121-6 General Tab, Default Null Value Options
• 121-7 General Tab, Method Accessing Options
• 121-8 General Tab, Private Owned option
• 121-9 General Tab, Comment
• 121-10 Converter Tab, Serialized Object Converter Option
• 121-11 Converter Tab, Type Conversion Converter Option
• 121-12 Converter Tab, Object Type Converter
• 121-13 General Tab, Use XML Schema "type" Attribute Option
• 121-14 General Tab, Advanced Container Options
• 121-15 Transformation Mapping, Attribute Transformer Field
• 121-16 Specify Transformer Dialog Box
• 121-17 Transformation Mapping, Field Transformer Associations
• 121-18 Specify Field-Transformer Association Dialog Box
• 121-19 Transformation Mapping, Mutable Option
• 121-20 General tab, Maintains Bidirectional Relationship option
• 121-21 General Tab, Use Single Node Option