Welcome!

Industrial IoT Authors: Elizabeth White, Stackify Blog, Yeshim Deniz, SmartBear Blog, Liz McMillan

Related Topics: Industrial IoT

Industrial IoT: Article

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.
  • More Stories By Deepak Vohra

    Deepak Vohra is a Sun Certified Java 1.4 Programmer and a Web developer.

    More Stories By Ajay Vohra

    Ajay Vohra is a senior solutions architect with DataSynapse Inc.

    Comments (0)

    Share your thoughts on this story.

    Add your comment
    You must be signed in to add a comment. Sign-in | Register

    In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.


    IoT & Smart Cities Stories
    The standardization of container runtimes and images has sparked the creation of an almost overwhelming number of new open source projects that build on and otherwise work with these specifications. Of course, there's Kubernetes, which orchestrates and manages collections of containers. It was one of the first and best-known examples of projects that make containers truly useful for production use. However, more recently, the container ecosystem has truly exploded. A service mesh like Istio addr...
    CloudEXPO New York 2018, colocated with DXWorldEXPO New York 2018 will be held November 11-13, 2018, in New York City and will bring together Cloud Computing, FinTech and Blockchain, Digital Transformation, Big Data, Internet of Things, DevOps, AI, Machine Learning and WebRTC to one location.
    @DevOpsSummit at Cloud Expo, taking place November 12-13 in New York City, NY, is co-located with 22nd international CloudEXPO | first international DXWorldEXPO and will feature technical sessions from a rock star conference faculty and the leading industry players in the world. The widespread success of cloud computing is driving the DevOps revolution in enterprise IT. Now as never before, development teams must communicate and collaborate in a dynamic, 24/7/365 environment. There is no time t...
    DXWordEXPO New York 2018, colocated with CloudEXPO New York 2018 will be held November 11-13, 2018, in New York City and will bring together Cloud Computing, FinTech and Blockchain, Digital Transformation, Big Data, Internet of Things, DevOps, AI, Machine Learning and WebRTC to one location.
    SYS-CON Events announced today that DatacenterDynamics has been named “Media Sponsor” of SYS-CON's 18th International Cloud Expo, which will take place on June 7–9, 2016, at the Javits Center in New York City, NY. DatacenterDynamics is a brand of DCD Group, a global B2B media and publishing company that develops products to help senior professionals in the world's most ICT dependent organizations make risk-based infrastructure and capacity decisions.
    Cloud-enabled transformation has evolved from cost saving measure to business innovation strategy -- one that combines the cloud with cognitive capabilities to drive market disruption. Learn how you can achieve the insight and agility you need to gain a competitive advantage. Industry-acclaimed CTO and cloud expert, Shankar Kalyana presents. Only the most exceptional IBMers are appointed with the rare distinction of IBM Fellow, the highest technical honor in the company. Shankar has also receive...
    Headquartered in Plainsboro, NJ, Synametrics Technologies has provided IT professionals and computer systems developers since 1997. Based on the success of their initial product offerings (WinSQL and DeltaCopy), the company continues to create and hone innovative products that help its customers get more from their computer applications, databases and infrastructure. To date, over one million users around the world have chosen Synametrics solutions to help power their accelerated business or per...
    A valuable conference experience generates new contacts, sales leads, potential strategic partners and potential investors; helps gather competitive intelligence and even provides inspiration for new products and services. Conference Guru works with conference organizers to pass great deals to great conferences, helping you discover new conferences and increase your return on investment.
    Business professionals no longer wonder if they'll migrate to the cloud; it's now a matter of when. The cloud environment has proved to be a major force in transitioning to an agile business model that enables quick decisions and fast implementation that solidify customer relationships. And when the cloud is combined with the power of cognitive computing, it drives innovation and transformation that achieves astounding competitive advantage.
    Digital Transformation: Preparing Cloud & IoT Security for the Age of Artificial Intelligence. As automation and artificial intelligence (AI) power solution development and delivery, many businesses need to build backend cloud capabilities. Well-poised organizations, marketing smart devices with AI and BlockChain capabilities prepare to refine compliance and regulatory capabilities in 2018. Volumes of health, financial, technical and privacy data, along with tightening compliance requirements by...