This text file contains sample code fragments from:
Section 23.4 - Expressing Termination Information
Chapter 23 - Advanced Versioning
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" ...>
  <documentation>
    This service is scheduled for termination on Jan 31, 2010.
  </documentation>
  ...
</definitions>

Example 23.11 - A human-readable annotation with termination details added via the documentation construct.


<wsp:Policy ...>
  <custom:termination wsp:Ignorable="true">
    Jan-31-2010
  </custom:termination>
</wsp:Policy>

Example 23.12 - Termination information expressed via an ignorable policy assertion.


<wsp:Policy ...>
  <wsp:ExactlyOne>
    <wsp:All>
      <wsa:UsingAddressing/>
      <custom:termination wsp:Ignorable="true">
        Jan-31-2010
      </custom:termination>
    </wsp:All>
    <wsp:All>
      <wsa:UsingAddressing/>
      <wsrmp:RMAssertion/>
    </wsp:All>
  </wsp:ExactlyOne>
</wsp:Policy>

Example 23.13 - The custom:termination assertion as part of a policy alternative.


<wsp:Policy ...>
  <custom:termination wsp:Ignorable="false">
    Jan-31-2010
  </custom:termination>
</wsp:Policy>

Example 23.14 - A custom termination assertion that is not ignorable. (In this case, the wsp:Ignorable attribute could have been omitted altogether because it has a setting of "false" by default.)


<wsp:Policy ...>
  <custom:termination wsp:Ignorable="false">
    nil
  </custom:termination>
</wsp:Policy>

Example 23.15 - An example of a custom value that expresses that the service has no current termination date.


<binding name="bdPO" type="abs:ptPurchaseOrder">
  <operation name="opSubmitOrder">
    <wsp:Policy>
      <custom:termination wsp:Ignorable="true">
        Jan-31-2010
      </custom:termination>
    </wsp:Policy>
    <soap12bind:operation
      soapAction="http://action.com/submitOrder/request"
      soapActionRequired="true" required="true"/>
    <input>
      <soap12bind:body use="literal"/>
    </input>
    <output>
      <soap12bind:body use="literal"/>
    </output>
  </operation>
  <operation name="opSubmitOrders">
    <soap12bind:operation
      soapAction="http://action.com/submitOrder/request"
      soapActionRequired="true" required="true"/>
    <input>
      <soap12bind:body use="literal"/>
    </input>
    <output>
      <soap12bind:body use="literal"/>
    </output>
  </operation>
  ...
</binding>

Example 23.16 - The ignorable custom:termination policy assertion attached to a specific operation.


<definitions targetNamespace=
  "http://actioncon.com/contract/po/binding/v2"
  xmlns:tns=" http://actioncon.com/contract/po/binding/v2"
  xmlns:abs="http://actioncon.com/contract/po"
  xmlns="http://schemas.xmlsoap.org/wsdl/"
  xmlns:po="http://actioncon.com/schema/po"
  xmlns:soap11="http://schemas.xmlsoap.org/wsdl/soap/">
  <import
    namespace="http://actioncon.com/contract/po"
    location="http://actioncon.com/contract/po"/>
  <binding name="bdPO-v2" type="abs:ptPurchaseOrder">
    <operation name="opSubmitOrder">
    <wsp:Policy>
      <custom:termination wsp:Ignorable="true">
        Jan-31-2009
      </custom:termination>
    </wsp:Policy>
    <soap12bind:operation
      soapAction="http://action.com/submitOrder/request"
      soapActionRequired="true" required="true"/>
    <input>
      <soap12bind:body use="literal"/>
    </input>
    <output>
      <soap12bind:body use="literal"/>
    </output>
  </operation>
  <operation name="opSubmitOrders">
    <wsp:Policy>
      <custom:termination wsp:Ignorable="true">
        Mar-07-2010
      </custom:termination>
    </wsp:Policy>
    <soap12bind:operation
      soapAction="http://action.com/submitOrder/request"
      soapActionRequired="true" required="true"/>
    <input>
      <soap12bind:body use="literal"/>
    </input>
    <output>
      <soap12bind:body use="literal"/>
    </output>
  </operation>
  ...
  </binding>
</definitions>

Example 23.17 - Separate ignorable policies attached to different operation elements. Each assertion expresses a different termination date.