This text file contains sample code fragments from:
Section 21.1 - Version Identifiers and WSDL Definitions
Chapter 21 - Versioning WSDL Definitions
Book - Web Service Contract Design & Versioning for SOA
Series - The Prentice Hall Service Technology Series from Thomas Erl
Site - www.servicetechbooks.com


<definitions name="PurchaseOrder" targetNamespace=
  "http://actioncon.com/contract/po/v2"
  xmlns="http://schemas.xmlsoap.org/wsdl/"
  xmlns:tns="http://actioncon.com/contract/po/v2"
  xmlns:po="http://actioncon.com/schema/po"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <documentation>Version 2.1</documentation>
  ...
</definitions>

Example 21.1 - The definitions element with a target namespace that indicates that this is the second version of the Web service contract.


<definitions name="PurchaseOrder" targetNamespace=
  "http://actioncon.com/contract/po/v2"
  xmlns="http://schemas.xmlsoap.org/wsdl/"
  xmlns:tns=" http://actioncon.com/contract/po/v2"
  xmlns:po="http://actioncon.com/schema/po"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <documentation>Version 2.1</documentation>
  <types>
    <xsd:schema>
      <xsd:import namespace="http://actioncon.com/schema/po"
        schemaLocation=
        "http://actioncon.com/schema/purchaseOrder.xsd"/>
    </xsd:schema>
  </types>
  <message name="msgSubmitOrderRequest">
    <part name="PurchaseOrder" element="po:purchaseOrder"/>
  </message>
  <message name="msgSubmitOrderResponse">
    <part name="Acknowledgement" element="po:acknowledgement"/>
  </message>
  <message name="msgCheckOrderRequest">
    <part name="PONumber" element="po:poNumber"/>
  </message>
  <message name="msgCheckOrderResponse">
    <part name="Status" element="po:status"/>
  </message>
  <message name="msgChangeOrderRequest">
    <part name="PurchaseOrder" element="po:purchaseOrder"/>
  </message>
  <message name="msgChangeOrderResponse">
    <part name="Acknowledgement" element="po:acknowledgement"/>
  </message>
  <message name="msgCancelOrderRequest">
    <part name="PONumber" element="po:poNumber"/>
  </message>
  <message name="msgCancelOrderResponse">
    <part name="Acknowledgement" element="po:acknowledgement"/>
  </message>
  <portType name="ptPurchaseOrder">
    <operation name="opSubmitOrder">
      <input message="tns:msgSubmitOrderRequest"/>
      <output message="tns:msgSubmitOrderResponse"/>
    </operation>
    <operation name="opCheckOrderStatus">
      <input message="tns:msgCheckOrderRequest"/>
      <output message="tns:msgCheckOrderResponse"/>
    </operation>
    <operation name="opChangeOrder">
      <input message="tns:msgChangeOrderRequest"/>
      <output message="tns:msgChangeOrderResponse"/>
    </operation>
    <operation name="opCancelOrder">
      <input message="tns:msgCancelOrderRequest"/>
      <output message="tns:msgCancelOrderResponse"/>
    </operation>
  </portType>
  ...
</definitions>

Example 21.2 - The abstract description of version 2.1 of the Purchase Order WSDL definition prior to being impacted by further changes that impose additional versioning requirements.