35 Configuring a Relational Aggregate Collection Mapping

This chapter describes the various components that you must configure in order to use a relational aggregate collection mapping.

Note:

To use a relational aggregate collection mapping with TopLink Workbench, you must use an amendment method (see Section 119.35, "Configuring Amendment Methods").

This chapter includes the following section:

Introduction to Relational Aggregate Collection Mapping Configuration

For information on how to configure TopLink mappings options common to two or more mapping types, see Chapter 121, "Configuring a Mapping".

For information on how to create TopLink mappings, see Chapter 120, "Creating a Mapping".

Table 35-1 lists the configurable options for a relational aggregate collection mapping.

35.1 Introduction to Relational Aggregate Collection Mapping Configuration

Table 35-1 lists the configurable options for a relational aggregate collection mapping.

Table 35-1 Configurable Options for Relational Aggregate Collection Mapping

Option	Oracle JDeveloper	TopLink Workbench	Java
Database field (see Section 28.3, "Configuring a Database Field")
Reference descriptor (see Section 28.4, "Configuring Reference Descriptor")
Container policy (see Section 121.14, "Configuring Container Policy")
Method or direct field access (see Section 121.6, "Configuring Method or Direct Field Accessing at the Mapping Level")
Read-only mapping (see Section 121.2, "Configuring Read-Only Mappings")
Batch reading (see Section 28.5, "Configuring Batch Reading")
Bidirectional relationship (see Section 121.18, "Configuring Bidirectional Relationship")
Query key order (see Section 28.6, "Configuring Query Key Order")
Table and field references (see Section 28.7, "Configuring Table and Field References (Foreign and Target Foreign Keys)")

Example 35-1 shows how to create an aggregate collection mapping and add it to a descriptor using Java code.

Example 35-1 Aggregate Collection Mapping

public void customize(ClassDescriptor descriptor) { 
    AggregateCollectionMapping mapping = new AggregateCollectionMapping();  

    // configure mapping
    ...   

    // add mapping to descriptor
    descriptor.addMapping(mapping);
}

For more information, see the following: