This text file contains sample code fragments from:
Section 22.3 - Strict Versioning
Chapter 22 - Versioning Message Schemas
Book - Web Service Contract Design & Versioning for SOA
Series - The Prentice Hall Service Technology Series from Thomas Erl
Site - www.servicetechbooks.com


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  targetNamespace="http://actioncon.com/schema/po/v2"
  xmlns="http://actioncon.com/schema/po/v2"
  version="2.0">
  <xsd:element name="LineItem" type="LineItemType"/>
  <xsd:complexType name="LineItemType">
    <xsd:sequence>
      <xsd:element name="productID" type="xsd:string"/>
      <xsd:element name="productName" type="xsd:string"/>
      <xsd:element name="available" type="xsd:boolean"/>
    </xsd:sequence>
  </xsd:complexType>
</xsd:schema>

Example 22.7 - The available element is added, forcing a change in the namespace value.


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  targetNamespace="http://actioncon.com/schema/po/v2"
  xmlns="http://actioncon.com/schema/po/v2"
  version="2.0">
  <xsd:element name="LineItem" type="LineItemType"/>
  <xsd:complexType name="LineItemType">
    <xsd:sequence>
      <xsd:element name="productID" type="xsd:string"/>
      <xsd:element name="productName" type="xsd:string"/>
      <xsd:element name="available" type="xsd:boolean"
        minOccurs="0"/>
    </xsd:sequence>
  </xsd:complexType>
</xsd:schema>

Example 22.8 - The available element is added with the minOccurs attribute set to "0," making this an optional element, but still requiring a change to the namespace.


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  targetNamespace="http://actioncon.com/schema/po/v2"
  xmlns="http://actioncon.com/schema/po/v2"
  version="2.0">
  <xsd:element name="LineItem" type="LineItemType"/>
  <xsd:complexType name="LineItemType">
    <xsd:sequence>
      <xsd:element name="productID" type="xsd:string"/>
      <!-- productName Removed 09/12 -->
    </xsd:sequence>
  </xsd:complexType>
</xsd:schema>

Example 22.9 - The productName element declaration is deleted, resulting in a new major version of the schema.


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  targetNamespace="http://actioncon.com/schema/po/v2"
  xmlns="http://actioncon.com/schema/po/v2"
  version="2.0">
  <xsd:element name="LineItem" type="LineItemType"/>
  <xsd:complexType name="LineItemType">
    <xsd:sequence>
      <xsd:element name="productID" type="xsd:string"/>
      <xsd:element name="productName2" type="xsd:string"/>
      <xsd:element name="available" type="xsd:boolean"/>
    </xsd:sequence>
  </xsd:complexType>
</xsd:schema>

Example 22.10 - The productName element is renamed to productName2, forcing another change to the namespace value.


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  targetNamespace="http://actioncon.com/schema/po/v2"
  xmlns="http://actioncon.com/schema/po/v2"
  version="2.0">
  <xsd:element name="LineItem" type="LineItemType"/>
  <xsd:complexType name="LineItemType">
    <xsd:sequence>
      <xsd:element name="productID" type="xsd:string"
        minOccurs="0"/>
      <xsd:element name="productName" type="xsd:string"
        minOccurs="0"/>
      <xsd:element name="available" type="xsd:boolean"
        minOccurs="0"/>
    </xsd:sequence>
  </xsd:complexType>
</xsd:schema>

Example 22.11 - The minOccurs attribute set to "0" on all elements within the LineItemType complex type.