EclipseLink/Examples/SDO/MetadataXMLSchema

Overview

The following example will demonstrate how to use EclipseLink's SDO functionality to:

• Define SDO Types and Properties from an XML Schema
• Lookup SDO Types and Properties
• Get XML Schema Information about SDO Types and Properties

Define SDO Types and Properties from XML Schema

The first thing that needs to be done in a SDO application is to set up the metadata for the Types and Properties. This is most commonly done by loading an XML schema, although it may also be done programmatically.

FileInputStream xsdInputStream = new FileInputStream("Customer.xsd");
XSDHelper.INSTANCE.define(xsdInputStream, null);

Lookup SDO Types and Properties

Get a SDO Open Content Property corresponding to a Global Attribute/Element

Once the XML schema has been processed the global attributes and elements are available as open content properties.

Property phoneNumberProperty = 
     TypeHelper.INSTANCE.getOpenContentProperty("http://www.example.org/customer-example", "phone-number");

You can also use XSDHelper to get the open content properties using XML information. This is useful when you have a global element and attribute in the same namspace with the same name.

Property phoneNumberProperty = 
     XSDHelper.INSTANCE.getGlobalProperty("http://www.example.org/customer-example", "phone-number", true);

Get a SDO Type corresponding to a Global Complex Type

When the SDO Type corresponds to a global complex type like the following:

<xs:complexType name="address-type">
    <xs:sequence>
        <xs:element name="street" type="xs:string" maxOccurs="2"/>
        <xs:element name="city" type="xs:string"/>
        <xs:element name="state" type="xs:string"/>
        <xs:element name="zip-code" type="xs:string"/>
    </xs:sequence>
</xs:complexType>

Then the corresponding SDO Type can be looked up as follows:

Type addressType = TypeHelper.INSTANCE.getType("http://www.example.org/customer-example", "address-type");

Get a SDO Type corresponding to a Global Attribute/Element

When the SDO Type corresponds to a global element like the following:

<xs:element name="phone-number">
    <xs:complexType>
        <xs:simpleContent>
            <xs:extension base="xs:string">
                <xs:attribute name="number-type" type="xs:string"/>
            </xs:extension>
        </xs:simpleContent>
    </xs:complexType>
</xs:element>

Then the corresponding SDO Type can be looked up as follows:

Property phoneNumberProperty = 
    TypeHelper.INSTANCE.getOpenContentProperty("http://www.example.org/customer-example", "phone-number");
Type phoneNumberType = phoneNumberProperty.getType();

Get XML Schema Information about SDO Types and Properties

SDO Property XML Schema Info

You can determine if the SDO property corresponds to an XML attribute or XML element:

XSDHelper.INSTANCE.isAttribute(phoneNumberProperty);
XSDHelper.INSTANCE.isElement(phoneNumberProperty);

You can get XML name/URI information:

XSDHelper.INSTANCE.getLocalName(phoneNumberProperty);
XSDHelper.INSTANCE.getNamespaceURI(phoneNumberProperty);

SDO Type XML Schema Info

You can get the XML name information:

XSDHelper.INSTANCE.getLocalName(addressType);

You can determine if the corresponding XML type is mixed:

XSDHelper.INSTANCE.isMixed(addressType);