Jump to: navigation, search

Difference between revisions of "EclipseLink/UserGuide/MOXy/Relationships/Privately Owned/One-to-Many"

m
m (Replacing page with 'See http://www.eclipse.org/eclipselink/documentation/2.4/moxy/privately_owned_relationships002.htm')
 
(30 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{EclipseLink_UserGuide
+
See http://www.eclipse.org/eclipselink/documentation/2.4/moxy/privately_owned_relationships002.htm
|info=y
+
|exampes=y
+
|example=* [[EclipseLink/Examples/MOXy/JPA/Relationships#One_To_Many|One-to-many]]
+
}}
+
 
+
 
+
= One-to-Many Composite Collection Mapping =
+
 
+
Use XML composite collection mappings to represent one-to-many relationships. Composite collection XML mappings can reference any class that has an EclipseLink descriptor. The attribute in the object mapped must implement either the Java <tt>Collection</tt> interface (for example, <tt>Vector</tt> or <tt>HashSet</tt>) or <tt>Map</tt> interface (for example, <tt>Hashtable</tt> or <tt>TreeMap</tt>). The <tt>CompositeCollectionMapping</tt> class allows a reference to the mapped class and the indexing type for that class.
+
 
+
Given the XML schema in this example, [[#Figure_58-27|XML Composite Collection Mapping]] illustrates an XML composite collection mapping to different elements by position in a corresponding XML document. [[#Example_58-49|Java for XML Composite Collection Mapping for a Collection Attribute]] shows how to configure this mapping in Java for a <tt>Collection</tt> attribute and [[#Example_58-50|Java for XML Composite Collection Mapping for a Map Attribute]] shows how to configure this mapping in Java for a <tt>Map</tt> attribute.
+
 
+
<br> <span id="Example_58-48">
+
''''' Schema for XML Composite Collection Mapping'''''
+
<source lang="xml">
+
<?xml version="1.0" encoding="UTF-8"?>
+
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
+
    <xsd:element name="customer" type="customer-type"/>
+
    <xsd:complexType name="customer-type">
+
        <xsd:sequence>
+
+
            <xsd:element name="first-name" type="xsd:string"/>
+
            <xsd:element name="last-name" type="xsd:string"/>
+
            <xsd:element name="phone-number">
+
                <xsd:complexType>
+
                    <xsd:sequence>
+
                        <xsd:element name="number" type="xsd:string"/>
+
+
                    </xsd:sequence>
+
                    <xsd:attribute name="type" type="xsd:string"/>
+
                </xsd:complexType>
+
            </xsd:element>
+
        </xsd:sequence>
+
    </xsd:complexType>
+
+
</xsd:schema>
+
</source></span>
+
 
+
<span id="Figure_58-27" /> '''''XML Composite Collection Mapping'''''
+
 
+
[[Image:Ccxm.gif|XML Composite Collection Mapping]]<br><br>
+
 
+
 
+
== With Java==
+
'''''Java for XML Composite Collection Mapping for a Collection Attribute''''' <source lang="java">
+
XMLCompositeCollectionMapping phoneNumbersMapping = new XMLCompositeCollectionMapping();
+
phoneNumbersMapping.setAttributeName("phoneNumbers");
+
phoneNumbersMapping.setXPath("phone-number");
+
phoneNumbersMapping.setReferenceClass(PhoneNumber.class);
+
</source>
+
 
+
'''''Java for XML Composite Collection Mapping for a Map Attribute''''' <source lang="java">
+
XMLCompositeCollectionMapping phoneNumbersMapping = new XMLCompositeCollectionMapping();
+
phoneNumbersMapping.setAttributeName("phoneNumbers");         
+
phoneNumbersMapping.setXPath("phone-number");
+
phoneNumbersMapping.setReferenceClass(PhoneNumber.class);
+
phoneNumbersMapping.useMapClass(HashMap.class, "getType");
+
</source>
+
 
+
== With EclipseLink Annotations ==
+
Use the '''@OneToMany''' annotation:
+
<source lang="java">
+
@Entity
+
public class Employee {
+
+
    @OneToMany(mappedBy="contact")
+
    private List<PhoneNumber> contactNumber;
+
+
}
+
</source>
+
 
+
Use the EclipseLink extension '''@XmlInverseReference''' to map the back-pointer:
+
<source lang="java">
+
@Entity
+
public class PhoneNumber {
+
+
    @ManyToOne
+
    @JoinColumn(name="E_ID", referencedColumnName = "E_ID")
+
    @XmlInverseReference(mappedBy="contactNumber")
+
    private Employee contact;
+
+
}
+
</source>
+
{{EclipseLink_MOXy
+
|version=2.2.0 DRAFT
+
|previous=[[EclipseLink/UserGuide/MOXy/Relationships/Privately_Owned/One-to-One|One-to-one]]
+
|next=[[EclipseLink/UserGuide/MOXy/Relationships/Shared_Reference|Shared references]]
+
|up=[[EclipseLink/UserGuide/MOXy/Relationships/Privately Owned|Privately owned]]
+
}}
+

Latest revision as of 09:22, 8 November 2012

See http://www.eclipse.org/eclipselink/documentation/2.4/moxy/privately_owned_relationships002.htm