|
|
(30 intermediate revisions by the same user not shown) |
Line 1: |
Line 1: |
− | {{EclipseLink_UserGuide
| + | Please see http://www.eclipse.org/eclipselink/documentation/2.4/moxy/simple_values001.htm |
− | |info=y
| + | |
− | |api=y
| + | |
− | |apis= * [http://www.eclipse.org/eclipselink/api/latest/javax/xml/bind/annotation/XmlAttribute.html XmlAttribute]
| + | |
− | * [http://www.eclipse.org/eclipselink/api/latest/javax/xml/bind/annotation/XmlElement.html XmlElement]
| + | |
− | * [http://www.eclipse.org/eclipselink/api/latest/javax/xml/bind/annotation/XmlValue.html XmlValue]
| + | |
− | |toc=y
| + | |
− | }}
| + | |
− | =Mapping Simple Values=
| + | |
− | XML direct mappings map a Java attribute directly to XML text nodes. The following section demonstrates several XML direct mapping scenarios.
| + | |
− | | + | |
− | | + | |
− | ==Mapping to an Attribute==
| + | |
− | Given the XML schema in this example, the figure below illustrates an XML direct mapping to an attribute in a corresponding XML document.
| + | |
− | | + | |
− | <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:attribute name="id" type="xsd:integer"/>
| + | |
− | </xsd:complexType>
| + | |
− | | + | |
− | </xsd:schema>
| + | |
− | </source>
| + | |
− | | + | |
− | [[Image:dxmatt.gif|XML Direct Mapping to an Attribute]]<br><br>
| + | |
− | | + | |
− | The following example shows how to annotate your Java class to obtain this mapping with EclipseLink. All that is needed is the standard JAXB <tt>@XmlAttribute</tt> annotation.
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | @XmlRootElement
| + | |
− | public class Customer {
| + | |
− | @XmlAttribute
| + | |
− | public Integer id;
| + | |
− | }
| + | |
− | </source>
| + | |
− | | + | |
− | The example below shows how to to define your mapping information in EclipseLink's OXM metadata format.
| + | |
− | | + | |
− | <source lang="xml">
| + | |
− | ...
| + | |
− | <java-type name="Customer">
| + | |
− | <xml-root-element name="customer"/>
| + | |
− | <java-attributes>
| + | |
− | <xml-attribute java-attribute="id"/>
| + | |
− | </java-attributes>
| + | |
− | </java-type>
| + | |
− | ...
| + | |
− | </source>
| + | |
− | | + | |
− | <br><br>
| + | |
− | | + | |
− | ==Mapping to a Text Node==
| + | |
− | This section describes using an XML direct mapping when doing the following:
| + | |
− | * [[#Mapping to a Text Node in a Simple Sequence|Mapping to a Text Node in a Simple Sequence]]
| + | |
− | * [[#Mapping to a Text Node in a Subelement|Mapping to a Text Node in a Subelement]]
| + | |
− | * [[#Mapping to a Text Node by Position|Mapping to a Text Node by Position]]
| + | |
− | * [[#Mapping to a Simple Text Node|Mapping to a Simple Text Node]]
| + | |
− | | + | |
− | | + | |
− | ===Mapping to a Text Node in a Simple Sequence===
| + | |
− | Given the XML schema in this example, the figure below illustrates an XML direct mapping to individual text nodes in a sequence in a corresponding XML document.
| + | |
− | | + | |
− | <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:sequence>
| + | |
− | </xsd:complexType>
| + | |
− | | + | |
− | </xsd:schema>
| + | |
− | </source>
| + | |
− | | + | |
− | [[Image:dxmss.gif|XML Direct Mapping to a Text Node in a Simple Sequence]]<br><br>
| + | |
− | | + | |
− | The following example shows how to annotate your Java class to obtain this mapping with EclipseLink. Here, the standard JAXB <tt>@XmlElement</tt> annotation is used, with a customized element name.
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | @XmlRootElement
| + | |
− | public class Customer {
| + | |
− | @XmlElement(name="first-name")
| + | |
− | public String firstName;
| + | |
− | @XmlElement(name="last-name")
| + | |
− | public String lastName;
| + | |
− | }
| + | |
− | </source>
| + | |
− | | + | |
− | The example below shows how to to define your mapping information in EclipseLink's OXM metadata format. To specify a custom element name, the <tt>name</tt> attribute is used.
| + | |
− | | + | |
− | <source lang="xml">
| + | |
− | ...
| + | |
− | <java-type name="Customer">
| + | |
− | <xml-root-element name="customer"/>
| + | |
− | <java-attributes>
| + | |
− | <xml-element java-attribute="firstName" name="first-name"/>
| + | |
− | <xml-element java-attribute="lastName" name="last-name"/>
| + | |
− | </java-attributes>
| + | |
− | </java-type>
| + | |
− | ...
| + | |
− | </source>
| + | |
− | | + | |
− | <br><br>
| + | |
− | | + | |
− | ===Mapping to a Text Node in a Subelement===
| + | |
− | Given the XML schema in this example, the following figure illustrates an XML direct mapping to a text node in a subelement in a corresponding XML document.
| + | |
− | | + | |
− | <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="personal-info">
| + | |
− | <xsd:complexType>
| + | |
− | <xsd:sequence>
| + | |
− | <xsd:element name="first-name" type="xsd:string"/>
| + | |
− | <xsd:element name="last-name" type="xsd:string"/>
| + | |
− | <xsd:sequence>
| + | |
− | </xsd:complexType>
| + | |
− | </xsd:element>
| + | |
− | </xsd:sequence>
| + | |
− | </xsd:complexType>
| + | |
− | | + | |
− | </xsd:schema>
| + | |
− | </source>
| + | |
− | | + | |
− | [[Image:dxmse.gif|XML Direct Mapping to a Text Node in a Subelement]]<br><br>
| + | |
− | | + | |
− | The following example shows how to annotate your Java class to obtain this mapping with EclipseLink. Here, because we are going beyond a simple element name customization and are actually introducing new XML structure, EclipseLink's <tt>@XmlPath</tt> annotation is used.
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | @XmlRootElement
| + | |
− | public class Customer {
| + | |
− | @XmlPath("personal-info/first-name/text()")
| + | |
− | public String firstName;
| + | |
− | @XmlPath("personal-info/last-name/text()")
| + | |
− | public String lastName;
| + | |
− | }
| + | |
− | </source>
| + | |
− | | + | |
− | The example below shows how to to define your mapping information in EclipseLink's OXM metadata format. Here, the customized XML path is defined in the <tt>xml-path</tt> attribute.
| + | |
− | | + | |
− | <source lang="xml">
| + | |
− | ...
| + | |
− | <java-type name="Customer">
| + | |
− | <xml-root-element name="customer"/>
| + | |
− | <java-attributes>
| + | |
− | <xml-element java-attribute="firstName" xml-path="personal-info/first-name/text()"/>
| + | |
− | <xml-element java-attribute="lastName" xml-path="personal-info/last-name/text()"/>
| + | |
− | </java-attributes>
| + | |
− | </java-type>
| + | |
− | ...
| + | |
− | </source>
| + | |
− | | + | |
− | <br><br>
| + | |
− | | + | |
− | ===Mapping to a Text Node by Position===
| + | |
− | Given the XML schema in this example, the following figure illustrates an XML direct mapping to a text node by position in a corresponding XML document.
| + | |
− | | + | |
− | <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="name" type="xsd:string" maxOccurs="2"/>
| + | |
− | </xsd:sequence>
| + | |
− | </xsd:complexType>
| + | |
− | | + | |
− | </xsd:schema>
| + | |
− | </source>
| + | |
− | | + | |
− | [[Image:dxmpos.gif|XML Direct Mapping to Text Node by Position]]<br><br>
| + | |
− | | + | |
− | The example below shows how to configure this mapping in Java. Again, for more complex XML path customization, EclipseLink's <tt>@XmlPath</tt> annotation is used.
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | @XmlRootElement
| + | |
− | public class Customer {
| + | |
− | @XmlPath("name[1]/text()")
| + | |
− | public String firstName;
| + | |
− | @XmlPath("name[2]/text()")
| + | |
− | public String lastName;
| + | |
− | }
| + | |
− | </source>
| + | |
− | | + | |
− | The following example shows how to to define your mapping information in EclipseLink's OXM metadata format.
| + | |
− | | + | |
− | <source lang="xml">
| + | |
− | ...
| + | |
− | <java-type name="Customer">
| + | |
− | <xml-root-element name="customer"/>
| + | |
− | <java-attributes>
| + | |
− | <xml-element java-attribute="firstName" xml-path="name[1]/text()"/>
| + | |
− | <xml-element java-attribute="lastName" xml-path="name[2]/text()"/>
| + | |
− | </java-attributes>
| + | |
− | </java-type>
| + | |
− | ...
| + | |
− | </source>
| + | |
− | | + | |
− | <br><br>
| + | |
− | | + | |
− | ===Mapping to a Simple Text Node===
| + | |
− | Given the XML schema in this example, the following figure illustrates an XML direct mapping to a simple text node in a corresponding XML document.
| + | |
− | | + | |
− | <source lang="xml">
| + | |
− | <?xml version="1.0" encoding="UTF-8"?>
| + | |
− | <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
| + | |
− | | + | |
− | <xsd:element name="phone-number" type="xsd:string"/>
| + | |
− | | + | |
− | </xsd:schema>
| + | |
− | </source>
| + | |
− | | + | |
− | [[Image:dxmstn.gif|XML Direct Mapping to Simple Text Node]]<br><br>
| + | |
− | | + | |
− | The following example shows how to annotate your Java class to obtain this mapping with EclipseLink. In this case, the <tt>@XmlValue</tt> annotation will be used.
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | @XmlRootElement(name="phone-number")
| + | |
− | public class PhoneNumber {
| + | |
− | @XmlValue
| + | |
− | public String number;
| + | |
− | }
| + | |
− | </source>
| + | |
− | | + | |
− | The example below shows how to to define your mapping information in EclipseLink's OXM metadata format.
| + | |
− | | + | |
− | <source lang="xml">
| + | |
− | ...
| + | |
− | <java-type name="PhoneNumber">
| + | |
− | <xml-root-element name="phone-number"/>
| + | |
− | <java-attributes>
| + | |
− | <xml-value java-attribute="number"/>
| + | |
− | </java-attributes>
| + | |
− | </java-type>
| + | |
− | ...
| + | |
− | </source>
| + | |
− | | + | |
− | <br><br>
| + | |
− | | + | |
− | ==Mapping to a Specified Schema Type==
| + | |
− | In most cases, EclipseLink can determine the target format in the XML document. However, there are cases where you must specify which one of a number of possible targets EclipseLink should use. For example, a <tt>java.util.Calendar</tt> could be marshalled to a schema <tt>date</tt>, <tt>time</tt>, or <tt>dateTime</tt> node, or a <tt>byte[]</tt> could be marshalled to a schema <tt>hexBinary</tt> or <tt>base64Binary</tt> node.
| + | |
− | | + | |
− | The following XML schema and figure illustrate an XML direct mapping from a <tt>Calendar</tt> object in Java to a <tt>date</tt> field in XML.
| + | |
− | | + | |
− | <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="hire-date" type="xsd:date"/>
| + | |
− | </xsd:sequence>
| + | |
− | </xsd:complexType>
| + | |
− | | + | |
− | </xsd:schema>
| + | |
− | </source>
| + | |
− | | + | |
− | [[Image:Schematypedate.png]]
| + | |
− | | + | |
− | The example below shows how to annotate your Java class to obtain this mapping with EclipseLink. Here, the <tt>@XmlSchemaType</tt> is used to specify the datatype that will appear in the marshalled XML.
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | @XmlRootElement
| + | |
− | public class Customer {
| + | |
− | @XmlElement(name="hire-date")
| + | |
− | @XmlSchemaType(name="date")
| + | |
− | public Calendar hireDate;
| + | |
− | }
| + | |
− | </source>
| + | |
− | | + | |
− | The following example shows how to to define your mapping information in EclipseLink's OXM metadata format.
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | ...
| + | |
− | <java-type name="Customer">
| + | |
− | <xml-root-element name="customer"/>
| + | |
− | <java-attributes>
| + | |
− | <xml-element java-attribute="hireDate" name="hire-date">
| + | |
− | <xml-schema-type name="date"/>
| + | |
− | </xml-element>
| + | |
− | </java-attributes>
| + | |
− | </java-type>
| + | |
− | ...
| + | |
− | </source>
| + | |
− | | + | |
− | <br><br>
| + | |
− | | + | |
− | ===Using Java Type Adapters===
| + | |
− | The next example schema and figure illustrate XML direct mappings to two different text nodes of different binary types.
| + | |
− | | + | |
− | <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="resume" type="xsd:base64Binary"/>
| + | |
− | <xsd:element name="picture" type="xsd:hexBinary"/>
| + | |
− | </xsd:sequence>
| + | |
− | </xsd:complexType>
| + | |
− | | + | |
− | </xsd:schema>
| + | |
− | </source>
| + | |
− | | + | |
− | [[Image:dxmscht.gif|XML Direct Mapping to a Specified Schema Type]]<br><br>
| + | |
− | | + | |
− | The example below shows how to annotate your Java class to obtain this mapping with EclipseLink. By default, JAXB will marshall <tt>byte[]</tt> to <tt>base64Binary</tt>, so nothing special is needed for the <tt>resume</tt> mapping. To map to a <tt>hexBinary</tt> field, the <tt>@XmlSchemaType</tt> annotation specifies the XML type, while <tt>@XmlJavaTypeAdapter</tt> specifies the adapter class that will be responsible for converting the value (in this case, the built-in JAXB <tt>HexBinaryAdapter</tt>).
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | @XmlRootElement
| + | |
− | public class Customer {
| + | |
− | @XmlElement
| + | |
− | public byte[] resume;
| + | |
− | @XmlElement
| + | |
− | @XmlSchemaType(name="hexBinary")
| + | |
− | @XmlJavaTypeAdapter(HexBinaryAdapter.class)
| + | |
− | public byte[] picture;
| + | |
− | }
| + | |
− | </source>
| + | |
− | | + | |
− | The following example shows how to to define your mapping information in EclipseLink's OXM metadata format.
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | ...
| + | |
− | <java-type name="Customer">
| + | |
− | <xml-root-element name="customer"/>
| + | |
− | <java-attributes>
| + | |
− | <xml-element java-attribute="resume"/>
| + | |
− | <xml-element java-attribute="picture">
| + | |
− | <xml-schema-type name="hexBinary"/>
| + | |
− | <xml-java-type-adapter value="javax.xml.bind.annotation.adapters.HexBinaryAdapter"/>
| + | |
− | </xml-element>
| + | |
− | </java-attributes>
| + | |
− | </java-type>
| + | |
− | ...
| + | |
− | </source>
| + | |
− | | + | |
− | <br><br>
| + | |
− | | + | |
− | ==Mapping with a Simple Type Translator==
| + | |
− | If the type of a node is not defined in your XML schema, you can configure an XML direct mapping to use the <tt>xsi:type</tt> attribute to provide type information.
| + | |
− | | + | |
− | Given the XML schema in this example, the figure below illustrates a Java class that can be mapped to a corresponding XML document.
| + | |
− | | + | |
− | <source lang="xml">
| + | |
− | <?xml version="1.0" encoding="UTF-8"?>
| + | |
− | <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
| + | |
− |
| + | |
− | <xsd:element name="phone-number" type="phone-number-type"/>
| + | |
− |
| + | |
− | <xsd:complexType name="phone-number-type">
| + | |
− | <xsd:sequence>
| + | |
− | <xsd:element name="area-code" type="anySimpleType"/>
| + | |
− | <xsd:element name="number" type="anySimpleType"/>
| + | |
− | </xsd:sequence>
| + | |
− | </xsd:complexType>
| + | |
− |
| + | |
− | </xsd:schema>
| + | |
− | </source>
| + | |
− | | + | |
− | [[Image:dxmsttc.gif|Java Class for XML Direct Mapping with Simple Type Translator]]<br><br>
| + | |
− | | + | |
− | The following figure illustrates an XML direct mapping with a simple type translator in an XML document that conforms to the schema above.
| + | |
− | | + | |
− | [[Image:dxmsttm.gif|XML Direct Mapping with a Simple Type Translator]]<br><br>
| + | |
− | | + | |
− | The following example shows shows how to annotate your Java class to obtain this mapping with EclipseLink.
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | @XmlRootElement(name="phone-number")
| + | |
− | public class PhoneNumber {
| + | |
− | @XmlElement(name="area-code")
| + | |
− | public Object areaCode;
| + | |
− | @XmlElement
| + | |
− | public Object number;
| + | |
− | }
| + | |
− | </source>
| + | |
− | | + | |
− | The example below shows how to to define your mapping information in EclipseLink's OXM metadata format.
| + | |
− | | + | |
− | <source lang="xml">
| + | |
− | ...
| + | |
− | <java-type name="PhoneNumber">
| + | |
− | <xml-root-element name="phone-number"/>
| + | |
− | <java-attributes>
| + | |
− | <xml-element java-attribute="areaCode" name="area-code"/>
| + | |
− | <xml-element java-attribute="number"/>
| + | |
− | </java-attributes>
| + | |
− | </java-type>
| + | |
− | ...
| + | |
− | </source>
| + | |
− | | + | |
− | For more information, see [[Introduction%20to%20Mappings%20(ELUG)#Simple Type Translator|Simple Type Translator]].
| + | |
− | | + | |
− | <br><br>
| + | |
− | | + | |
− | ==Mapping to a Union Field with an XML Direct Mapping==
| + | |
− | Given the XML schema in the [[#Example 58-16|Schema for XML Direct Mapping to a Union Field]] example, the [[#Figure 58-8|Java Class for XML Direct Mapping to a Union Field]] figure illustrates a Java class that can be mapped to a corresponding XML document. Note the <tt>shoeSize</tt> attribute in this class: when using a union field, the corresponding attribute must be able to store all possible values.
| + | |
− | | + | |
− | <span id="Example 58-16"></span>
| + | |
− | ''''' Schema for XML Direct Mapping to Union of Lists'''''
| + | |
− | <?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="shoe-size" type="size-type"/>
| + | |
− | </xsd:sequence>
| + | |
− | </xsd:complexType>
| + | |
− | <xsd:simpleType name="size-type">
| + | |
− | <xsd:union memberTypes="xsd:decimal xsd:string"/>
| + | |
− | </xsd:simpleType>
| + | |
− | </xsd:schema>
| + | |
− | | + | |
− | | + | |
− | <span id="Figure 58-8"></span>
| + | |
− | '''''Java Class for XML Direct Mapping to a Union Field'''''
| + | |
− | | + | |
− | [[Image:dxmuc.gif|Java Class for XML Direct Mapping to a Union Field]]<br><br>
| + | |
− | | + | |
− | The [[#Figure 58-9| XML Direct Mapping to the First Valid Union Type]] figure illustrates an XML direct mapping to a union field in an XML document that conforms to the schema in the [[#Example 58-16|Schema for XML Direct Mapping to a Union Field]] example. When EclipseLink unmarshalls the XML document, it tries each of the union types until it can make a successful conversion. The first schema type in the union is <tt>xsd:decimal</tt>. Because "10.5" is a valid decimal, EclipseLink converts the value to the appropriate type. If the <tt>Object</tt> attribute is specific enough to trigger an appropriate value, EclipseLink will use that type instead. Otherwise, EclipseLink uses a default (in this case <tt>BigDecimal</tt>). You can override this behavior in Java code.
| + | |
− | | + | |
− | <span id="Figure 58-9"></span>
| + | |
− | '''''XML Direct Mapping to the First Valid Union Type'''''
| + | |
− | | + | |
− | [[Image:dxmuv.gif|XML Direct Mapping to the First Valid Union Type]]<br><br>
| + | |
− | | + | |
− | The [[#Figure 58-10|XML Direct Mapping to Another Valid Union Type]] figure illustrates an XML direct mapping to union field in another XML document that conforms to the schema in [[#Example 58-16|Schema for XML Direct Mapping to a Union Field]]. In this document, the value "M" is not a valid <tt>xsd:decimal</tt> type so the next union type is tried. The next union type is <tt>xsd:string</tt> and a conversion can be done.
| + | |
− | | + | |
− | <span id="Figure 58-10"></span>
| + | |
− | '''''XML Direct Mapping to Another Valid Union Type'''''
| + | |
− | | + | |
− | [[Image:dxmuvs.gif|XML Direct Mapping to Another Valid Union Type]]<br><br>
| + | |
− | | + | |
− | This example shows how to configure this mapping in Java.
| + | |
− | | + | |
− | <span id="Example 58-17"></span>
| + | |
− | '''''Java for XML Direct Mapping to a Union Type'''''
| + | |
− | XMLDirectMapping shoeSizeMapping = new XMLDirectMapping();
| + | |
− | shoeSizeMapping.setAttributeName("shoeSize");
| + | |
− | XMLUnionField shoeSizeField = new XMLUnionField();
| + | |
− | shoeSizeField.setXPath("shoe-size/text()");
| + | |
− | shoeSizeField.addSchemaType(XMLConstants.DECIMAL_QNAME);
| + | |
− | shoeSizeField.addSchemaType(XMLConstants.STRING_QNAME);
| + | |
− | shoeSizeMapping.setField(shoeSizeField);
| + | |
− |
| + | |
− | To override the default conversion, use the <tt>XMLUnionField</tt> method <tt>addConversion</tt><nowiki>:</nowiki>
| + | |
− | shoeSizeField.addConversion(XMLConstants.DECIMAL_QNAME, Float.class);
| + | |
− | | + | |
− | ==Mapping to a Union of Lists with an XML Direct Mapping==
| + | |
− | Given the XML schema in [[#Example 58-18|Schema for XML Direct Mapping to Union of Lists]], the [[#Figure 58-11|XML Direct Mapping to Union of Lists]] figure illustrates an XML direct mapping to a union of lists in a corresponding XML document. The [[#Example 58-19|Java for XML Direct Mapping to Union of Lists]] example shows how to configure this mapping in Java.
| + | |
− | | + | |
− | | + | |
− | <span id="Example 58-18"></span>
| + | |
− | ''''' Schema for XML Direct Mapping to Union of Lists'''''
| + | |
− | <?xml version="1.0" encoding="UTF-8"?>
| + | |
− | <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
| + | |
− |
| + | |
− | <xsd:element name="vacation" type="unionOfLists"/>
| + | |
− | <xsd:simpleType name="unionOfLists">
| + | |
− | <xsd:union memberTypes="xsd:double">
| + | |
− | <xsd:simpleType>
| + | |
− | <xsd:list itemType="xsd:date"/>
| + | |
− | </xsd:simpleType>
| + | |
− |
| + | |
− | <xsd:simpleType>
| + | |
− | <xsd:list itemType="xsd:integer"/>
| + | |
− | </xsd:simpleType>
| + | |
− | </xsd:union>
| + | |
− | </xsd:simpleType>
| + | |
− | </xsd:schema>
| + | |
− |
| + | |
− | | + | |
− | | + | |
− | <span id="'Figure 58-11"></span>
| + | |
− | ''''' XML Direct Mapping to Union of Lists'''''
| + | |
− | | + | |
− | [[Image:dxuofl.gif|XML Direct Mapping to Union of Lists]]<br><br>
| + | |
− | | + | |
− | Note that in this example, valid XML documents contain either all <tt>xsd:double</tt>, all <tt>xsd:date</tt>, or all <tt>xsd:integer</tt> values.
| + | |
− | | + | |
− | | + | |
− | <span id="Example 58-19"></span>
| + | |
− | ''''' Java for XML Direct Mapping to Union of Lists'''''
| + | |
− | XMLDirectMapping mapping = new XMLDirectMapping();
| + | |
− | mapping.setAttributeName("vacation");
| + | |
− | mapping.setXPath("UnionOfLists/text()");
| + | |
− | | + | |
− | ==Mapping to a Union of Unions with an XML Direct Mapping==
| + | |
− | Given the XML schema in the [[#Example 58-20|Schema for XML Direct Mapping to a Union of Unions]] example, the [[#Figure 58-12|Java Class for XML Direct Mapping to a Union of Unions]] figure illustrates a Java class that can be mapped to a corresponding XML document. The [[#Example 58-21|Java for XML Direct Mapping to a Union of Unions]] example shows how to configure this mapping in Java.
| + | |
− | | + | |
− | | + | |
− | <span id="Example 58-20"></span>
| + | |
− | ''''' Schema for XML Direct Mapping to a Union of Unions'''''
| + | |
− | <?xml version="1.0" encoding="UTF-8"?>
| + | |
− | <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
| + | |
− | <xsd:element name="vacation" type="unionOfUnions"/>
| + | |
− | <xsd:simpleType name="unionOfUnions">
| + | |
− | <xsd:union>
| + | |
− |
| + | |
− | <xsd:simpleType>
| + | |
− | <xsd:union>
| + | |
− | <xsd:simpleType>
| + | |
− | <xsd:list itemType="xsd:date"/>
| + | |
− | </xsd:simpleType>
| + | |
− | <xsd:simpleType>
| + | |
− |
| + | |
− | <xsd:list itemType="xsd:integer"/>
| + | |
− | </xsd:simpleType>
| + | |
− | </xsd:union>
| + | |
− | </xsd:simpleType>
| + | |
− | <xsd:simpleType>
| + | |
− | <xsd:union>
| + | |
− |
| + | |
− | <xsd:simpleType>
| + | |
− | <xsd:list itemType="xsd:string"/>
| + | |
− | </xsd:simpleType>
| + | |
− | <xsd:simpleType>
| + | |
− | <xsd:list itemType="xsd:float"/>
| + | |
− | </xsd:simpleType>
| + | |
− |
| + | |
− | </xsd:union>
| + | |
− | </xsd:simpleType>
| + | |
− | </xsd:union>
| + | |
− | </xsd:simpleType>
| + | |
− | </xsd:schema>
| + | |
− | | + | |
− | | + | |
− | <span id="Figure 58-12"></span>
| + | |
− | ''''' Java Class for XML Direct Mapping to a Union of Unions'''''
| + | |
− | | + | |
− | [[Image:dxuofu.gif|Java Class for XML Direct Mapping to a Union of Unions]]<br><br>
| + | |
− | | + | |
− | | + | |
− | <span id="Example 58-21"></span>
| + | |
− | ''''' Java for XML Direct Mapping to a Union of Unions'''''
| + | |
− | XMLDirectMapping vacationMapping = new XMLDirectMapping();
| + | |
− | vacationMapping.setAttributeName("vacation");
| + | |
− | XMLUnionField vacationField = new XMLUnionField();
| + | |
− | vacationField.setXPath("vacation/text()");
| + | |
− | vacationField.addSchemaType(XMLConstants.DATE_QNAME);
| + | |
− | vacationField.addSchemaType(XMLConstants.INTEGER_QNAME);
| + | |
− | vacationField.addSchemaType(XMLConstants.STRING_QNAME);
| + | |
− | vacationField.addSchemaType(XMLConstants.FLOAT_QNAME);
| + | |
− | vacationMapping.setField(vacationField);
| + | |
− | | + | |
− | | + | |
− | {{EclipseLink_MOXy
| + | |
− | |previous= [[EclipseLink/UserGuide/MOXy/Simple_Values/Single_Values|Single Values]]
| + | |
− | |next= [[EclipseLink/UserGuide/MOXy/Simple_Values/Collections|Collections]]
| + | |
− | |up= [[EclipseLink/UserGuide/MOXy/Simple_Values/Single_Values|Single Values]]
| + | |
− | |version=2.2.0 Draft
| + | |
− | }}
| + | |