Difference between revisions of "Configuring a Relational Aggregate Collection Mapping (ELUG)"

Revision as of 08:15, 17 December 2007

This section 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 Workbench, you must use an amendment method.

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

For information on how to create EclipseLink mappings, see Creating a Mapping.

This table lists the configurable options for a relational aggregate collection mapping.

Option	Workbench	Java
Database field
Reference descriptor
Container policy
Method or direct field access
Read-only mapping
Batch reading
Bidirectional relationship
Query key order
Configuring Configuring Table and Field References

This example shows how to create a aggregate collection mapping and add it to a descriptor using Java code.

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:

Copyright Statement

@@ Line 2: / Line 2: @@
 [[Special:Whatlinkshere/Configuring a Relational Aggregate Collection Mapping (ELUG)|Related Topics]]</div>
 This section describes the various components that you must configure in order to use a relational aggregate collection mapping.
 {| class="Note oac_no_warn" width="80%" border="1" frame="hsides" rules="groups" cellpadding="3" frame="hsides" rules="groups"
 | align="left" |
-'''Note'''<nowiki>:</nowiki> To use a relational aggregate collection mapping with Workbench, you must use an amendment method (see [[Configuring%20a%20Descriptor%20(ELUG)#Configuring Amendment Methods|Configuring Amendment Methods]]).
+'''Note'''<nowiki>:</nowiki> To use a relational aggregate collection mapping with Workbench, you must use [[Configuring%20a%20Descriptor%20(ELUG)#Configuring Amendment Methods|an amendment method]].
 |}
@@ Line 15: / Line 12: @@
 For information on how to create EclipseLink mappings, see [[Creating%20a%20Mapping%20(ELUG)|Creating a Mapping]].
-[[#Table 40-1|Configurable Options for Relational Aggregate Collection Mapping]] lists the configurable options for a relational aggregate collection mapping.
-==Introduction to Relational Aggregate Collection Mapping Configuration==
 This table lists the configurable options for a relational aggregate collection mapping.
 <span id="Table 40-1"></span>
-''''' Configurable Options for Relational Aggregate Collection Mapping'''''
-{| class="RuleFormalMax" dir="ltr" title="Configurable Options for Relational Aggregate Collection Mapping" summary="This table lists the configurable options common to Relational Aggregate Collection Mapping and categorizes them as Basic and Advanced and indicates if the option can be configured with the TopLink Workbench, Java, or both." width="100%" border="1" frame="border" rules="all" cellpadding="3" frame="border" rules="all"
+{| class="RuleFormalMax" dir="ltr" title="Configurable Options for Relational Aggregate Collection Mapping" summary="This table lists the configurable options common to Relational Aggregate Collection Mapping and categorizes them as Basic and Advanced and indicates if the option can be configured with the Workbench, Java, or both." width="100%" border="1" frame="border" rules="all" cellpadding="3" frame="border" rules="all"
 |- align="left" valign="top"
 ! id="r1c1-t3" align="left" valign="bottom" | '''Option'''
@@ Line 35: / Line 24: @@
 |- align="left" valign="top"
 | id="r2c1-t3" headers="r1c1-t3" align="left" |
-Database field (see [[Configuring%20a%20Relational%20Mapping%20(ELUG)|Configuring a Database Field]])
+[[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring a Database Field|Database field ]]
 | headers="r2c1-t3 r1c2-t3" align="left" |
 [[Image:unsupport.gif|Unsupported]]
@@ Line 42: / Line 31: @@
 |- align="left" valign="top"
 | id="r3c1-t3" headers="r1c1-t3" align="left" |
-Reference descriptor (see [[Configuring%20a%20Relational%20Mapping%20(ELUG)|Configuring Reference Descriptor]])
+[[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring Reference Descriptor|Reference descriptor ]]
 | headers="r3c1-t3 r1c2-t3" align="left" |
 [[Image:unsupport.gif|Unsupported]]
@@ Line 49: / Line 38: @@
 |- align="left" valign="top"
 | id="r4c1-t3" headers="r1c1-t3" align="left" |
-Container policy (see [[Configuring%20a%20Mapping%20(ELUG)|Configuring Mapping Comments]])
+[[Configuring%20a%20Mapping%20(ELUG)#Configuring Container Policy|Container policy ]]
 | headers="r4c1-t3 r1c2-t3" align="left" |
 [[Image:unsupport.gif|Unsupported]]
@@ Line 56: / Line 45: @@
 |- align="left" valign="top"
 | id="r5c1-t3" headers="r1c1-t3" align="left" |
-Method or direct field access (see [[Configuring%20a%20Mapping%20(ELUG)|Configuring a Type Conversion Converter]])
+[[Configuring%20a%20Mapping%20(ELUG)#Configuring Method or Direct Field Accessing at the Mapping Level|Method or direct field access ]]
 | headers="r5c1-t3 r1c2-t3" align="left" |
 [[Image:unsupport.gif|Unsupported]]
@@ Line 63: / Line 52: @@
 |- align="left" valign="top"
 | id="r6c1-t3" headers="r1c1-t3" align="left" |
-Read-only mapping (see [[Configuring%20a%20Mapping%20(ELUG)|Configuring Read-Only Mappings]])
+[[Configuring%20a%20Mapping%20(ELUG)#Configuring Read-Only Mappings|Read-only mapping ]]
 | headers="r6c1-t3 r1c2-t3" align="left" |
 [[Image:unsupport.gif|Unsupported]]
@@ Line 70: / Line 59: @@
 |- align="left" valign="top"
 | id="r7c1-t3" headers="r1c1-t3" align="left" |
-Batch reading (see [[Configuring%20a%20Relational%20Mapping%20(ELUG)|Configuring Batch Reading]])
+[[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring Batch Reading|Batch reading ]]
 | headers="r7c1-t3 r1c2-t3" align="left" |
 [[Image:unsupport.gif|Unsupported]]
@@ Line 77: / Line 66: @@
 |- align="left" valign="top"
 | id="r8c1-t3" headers="r1c1-t3" align="left" |
-Bidirectional relationship (see [[Configuring%20a%20Mapping%20(ELUG)|Configuring Bidirectional Relationship]])
+[[Configuring%20a%20Mapping%20(ELUG)#Configuring Bidirectional Relationship|Bidirectional relationship ]]
 | headers="r8c1-t3 r1c2-t3" align="left" |
 [[Image:unsupport.gif|Unsupported]]
@@ Line 84: / Line 73: @@
 |- align="left" valign="top"
 | id="r9c1-t3" headers="r1c1-t3" align="left" |
-Query key order (see [[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring Query Key Order|Configuring Query Key Order]])
+[[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring Query Key Order|Query key order ]]
 | headers="r9c1-t3 r1c2-t3" align="left" |
 [[Image:unsupport.gif|Unsupported]]
@@ Line 91: / Line 80: @@
 |- align="left" valign="top"
 | id="r10c1-t3" headers="r1c1-t3" align="left" |
-Table and field references (see [[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring Table and Field References (Foreign and Target Foreign Keys)|Configuring Configuring Table and Field References]]
+[[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring Table and Field References (Foreign and Target Foreign Keys)|Configuring Configuring Table and Field References]]
 | headers="r10c1-t3 r1c2-t3" align="left" |
 [[Image:unsupport.gif|Unsupported]]
@@ Line 116: / Line 105: @@
 </pre>
-For more information, see the following:
+For more information, see the following:
 * [[Introduction%20to%20Relational%20Mappings%20(ELUG)#Aggregate Collection Mapping|Aggregate Collection Mapping]]
 * [[Configuring%20a%20Relational%20Mapping%20(ELUG)|Configuring a Relational Mapping]]
@@ Line 129: / Line 118: @@
 [[Category: Draft]]
 [[Category: Task]]
+[[Category: ORM]]

Breadcrumbs

Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Difference between revisions of "Configuring a Relational Aggregate Collection Mapping (ELUG)"

Revision as of 08:15, 17 December 2007