YOUR FEEDBACK
andy.mulholland wrote: intriguing !!! We have full scale 'Mashup Factories' in Chicago USA and Utrec...
AJAXWorld RIA Conference
Early Bird Savings Expire Friday Register Today and SAVE !..


2008 East
DIAMOND SPONSOR:
Data Direct
Frontiers in Data Access: The Coming Wave in Data Services
PLATINUM SPONSORS:
Red Hat
The Opening of Virtualization
Intel
Virtualization – Path to Predictive Enterprise
Green Hills
IT Security in a Hostile World
JBoss / freedom oss
Practical SOA Approach
GOLD SPONSORS:
Software AG
The Art & Science of SOA: How Governance Enables Adoption
PlateSpin
Effective Planning for Virtual Infrastructure Growth
Fujitsu
Automated Business Process Discovery & Virtualization Service
Ceedo
Workspace Virtualization
Click For 2007 West
Event Webcasts

2008 East
PLATINUM SPONSORS:
Appcelerator
Think Fast: Accelerate AJAX Development with Appcelerator
GOLD SPONSORS:
DreamFace Interactive
The Ultimate Framework for Creating Personalized Web 2.0 Mashups
ICEsoft
AJAX and Social Computing for the Enterprise
Kaazing
Enterprise Comet: Real–Time, Real–Time, or Real–Time Web 2.0?
Nexaweb
Now Playing: Desktop Apps in the Browser!
Sun
jMaki as an AJAX Mashup Framework
POWER PANELS:
The Business Value
of RIAs
What Lies Beyond AJAX?
KEYNOTES:
Douglas Crockford
Can We Fix the Web?
Anthony Franco
2008: The Year of the RIA
Click For 2007 Event Webcasts
SYS-CON.TV
TODAY'S TOP SOA & WEBSERVICES LINKS


SimpleType and ComplexType in a Schema
Designing your own

This tutorial discusses the simpleType and complexType XML Schema structures and their corresponding representations in an XML document. XML Schema is used as the basis of an XML document structure, and some of the XML technologies, such as JAXB, are based on XML Schema.

Overview
An XML Schema is an XML-based representation of the structure of an XML document. XML Schema supports data types and namespaces; a DTD does not. In this tutorial, the simpleType and complexType structures used to represent a XML document will be discussed.

SimpleType Declaration
SimpleTypes are custom data types used with element and attribute declarations. A simpleType is represented with a <xs:simple Type/> declaration. An <xs:simpleType/> element is used to constrain character data in a element or a attribute declaration. A simpleType is used to constrain data types only; a simpleType does not have attributes or element nodes. With an element declaration the simpleType is used as:

<xs:schema>
<xs:element name="A" type="simpleTypeA"/>
<xs:simpleType name="simpleTypeA">
</xs:simpleType>
</xs:schema>

or

<xs:element name="A">
<xs:simpleType>
</xs:simpleType>
</xs:element>

With an attribute declaration, the simpleType is used as

<complexType> <xs:attribute name="AttributeA" type="simpleTypeA"/> </complexType>

or

<xs:attribute name="AttributeA">
<xs:simpleType>
</xs:simpleType>
<xs:attribute>

The <xs:simpleType/> declaration may be present in an <xs:element/> element, <xs:attribute/> element, <xs:restriction/> element, <xs:list/> element, <xs:union/> element, or the <xs:schema/> element.

The <xs:simpleType/> element may contain one of the <xs:restriction/>, <xs:list/>, <xs:union/> elements.

SimpleType with Restriction Element
A simpleType used to constrain a decimal data type would be

<xs:element name="A">
<xs:simpleType>
<xs:restriction base="xs:decimal">
<xs:minExclusive value="1.0"/>
<xs:maxInclusive value="5.0"/>
<xs:totalDigits value="3"/>
<xs:fractionDigits value="2"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

A corresponding representation of element Element "A" in an XML document would be

<A>5.0</A>

Element "A" in an XML document may have values between 2.00 and 5.00 (inclusive). Declaration <A>1.0</A> or <A>25.0</A> would not validate with the Schema.

A simpleType to constrain the length of a string data type would be

<xs:element name="A">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="5"/>
<xs:maxLength value="10"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

A corresponding representation of "A" in an XML document would be

<A>string</A>
Declaration <A>str</A>

or

<A>stringelement</A>

would not validate with the Schema.

An element with a fixed length would be represented with simpleType as

<xs:element name="A">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="5"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

An example of a corresponding representation of ?A? in an XML document would be

<A>strin</A>

An attribute with an enumeration of values would be represented with simpleType as


     <xs:element name="A" >
       <xs:complexType>
         <xs:attribute
          name="AttributeA">
           <xs:simpleType>
             <xs:restriction
              base="xs:string">
               <xs:enumeration
                value="a"/>
               <xs:enumeration
                value="b"/>
              </xs:restriction>
            </xs:simpleType>
          </xs:attribute>
        </xs:complexType>
      </xs:element>

A corresponding representation in an XML document is

<A AttributeA="a"/>

"AttributeA" may have one of the values, "a" or "b."

The <xs:restriction/> element in a <xs:simpleType/> may be used to constrain the value space of data types derived from the string data type with the <xs:whitespace/> element.

The whiteSpace element is represented as <xs:whiteSpace value="preserve|collapse|replace"/>. The value of the attribute "value" of element <xs:whitespace/> may be "preserve," "collapse," or "replace."

If the value of an attribute "value" is "preserve," the whitepaces in the string data type are not changed. If the value of the attribue "value" is "replace," all occurrences of #x9(tab), #xA(linefeed), and #xD(carriage return) are replaced with a #x20(space).

An element with a whiteSpace restriction on its string value is represented in a schema as

<xs:element name="A">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="replace"/>
<xs:restriction>
</xs:simpleType>
</xs:elementA>

If the value of attribute "value" is "replace," the string in "A" in an XML document represented as

<A> Trim
      String
WhiteSpace</A>

would be parsed as "Trim String White Space."

If the value of the attribute '"value" is "collapse," the leading and trailing #x20(space) are removed, and contiguous occurances of #x20(space) are merged into a single #x20(space).

If the value of the attribute "value" is "collapse," the string in "A" in an XML document represented as

<A> Trim String WhiteSpace </A>

would be parsed as "Trim String White Space".

<xs:restriction/> element <xs:pattern/> is used to constrain the value space of data types to literals which match a regular expression.

An example of a simpleType with pattern restriction would be

<xs:element name="A">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[1-5]{2}(-[5-10]{3})"/>
</xs:simpleType>
</xs:element>

An example of a corresponding representation in a XML document is

<A>25-567</A>

SimpleType with List Element
A simpleType may be used to represent a list of values in a XML document element with

<xs:list/> element.
<xs:element name="A">
<xs:simpleType>
<xs:list itemType="xs:decimal"/>
</xs:simpleType>
</xs:element>

An element with a list of values would be

<A>1.0 2 3</A>

SimpleType with Union Element
A simpleType may be used to represent a union of simpleTypes with the <xs:union/> element.

<xs:element name="A">
<xs:simpleType>
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string"/>
</xs:simpleType>
</xs:union>
</xs:simpleType>
</xs:element>

An element with a union of simpleTypes in an XML document would be

<A>15</A>

or

<A>element A</A>

"A" may be either an integer or a string.

ComplexType Declaration
A complexType is used to constrain elements and attributes in an XML document. It is represented with <xs:complex Type/>.

A complexType declaration may occur in the <xs:schema/> declaration or a <xs:element/> declaration.

If a complexType is declared in the <xs:schema/> element, the complexType may be referred to in the ?type? attribute of an element declaration.

<xs:schema>
<complexType name="complexTypeA">
</complexType>
<xs:element name="A" type="complexTypeA"/>
</xs:schema>

A text(PCDATA) element is represented with a complexType as


     <xsd:element name="A">
      <xsd:complexType mixed="true">
        <xsd:complexContent>
          <xsd:restriction
           base="xsd:anyType">
          </xsd:restriction>
        </xsd:complexContent>
      </xsd:complexType>
    </xsd:element>

The corresponding representation of a text element in an XML document is

<A>Text Element</A>

An empty element is represented with a complexType as


    <xsd:element name="A">
      <xsd:complexType mixed="false">
        <xsd:complexContent>
          <xsd:restriction
           base="xsd:anyType">
          </xsd:restriction>
        </xsd:complexContent>
      </xsd:complexType>
    </xsd:element>

The corresponding representation of an empty element in an XML document is <A/>.

An unordered element set is represented with a complexType element as


    <xs:element name="A" >
      <xs:complexType>
        <xs:all>
          <xs:element name="B"
           type="xs:string"/>
          <xs:element name="C"
           type="xs:string"/>
          <xs:element name="D"
           type="xs:string"/>
        </xs:all>
      </xs:complexType>
    </xs:element>

A corresponding representation of an unordered element set in an XML document is

<A>
<D>Element D</D>
<B>Element B</B>
<C>Element C</C>
</A>

An element with a choice and a sequence is represented with a complex Type as


    <xs:element name="A" >
      <xs:complexType>
        <xs:sequence>
          <xs:choice>
          <xs:element name="B"
           type="xs:string"/>
          <xs:element name="C"
           type="xs:string"/>
          </xs:choice>
          <xs:element name="D"
           type="xs:string"/>
         </xs:sequence>
        </xs:choice>
      </xs:complexType>
    </xs:element>

A corresponding representation of an element with a choice and sequence in a XML document is

<A>
<B>Element B</B>
<D>Element D</D>
</A>

ComplexType with Mixed Content
An element with a mixed content is represented in a complexType as


    <xs:element name="A" >
      <xs:complexType mixed="true">
        <xs:element name="B"
         type="xs:string"/>
    </xs:complexType>
   </xs:element>

The corresponding representation of a mixed content element in an XML document is

<A>Element Text
<B>Element B</B>
</A>

ComplexType with SimpleContent Element
Elements with character data and attributes are represented with the <xs:simpleContent/> element.


<xs:element name="A">
<xs:complexType>
 <xs:simpleContent>
  <xs:extension base="xs:string">
   <xs:attribute name="attr"
    type="xs:integer"/>
  </xs:extension>
 </xs:simpleContent>
</xs:complexType>
</element>

The corresponding representation of a simpleContent element in a XML document is

<A attr="15">simpleContent Type Element</A>

The simpleContent element may also be used with the <xs:restriction/> element.


<xs:element name="A">
<xs:complexType>
 <xs:simpleContent>
  <xs:restriction base="xs:string">
  <xs:minLength value="5"/>
   <xs:attribute name="a"
    type="xs:integer"/>
  </xs:restriction>
 </xs:simpleContent>
</xs:complexType>
</element>

The corresponding representation of a simpleContent element with a restriction in a XML document is

<A a="15">Element A</A>

ComplexType with ComplexContent Element
An element with constraint on its elements and attributes may be represented with the <xs:complexContent/> element. An example of this element would be

<xs:element name="A">
<xs:complexType>
<xs:complexContent>
<xs:restriction base="anyType">
<xs:sequence>
<xs:element name="B" type="xs:string"/>
<xs:element name="C" type="xs:integer"/>
</xs:sequence>
</xs:restriction>
</xs:complexContent>
</xs:complexType>
</xs:element>

The corresponding representation of element ?A? with complexContent in a XML document is

<A><B>Element B</B><C>25</C></A>

The complexContent element may be used to extend another complexType.

<xs:complexType name="complexTypeA">
<xs:sequence>
<xs:element name="B"/>
<xs:element name="C"/>
</xs:sequence>
</xs:complexType>
<xs:element name="A">
<xs:complexType>
<xs:complexContent>
<xs:extension base="complexTypeA">
<xs:sequence>
<xs:element name="D"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>

The corresponding representation of a complexContent element with an extension on another complexType is

<A>
<B>Element B</B>
<C>Element C</C>
<D>Element D</D>
</A>

Conclusion
This tutorial discussed the simpleType and complexType XML Schema structures, which may be used to design custom simpleType and complexType elements.

Resources:

  • XML Schema: Structures Specification.
  • About Deepak Vohra
    Deepak Vohra is a Sun Certified Java 1.4 Programmer and a Web developer.

    About Ajay Vohra
    Ajay Vohra is a senior solutions architect with DataSynapse Inc.

    XML JOURNAL LATEST STORIES . . .
    Intel, a leader in silicon innovation, develops technologies, products and initiatives to continually advance how people work and live. Intel XML Software Products help enhance productivity of XML and SOA application development by providing comprehensive, high performance XML processi...
    The one thing that unifies the distributed computing style known as SOA, in most of its manifestations, is self-describing data via the Extensible Markup Language (XML). The benefits of XML over opaque message formats in data interchange are well established. No matter if your focus is...
    Since its emergence, Web Service technology has gone a long way towards perfecting itself and finding its right application in the real world. With the maturity of the specifications, Web Service technology, with its power of interoperability, is now the major enabling technology of SO...
    Join Scott Guthrie as he discusses Microsoft’s commitment to web standards development, Rich Internet Applications and how Microsoft is contributing to help move the web forward. Join Adobe’s Kevin Lynch as he demonstrates how Flash and HTML come together to make the most engaging,...
    In a snit that Microsoft was able to push its OOXML file format through to ISO standardization, IBM, a big backer of the OOXML-opposing ODF file format, has instituted a new corporate policy that suggests it will pull out of standards bodies whose rules don’t conform to what it think...
    SUBSCRIBE TO THE WORLD'S MOST POWERFUL NEWSLETTERS
    SUBSCRIBE TO OUR RSS FEEDS & GET YOUR SYS-CON NEWS LIVE!
    Click to Add our RSS Feeds to the Service of Your Choice:
    Google Reader or Homepage Add to My Yahoo! Subscribe with Bloglines Subscribe in NewsGator Online
    myFeedster Add to My AOL Subscribe in Rojo Add 'Hugg' to Newsburst from CNET News.com Kinja Digest View Additional SYS-CON Feeds
    Publish Your Article! Please send it to editorial(at)sys-con.com!

    Advertise on this site! Contact advertising(at)sys-con.com! 201 802-3021


    SYS-CON FEATURED WHITEPAPERS


    ADS BY GOOGLE
    BREAKING XML NEWS
    SOA Software, a leading Integrated SOA Governance Automation vendor, today announced that it has exp...