List of Examples

• 2-1 Setting the Back-Pointer in the Entity Bean
• 2-2 Managing Dependent Objects
• 4-1 Setting DRIVER_CLASSPATH on Windows
• 4-2 Setting DRIVER_CLASSPATH on UNIX
• 4-3 XML Schema with Namespace Options
• 4-4 Configuring Namespaces
• 4-5 Declaring TopLink Workbench Ant Task and Data Types in a toplink-ant-lib.xml File
• 4-6 Specifying the toplink-ant-lib.xml File in the build.xml File
• 4-7 Example Ant Build File with TopLink Workbench Ant Tasks
• 4-8 A mappings.validate Task
• 4-9 A session.validate Task
• 4-10 A mappings.export Task
• 4-11 A classpath Element
• 4-12 An ignoreerror Element
• 4-13 An ignoreerrorset Element
• 4-14 A loginspec Element
• 5-1 Creating a TableCreator Class
• 6-1 Merging Projects
• 6-2 Merging Files
• 7-1 Configuring XML Platform
• 7-2 Using the TopLink Migration Tool from the Command Line
• 7-3 A cmp-field-mapping with persistence-type Specifying a Column Size
• 7-4 Using the TopLink Migration Tool from the Command Line
• 7-5 A Subset of a "Grant" Section from a BEA WebLogic.policy File
• 7-6 Permissions for System Properties
• 7-7 Permissions for Loading Deployment XML Files
• 7-8 Permissions for Cache Coordination
• 7-9 Permissions for non-J2EE Data Source Connections
• 7-10 Permissions for java.util.logging
• 8-1 Enhanced Validation Exceptions
• 8-2 BEA WebLogic Server toplink-ejb-jar.xml File
• 11-1 Performance Profiler Output
• 11-2 JDBC Driver Fetch Size
• 11-3 No Optimization
• 11-4 Optimization Through Partial Object Reading
• 11-5 Optimization Through Report Query
• 11-6 Configuring a Query with a FetchGroup Using the FetchGroupManager
• 11-7 No Optimization
• 11-8 Optimization Through Joining
• 11-9 Optimization Through Batch Reading
• 11-10 No Optimization
• 11-11 Optimization Through View Object
• 11-12 View the Report from Example 11-11
• 11-13 No Optimization
• 11-14 Fully Optimized
• 13-1 Descriptor Exception
• 13-2 Concurrency Exception
• 13-3 Conversion Exception
• 13-4 Database Exception
• 13-5 Optimistic Lock Exception
• 13-6 Query Exception
• 13-7 Validation Exception
• 13-8 EJB QL Exception
• 13-9 Session Loader Exception
• 13-10 Communication Exception
• 13-11 JMS Processing Exception
• 13-12 JMS Processing Exception
• 13-13 Default Mapping Exception
• 13-14 Discovery Exception
• 13-15 Remote Command Manager Exception
• 13-16 Transaction Exception
• 13-17 XML Conversion Exception
• 13-18 Migration Utility Exception
• 13-19 EJB JAR XML Exception
• 13-20 Entity Manager Setup Exception
• 13-21 XML Marshal Exception
• 13-22 EJB JAR XML Exception
• 15-1 Location of the sessions.xml file
• 17-1 Typical Generated sessions.xml File
• 17-2 Using the Context Path
• 17-3 Setting Primary Key in IBM WebSphere
• 17-4 Setting Primary Key in OC4J and BEA WebLogic
• 17-5 XML Schema with Element Form Default Qualified and Attribute Form Default Unqualified
• 17-6 XML Document
• 17-7 XML Descriptors and Mappings
• 17-8 XML Schema with Element and Attribute Form Default Unqualified
• 17-9 XML Document
• 17-10 XML Descriptors and Mappings
• 17-11 XML Schema with Element and Attribute Form Default Qualified
• 17-12 XML Document
• 17-13 XML Descriptors and Mappings
• 18-1 Specifying a TopLink Project in Code
• 18-2 Proxy Settings in tljaxb.cmd
• 18-3 Proxy Settings in tljaxb.sh
• 18-4 Generating an Object Model from a Schema with tljaxb.cmd
• 20-1 Configuring Sequencing at the Project Level in Java
• 23-1 Nested Embeddables
• 23-2 Customer and Address Classes
• 23-3 Customer and Address Schema
• 23-4 Class Extraction Method
• 23-5 Descriptor Inheritance Hierarchy
• 24-1 Creating a Relational Descriptor in Java
• 24-2 Employee Class
• 24-3 Employee Object-Relational Data Model
• 24-4 Creating an Object-Relational Descriptor in Java
• 24-5 Creating an EIS Descriptor in Java
• 24-6 Creating an XML Descriptor in Java
• 25-1 Creating a Named Query with an Amendment Method
• 25-2 Configuring Remote Refreshing
• 25-3 Defining a Query Key
• 25-4 Defining a One-to-Many Query Key
• 25-5 Defining a Many-to-Many Query Key
• 25-6 Defining a One-to-One Query Key with an Amendment Method
• 25-7 Defining Interface Query Keys
• 25-8 Configuring Existence Checking Using Java
• 25-9 Configuring Reading Subclasses on Queries
• 25-10 Configuring an Inheritance Child Descriptor
• 25-11 Configuring Inheritance for a Relational Root Class
• 25-12 Configuring Inheritance for an EIS Root Class
• 25-13 Configuring Only-Instances Expressions
• 25-14 Configuring Only-Instances and With-All-Subclasses Expressions
• 25-15 Domain Object Method as a Descriptor Event Handler
• 25-16 Registering a Domain Object Method as a Descriptor Event Handler
• 25-17 DescriptorEventListener
• 25-18 Registering a DescriptorEventListener with the DescriptorEventManager
• 25-19 Setting the ObjectChangeTrackingPolicy
• 25-20 Implementing the ChangeTracker Interface for the ObjectChangeTrackingPolicy
• 25-21 Setting the DeferredChangeDetectionPolicy
• 25-22 Implementing the ChangeTracker Interface for the AttributeChangeTrackingPolicy
• 25-23 HistoryPolicy for One Table
• 25-24 HistoryPolicy for Multiple Tables
• 25-25 Configuring a BMP Wrapper Policy
• 25-26 Configuring a Fetch Group
• 26-1 Example Sequences
• 26-2 Associating a Sequence with a Descriptor
• 26-3 Configuring a Sequence for Multiple Descriptors
• 26-4 Configuring a Default Sequence
• 26-5 Configuring a Descriptor Query Manager with Custom SQL Strings
• 26-6 Configuring a Descriptor Query Manager with Custom Stored Procedure Calls
• 26-7 Configuring an Interface Alias
• 27-1 Field Ordering
• 28-1 Configuring EISDescriptor Record Format
• 28-2 Creating an XML Interaction for an AQ Platform
• 29-1 Configuring Schema Context
• 29-2 Schema Using xsd:anyType
• 30-1 jaxb:class Customization of an all Structure
• 30-2 jaxb:class Customization of a group Structure
• 30-3 jaxb:class Customization of a sequence Structure Containing a group
• 30-4 jaxb:class Customization of a group Structure Containing a sequence
• 30-5 jaxb:class Customization of a group Structure Containing a group
• 30-6 XML Schema With Unsupported Sequence Element Order
• 30-7 XML Schema With Supported Sequence Element Order
• 30-8 Schema Fragment with Typesafe Enumeration Declaration
• 31-1 Mapping a BLOB with a Direct-To-Field Mapping
• 31-2 Configuring Parameter Bindings in TopLink Workbench
• 31-3 Configuring Parameter Bindings in Java Code
• 31-4 Configuring String Binding in TopLink Workbench
• 31-5 Configuring String Binding in Java Code
• 31-6 Mapping a BLOB in TopLink Workbench
• 31-7 Mapping a BLOB in Java Code
• 32-1 Configuring Read Only Mappings in Java
• 32-2 Class Using ValueHolder Indirection
• 32-3 Mapping Using ValueHolder Indirection
• 32-4 Class Using ValueHolder Indirection with Method Accessing
• 32-5 Mapping Using ValueHolder Indirection with Method Accessing
• 32-6 Class Using IndirectContainer Indirection
• 32-7 Mapping Using IndirectContainer Indirection
• 32-8 Proxy indirection Examples
• 32-9 Configuring Access Method in Java
• 32-10 Configuring Access Method in Java
• 32-11 Configuring a SerializedObjectConverter in Java
• 32-12 Configuring a TypeConversionConverter in Java
• 32-13 Configuring an ObjectTypeConverter in Java
• 32-14 Creating a Type Translation XML Mapping
• 32-15 Creating a JAXB Typesafe Enumeration XML Mapping
• 32-16 Object Array Mapping
• 32-17 Using XMLField Method setUsesSingleNode
• 33-1 Direct-to-Field Mapping Example
• 34-1 Query Optimization Using Batching
• 38-1 Defining a variable one-to-one mapping using a unique primary key
• 47-1 Configuring Reference Class in Java
• 47-2 Configuring Attribute Name in Java
• 47-3 Configuring Field Name in Java
• 47-4 Configuring Structure Name in Java
• 53-1 XML Schema for EIS One-to-One Mapping with Key on Source
• 53-2 EIS One-to-One Mapping with Key On Source
• 53-3 XML Schema for EIS One-to-One Mapping with Key on Target
• 53-4 EIS One-to-One Mapping with Key on Target
• 53-5 XML Schema for EIS One-to-Many Mapping with Key on Source
• 53-6 EIS One-to-Many Mapping with Key on Source
• 53-7 XML Schema for EIS One-to-Many Mapping with Key on Target
• 53-8 EIS One-to-Many Mapping with Key on Target
• 60-1 Source Object XML Record without Grouping
• 60-2 Source Object XML Record with Grouping
• 62-1 XML Document
• 62-2 Schema for XML Direct Mapping to Simple Text Node
• 62-3 Java for XML Direct Mapping to Simple Text Node
• 62-4 Schema for XML Direct Mapping to a Text Node in a Simple Sequence
• 62-5 Java for XML Direct Mapping to a Text Node in a Simple Sequence
• 62-6 Schema for XML Direct Mapping to a Text Node in a Subelement
• 62-7 Java for XML Direct Mapping to a Text Node in a Subelement
• 62-8 Schema for XML Direct Mapping to Text Node by Position
• 62-9 Java for XML Direct Mapping to Text Node by Position
• 62-10 Schema for XML Direct Mapping to an Attribute
• 62-11 Java for XML Direct Mapping to an Attribute
• 62-12 Schema for XML Direct Mapping to a Specified Schema Type
• 62-13 Java for XML Direct Mapping to a Specified Schema Type
• 62-14 Schema for XML Direct Mapping to a List Field
• 62-15 Java for XML Direct Mapping to a List Field Node
• 62-16 Schema for XML Direct Mapping to a Union Field
• 62-17 Java for XML Direct Mapping to a Union Type
• 62-18 Schema for XML Direct Mapping to Union of Lists
• 62-19 Java for XML Direct Mapping to Union of Lists
• 62-20 Schema for XML Direct Mapping to a Union of Unions
• 62-21 Java for XML Direct Mapping to a Union of Unions
• 62-22 Schema for XML Direct Mapping with Simple Type Translator
• 62-23 Java for XML Direct Mapping with Simple Type Translator
• 62-24 Schema for Composite Direct Collection XML Mapping to a Simple Sequence
• 62-25 Java for Composite Direct Collection XML Mapping to a Simple Sequence
• 62-26 Schema for Composite Direct Collection XML Mapping to a Subelement Sequence
• 62-27 Java for Composite Direct Collection XML Mapping to a Subelement Sequence
• 62-28 Schema for Composite Direct Collection XML Mapping to Multiple Attributes
• 62-29 Java for Composite Direct Collection XML Mapping to Multiple Attributes
• 62-30 Schema for XML Composite Direct Collection Mapping to a Single Text Node
• 62-31 Java for XML Composite Direct Collection Mapping to a Single Text Node
• 62-32 Schema for XML Composite Direct Collection Mapping to a Single Attribute
• 62-33 Java for XML Composite Direct Collection Mapping to a Single Attribute
• 62-34 Schema for XML Composite Direct Collection Mapping to List of Unions
• 62-35 Java for XML Composite Direct Collection Mapping to List of Unions
• 62-36 Schema for XML Composite Direct Collection Mapping to a Union of Lists
• 62-37 Java for XML Composite Direct Collection Mapping to a Union of Lists
• 62-38 Schema for XML Composite Direct Collection Mapping with Specified Content Type
• 62-39 Java for XML Composite Direct Collection Mapping with Specified Content Type
• 62-40 Schema for XML Composite Object Mapping into the Parent Record
• 62-41 Java for XML Composite Object Mapping into the Parent Record
• 62-42 Schema for XML Composite Object Mapping to an Element
• 62-43 Java for XML Composite Object Mapping to an Element
• 62-44 Schema for XML Composite Object Mapping to Elements by Name
• 62-45 Java for XML Composite Object Mapping to Elements by Name
• 62-46 Schema for XML Composite Object Mapping to Elements by Position
• 62-47 Java for XML Composite Object Mapping to Elements by Position
• 62-48 Schema for XML Composite Collection Mapping
• 62-49 Java for XML Composite Collection Mapping for a Collection Attribute
• 62-50 Java for XML Composite Collection Mapping for a Map Attribute
• 62-51 Schema for XML Any Object Mapping
• 62-52 Java for XML Any Object Mapping
• 62-53 Schema for XML Any Collection Mapping
• 62-54 Java for XML Any Collection Mapping
• 72-1 Sample TopLink Log Message
• 72-2 Sample java.util.logging Log Messages
• 72-3 Configuring the Log Destination
• 72-4 Default TOPLINK.xml File
• 72-5 Using Mapping setSessionName in a Descriptor Amendment Method
• 72-6 Session Interface Inheritance Hierarchy
• 73-1 Creating a Server Session from a Project Class
• 73-2 Creating a Server Session from a project.xml File Project
• 73-3 Creating a Server Session with Custom Write Connection Pool Size
• 73-4 Creating a Session Broker
• 73-5 Creating a Database Session from a Project Class
• 73-6 Creating a Database Session from a project.xml File Project
• 73-7 Server Creating RMIRemoteSessionController for Client
• 73-8 Client Acquiring RMIRemoteSessionController from Server
• 74-1 Configuring a Session to Use java.util.logging
• 74-2 Configuring a Session to Use Application Server Logging
• 74-3 Configuring a Session to Log to a java.io.Writer
• 74-4 java.util.logging Configuration in logging.properties
• 74-5 Configuring a Session with a TopLink Profiler
• 74-6 Implementing an Exception Handler
• 74-7 Configuring a Session with a Server Platform
• 74-8 Using the Session Event Adapter to Create a Session Event Listener
• 74-9 Configuring the Integrity Checker
• 75-1 Acquiring a Session Manager Instance
• 75-2 Acquiring a Named Session from Session Manager Using Defaults
• 75-3 Loading a Session Using the Current Thread Context Class Loader
• 75-4 Loading a Session Using the Current Class's Class Loader
• 75-5 Loading a Session from an Alternative Configuration File
• 75-6 Open Session with No Login
• 75-7 Forcing a Reparse of the sessions.xml File
• 75-8 Forcing a Reparse of the sessions.xml File
• 75-9 Acquiring a Client Session that Uses Connection Properties
• 75-10 Acquiring an Isolated Session Using Connection Properties
• 75-11 Acquiring a Client Session that Uses a Named Connection Pool
• 75-12 Acquiring a Client Session that Does Not Use Lazy Connections
• 75-13 Storing Sessions Manually in the Session Manager
• 75-14 Destroying a Session in the Session Manager
• 75-15 Destroying All Sessions in the Session Manager
• 77-1 Session Event Listener for an Isolated Session
• 77-2 Session Event Listener for an Isolated Session
• 81-1 TopLink Logs with Oracle Database Proxy Authentication
• 81-2 Login Inheritance Hierarchy
• 81-3 Platform Inheritance Hierarchy
• 83-1 Accessing the Platform Default Sequence
• 83-2 Using the DefaultSequence Class
• 83-3 Overriding the Platform Default Sequence
• 83-4 Configuring Multiple Sequences Explicitly
• 83-5 Configuring Multiple Sequences Using the Default Sequence Type
• 83-6 Using a Stored Procedure for both Sequence Update and Select
• 83-7 Using a Stored Procedure for Sequence Updates Only
• 83-8 Using a Stored Procedure for Sequence Selects Only
• 83-9 Using the QuerySequence Class
• 83-10 Parameterized SQL and Binding at the Login Level
• 83-11 Using JDBC Batch Writing
• 87-1 Object Identity Descriptor API
• 87-2 Cache Refresh Descriptor API
• 87-3 Cache Coordination Session API
• 87-4 Cache Coordination Descriptor API
• 93-1 Disabling the Identity Map Cache Update
• 93-2 Refreshing the Result of a Query in the Identity Map Cache During a Read Query
• 93-3 Using the cascadePrivateParts Method
• 93-4 Query and Expression Packages
• 94-1 readObject Using an Expression
• 94-2 readAllObjects Using an Expression
• 94-3 Writing a Single Object Using writeObject
• 94-4 Writing Several Objects Using writeAllObjects
• 94-5 A Simple ReadAllQuery
• 94-6 A Named Read Query with Two Arguments
• 94-7 Optimization Through Partial Object Reading
• 94-8 Querying Reporting Information on Employees
• 94-9 Using Query-by-Example to Query an Employee
• 94-10 Using Query-by-Example to Query an Employee's Address
• 94-11 Query-by-Example Policy Using like Operator
• 94-12 Query-by-Example Policy Using Keywords
• 94-13 Combining Query-by-Example with Expressions
• 94-14 A Query with Simple Ordering
• 94-15 A Query with Complex Ordering
• 94-16 Specifying the Collection Class for a Collection
• 94-17 Specifying the Collection Class for a Map
• 94-18 Setting the Maximum Returned Object Size
• 94-19 DatabaseQuery Timeout
• 94-20 Join Reading Multiple Attributes
• 94-21 SQL for Multiple Attribute Join Reading
• 94-22 Join Reading a Single Attribute
• 94-23 Using a WriteObjectQuery
• 94-24 Using InsertObjectQuery, UpdateObjectQuery, and DeleteObjectQuery
• 94-25 Using UpdateAllQuery
• 94-26 Performing a Noncascading Write Query
• 94-27 Disabling the Identity Map Cache During a Write Query
• 94-28 Using a DataReadQuery
• 94-29 Using a DirectReadQuery
• 94-30 Using a ValueReadQuery
• 94-31 Using a DataModifyQuery
• 94-32 A Direct Read Query with SQL
• 94-33 A Data Modify Query with SQL
• 94-34 EJB QL
• 94-35 A Simple ReadAllQuery Using EJB QL and Passing Arguments
• 94-36 A Simple ReadObjectQuery with Parameterized SQL
• 94-37 Executing a Session-Level Named Query
• 94-38 Executing a Descriptor Level Named Query
• 94-39 Session Read Query With Custom SQL
• 94-40 Specifying an SQLCall with an Input Parameter Using the # Prefix
• 94-41 Executing an SQLCall with an Input Parameter
• 94-42 Specifying a SQLCall with an Output Parameter Using the ### Prefix
• 94-43 Executing a SQLCall with an Output Parameter
• 94-44 Specifying an Input and Output Parameter Using the #### Prefix
• 94-45 Executing a SQLCall with an Input and Output Parameter
• 94-46 A Read-All Query with a Stored Procedure
• 94-47 Stored Procedure Call with an Input Parameter
• 94-48 Stored Procedure Call with an Output Parameter
• 94-49 Stored Procedure Call with an Input/Output Parameter
• 94-50 Stored Procedure with Reset Set and Output Parameter Error Code
• 94-51 Creating a StoredFunctionCall
• 94-52 Session Read Query With Custom EJB QL
• 95-1 Using the Expression Class
• 95-2 Using the ExpressionMath Class
• 95-3 Using Boolean Logic in an Expression
• 95-4 Using a Database Function Supported by the Expression API
• 95-5 Using an Ordering Database Function
• 95-6 Using Mathematical Functions in an Expression
• 95-7 Using the XMLType Extract Operator
• 95-8 Using a Database Function Not Supported by the Expression API
• 95-9 Using an Expression with a One-to-One Relationship
• 95-10 Using an Expression with a One-to-Many Relationship
• 95-11 Using an Expression with a Many-to-Many Relationship
• 95-12 Using a Parameterized Expression in a Custom Query
• 95-13 Using Nested Parameterized Expressions
• 95-14 Using a Parameterized Expression in a Mapping
• 95-15 Using Expression Method getParameter
• 95-16 Using an Automatically Generated Query Key in an Expression
• 95-17 Using a One-to-One Query Key in an Expression
• 95-18 A Subquery Expression Using a Comparison and Count Operation
• 95-19 A Subquery Expression Using a Comparison and Max Operation
• 95-20 A Subquery Expression Using a Not Exists Operation
• 95-21 A Parallel Expression on Two Independent Employees
• 95-22 Using getField with an Object
• 95-23 Using getTable and getField Together
• 95-24 Using a Data Query Against a Link Table
• 95-25 Sample Expression
• 95-26 Using ExpressionBuilder to Build a Simple Expression
• 95-27 Combining Two Expressions with a Logical AND Operator
• 95-28 Using Database Function notLike in an Expression
• 95-29 Adding a toUpper Function for All Platforms
• 95-30 Accessing a User-Defined Function
• 96-1 Redirect Query
• 96-2 Using a Historical Session
• 96-3 Configuring Default Fetch Group Behavior
• 96-4 Configuring a Query with a FetchGroup Using the FetchGroupManager
• 96-5 Configuring a Query with a FetchGroup Dynamically
• 96-6 Registering a Query That Includes a Join Expression
• 96-7 Creating DirectQueryKeys
• 96-8 Hierarchical Query
• 96-9 A Simple Finder Within the ejb-jar.xml File
• 96-10 A ReadAllQuery Finder
• 96-11 Executing a Primary Key Finder
• 96-12 A Simple Redirect Query Implementation
• 96-13 Traversing with a Scrollable Cursor
• 96-14 Cursored Streams
• 96-15 Using a Vector
• 96-16 Cursored Stream in a Finder
• 96-17 Cursored Finder
• 96-18 Configuring a ReadQuery to Cache Its Query Results
• 96-19 Configuring a ReadQuery to Stop Caching Its Query Results
• 96-20 Configuring a CacheInvalidationPolicy on a ReadQuery for the Query's Internal Cache
• 97-1 Unit of Work Life Cycle
• 98-1 Creating an Object: Preferred Method
• 98-2 Creating an Object: Alternative Method
• 98-3 Modifying an Object
• 98-4 Modifying an Object: Skipping the Registration Step
• 98-5 Associating Without Reference to the Cache Object
• 98-6 Associating With Reference to the Cache Object
• 98-7 Resolving Issues When Adding New Objects
• 98-8 Associating a New Source to an Existing Target Object
• 98-9 Associating an Existing Source to Existing Target Object
• 98-10 Associating Existing Objects
• 98-11 Specifying a Mapping as Privately Owned
• 98-12 Privately Owned Relationships
• 98-13 Explicitly Deleting
• 99-1 Creating and Registering an Object in One Step
• 99-2 Registering a New Object with the registerNewObject Method
• 99-3 Associating New Objects with the registerNewObject Method
• 99-4 Associating New Objects with the newObjectMethod and Retaining a Handle to the Cache Objects
• 99-5 Using registerAllObjects
• 99-6 Using Conforming Queries
• 99-7 Using Unit of Work Method writeChanges
• 99-8 Merging a Serialized Object
• 99-9 Using the commitAndResume Method
• 99-10 Using Nested Units of Work
• 99-11 Using the executeNonSelectingCall Method
• 99-12 Optimistic Read Lock with No Version Increment
• 99-13 Optimistic Read Lock with Version Increment: Service Thread
• 99-14 Optimistic Read Lock with Version Increment: Invoice Thread
• 99-15 Using a Unit of Work With an External Transaction Service
• 99-16 Incorrect Use of Handle to Clone
• 99-17 Testing If an Object Is the Cache Object
• 99-18 Dumping the Contents of a Unit of Work
• 99-19 Handling Unit of Work Commit Exceptions
• 99-20 Querying Across Two Levels of Relationship