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:

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")

 Unsupported Unsupported Supported

Reference descriptor (see Section 28.4, "Configuring Reference Descriptor")

 Unsupported Unsupported Supported

Container policy (see Section 121.14, "Configuring Container Policy")

 Unsupported Unsupported Supported

Method or direct field access (see Section 121.6, "Configuring Method or Direct Field Accessing at the Mapping Level")

 Unsupported Unsupported Supported

Read-only mapping (see Section 121.2, "Configuring Read-Only Mappings")

 Unsupported Unsupported Supported

Batch reading (see Section 28.5, "Configuring Batch Reading")

 Unsupported Unsupported Supported

Bidirectional relationship (see Section 121.18, "Configuring Bidirectional Relationship")

 Unsupported Unsupported Supported

Query key order (see Section 28.6, "Configuring Query Key Order")

 Unsupported Unsupported Supported

Table and field references (see Section 28.7, "Configuring Table and Field References (Foreign and Target Foreign Keys)")

 Unsupported Unsupported Supported

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: