EclipseLink/DesignDocs/277920/Phase4

Phase 4 (page under construction)

Provide support for high level metadata.

Annotations

The following annotations will be targetted in this phase:

Annotation	Package	Type	Field	Method
XmlElementWrapper			X	X
XmlList			X	X
XmlValue			X	X
XmlMixed			X	X

Example: XmlElementWrapper

Java Metadata

The following example will demonstrate how an XmlElementWrapper annotation can be applied:

org.example.Employee.java

package org.example;
 
import javax.xml.bind.annotation.XmlElementWrapper;
 
public class Employee {
    @XmlElementWrapper(name="my-digits", nillable=true, required=true)
    public int[] digits;
}

XML Metadata

xml-element-wrapper

If this is present in the XML then it completely replaces the corresponding annotation.

org/example/eclipselink-oxm.xml

This XML file represents metadata overrides for the "org.example.Employee" class.

<?xml version="1.0" encoding="US-ASCII"?>
<xml-bindings xmlns="http://www.eclipse.org/eclipselink/xsds/persistence/oxm">
  <java-types>
    <java-type name="org.example.Employee">
        <java-attributes>
            <xml-element-wrapper java-attribute="digits" name="my-digits" nillable="true" required="true"/>
        </java-attributes>
    </java-type>
  </java-types>
</xml-bindings>