Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Configuring a Relational One-to-Many Mapping (ELUG)"

m (Introduction to Relational One-to-Many Mapping Configuration)
m
Line 8: Line 8:
 
For information on how to create EclipseLink mappings, see [[Creating%20a%20Mapping%20(ELUG)|Creating a Mapping]].
 
For information on how to create EclipseLink mappings, see [[Creating%20a%20Mapping%20(ELUG)|Creating a Mapping]].
  
[[#Table 38-1|Configurable Options for Relational One-to-Many Mapping]] lists the configurable options for a relational one-to-many mapping.
 
 
 
 
==Introduction to Relational One-to-Many Mapping Configuration==
 
  
 
This table lists the configurable options for a relational one-to-many mapping.
 
This table lists the configurable options for a relational one-to-many mapping.
Line 20: Line 15:
 
''''' Configurable Options for Relational One-to-Many Mapping'''''
 
''''' Configurable Options for Relational One-to-Many Mapping'''''
  
{| class="RuleFormalMax" dir="ltr" title="Configurable Options for Relational One-to-Many Mapping" summary="This table lists the configurable options common to Relational One-to-Many 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 One-to-Many Mapping" summary="This table lists the configurable options common to Relational One-to-Many 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"
 
|- align="left" valign="top"
 
! id="r1c1-t2" align="left" valign="bottom" | '''Option'''
 
! id="r1c1-t2" align="left" valign="bottom" | '''Option'''
Line 27: Line 22:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r2c1-t2" headers="r1c1-t2" align="left" |
 
| id="r2c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Relational%20Mapping%20(ELUG)|Configuring Reference Descriptor]]
+
[[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring Reference Descriptor|Configuring Reference Descriptor]]
 
| headers="r2c1-t2 r1c2-t2" align="left" |
 
| headers="r2c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 34: Line 29:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r3c1-t2" headers="r1c1-t2" align="left" |
 
| id="r3c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Mapping%20(ELUG)|Configuring a Type Conversion Converter]]
+
[[Configuring%20a%20Mapping%20(ELUG)#Configuring a Type Conversion Converter|Configuring a Type Conversion Converter]]
 
| headers="r3c1-t2 r1c2-t2" align="left" |
 
| headers="r3c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 41: Line 36:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r4c1-t2" headers="r1c1-t2" align="left" |
 
| id="r4c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Mapping%20(ELUG)|Configuring Read-Only Mappings]]
+
[[Configuring%20a%20Mapping%20(ELUG)#Configuring Read-Only Mappings|Configuring Read-Only Mappings]]
 
| headers="r4c1-t2 r1c2-t2" align="left" |
 
| headers="r4c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 48: Line 43:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r5c1-t2" headers="r1c1-t2" align="left" |
 
| id="r5c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Mapping%20(ELUG)|Configuring Mapping Comments]]
+
[[Configuring%20a%20Mapping%20(ELUG)#Configuring Mapping Comments|Configuring Mapping Comments]]
 
| headers="r5c1-t2 r1c2-t2" align="left" |
 
| headers="r5c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 55: Line 50:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r6c1-t2" headers="r1c1-t2" align="left" |
 
| id="r6c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Relational%20Mapping%20(ELUG)|Configuring Batch Reading]]
+
[[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring Batch Reading|Configuring Batch Reading]]
 
| headers="r6c1-t2 r1c2-t2" align="left" |
 
| headers="r6c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 62: Line 57:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r7c1-t2" headers="r1c1-t2" align="left" |
 
| id="r7c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Mapping%20(ELUG)|Configuring Mapping Comments]]
+
[[Configuring%20a%20Mapping%20(ELUG)#Configuring Mapping Comments|Configuring Mapping Comments]]
 
| headers="r7c1-t2 r1c2-t2" align="left" |
 
| headers="r7c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 69: Line 64:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r8c1-t2" headers="r1c1-t2" align="left" |
 
| id="r8c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Mapping%20(ELUG)|Configuring Bidirectional Relationship]]
+
[[Configuring%20a%20Mapping%20(ELUG)#Configuring Bidirectional Relationship|Configuring Bidirectional Relationship]]
 
| headers="r8c1-t2 r1c2-t2" align="left" |
 
| headers="r8c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 76: Line 71:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r9c1-t2" headers="r1c1-t2" align="left" |
 
| id="r9c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Mapping%20(ELUG)|Configuring Container Policy]]
+
[[Configuring%20a%20Mapping%20(ELUG)#Configuring Container Policy|Configuring Container Policy]]
 
| headers="r9c1-t2 r1c2-t2" align="left" |
 
| headers="r9c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 83: Line 78:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r10c1-t2" headers="r1c1-t2" align="left" |
 
| id="r10c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Mapping%20(ELUG)|Configuring Mapping Comments]]
+
[[Configuring%20a%20Mapping%20(ELUG)#Configuring Mapping Comments|Configuring Mapping Comments]]
 
| headers="r10c1-t2 r1c2-t2" align="left" |
 
| headers="r10c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 90: Line 85:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r11c1-t2" headers="r1c1-t2" align="left" |
 
| id="r11c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Relational%20Mapping%20(ELUG)|Configuring Joining at the Mapping Level]]
+
[[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring Joining at the Mapping Level|Configuring Joining at the Mapping Level]]
 
| headers="r11c1-t2 r1c2-t2" align="left" |
 
| headers="r11c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 97: Line 92:
 
|- align="left" valign="top"
 
|- align="left" valign="top"
 
| id="r12c1-t2" headers="r1c1-t2" align="left" |
 
| id="r12c1-t2" headers="r1c1-t2" align="left" |
[[Configuring%20a%20Relational%20Mapping%20(ELUG)|Configuring Query Key Order]]
+
[[Configuring%20a%20Relational%20Mapping%20(ELUG)#Configuring Query Key Order|Configuring Query Key Order]]
 
| headers="r12c1-t2 r1c2-t2" align="left" |
 
| headers="r12c1-t2 r1c2-t2" align="left" |
 
[[Image:support.gif|Supported]]
 
[[Image:support.gif|Supported]]
Line 123: Line 118:
  
 
For more information, see the following:
 
For more information, see the following:
 
+
* [[Introduction%20to%20Relational%20Mappings%20(ELUG)#One-to-Many Mapping|One-to-Many Mapping]]
* [[Introduction%20to%20Relational%20Mappings%20(ELUG)|One-to-Many Mapping]]
+
 
* [[Configuring%20a%20Relational%20Mapping%20(ELUG)|Configuring a Relational Mapping]]
 
* [[Configuring%20a%20Relational%20Mapping%20(ELUG)|Configuring a Relational Mapping]]
 
* [[Creating%20and%20Configuring%20Mappings%20(ELUG)|Creating and Configuring Mappings]]
 
* [[Creating%20and%20Configuring%20Mappings%20(ELUG)|Creating and Configuring Mappings]]
  
  
For information on using JPA to configure one-to-many mappings, see [[Introduction%20to%20EclipseLink%20JPA%20(ELUG)|@OneToMany]].
+
For information on using JPA to configure one-to-many mappings, see [[Introduction%20to%20EclipseLink%20JPA%20(ELUG)#@OneToMany|@OneToMany]].
  
  
Line 140: Line 134:
 
[[Category: Draft]]
 
[[Category: Draft]]
 
[[Category: Task]]
 
[[Category: Task]]
 +
[[Category: ORM]]

Revision as of 16:32, 14 December 2007

This section describes the various components that you must configure in order to use a relational one-to-many mapping.

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 one-to-many mapping.


Configurable Options for Relational One-to-Many Mapping

Option Workbench Java

Configuring Reference Descriptor

Supported

Supported

Configuring a Type Conversion Converter

Supported

Supported

Configuring Read-Only Mappings

Supported

Supported

Configuring Mapping Comments

Supported

Supported

Configuring Batch Reading

Supported

Supported

Configuring Mapping Comments

Supported

Supported

Configuring Bidirectional Relationship

Supported

Supported

Configuring Container Policy

Supported

Supported

Configuring Mapping Comments

Supported

Supported

Configuring Joining at the Mapping Level

Supported

Supported

Configuring Query Key Order

Supported

Supported


This example shows how to create a one-to-many mapping and add it to a descriptor using Java code.

One-to-Many Mapping

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

    // configure mapping
    ... 

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

For more information, see the following:


For information on using JPA to configure one-to-many mappings, see @OneToMany.



Copyright Statement

Back to the top