This text file contains sample code fragments from:
Section 23.1 - Versioning Policies
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


<!-- Purchase Order Policy v1.0 -->
<wsp:Policy>
  <wsa:UsingAddressing/>
</wsp:Policy>

Example 23.1 - Version 1.0 of a simple policy expression.


<!-- Purchase Order Policy v2.0 -->
<wsp:Policy>
  <wsa:UsingAddressing/>
  <wsrmp:RMAssertion/>
</wsp:Policy>

Example 23.2 - A new policy assertion is added to the policy expression, thereby incrementing its version number.


<wsp:Policy>
  <wsp:ExactlyOne>

<!-- Purchase Order Policy v1.0 -->
  <wsp:All>
    <wsa:UsingAddressing/>
  </wsp:All>

<!-- Purchase Order Policy v1.1 -->
  <wsp:All>
    <wsa:UsingAddressing/>
    <wsrmp:RMAssertion/>
  </wsp:All>

  </wsp:ExactlyOne>
</wsp:Policy>

Example 23.3 - Version 1.1 of the policy expression which now provides an alternative containing two assertions.


<!-- Purchase Order Policy v1.1 -->
<wsp:Policy>
  <wsa:UsingAddressing/>
  <wsrmp:RMAssertion wsp:Optional="true" />
</wsp:Policy>

Example 23.4 - Version 1.1 of a policy expression that has been extended with an optional assertion.


<!-- Purchase Order Policy v2.0 -->
<wsp:Policy>
  <wsa:UsingAddressing/>
  <custom:LogMessage wsp:Ignorable/>
</wsp:Policy>

Example 23.5 - Version 2.0 of a policy expression that has been extended with an ignorable assertion considered an incompatible change.


<service name="svPurchaseOrder">
  <port name="purchaseOrder-http-soap12-v1"
    binding="tns:bdPO-SOAP12HTTP">
    <wsp:Policy>
    <wsam:Addressing>
  </wsp:Policy>
  <soap12:address location=
    "http://actioncon.com/services/soap12/po"/>
  </port>
  <port name="purchaseOrder-http-soap12-v2"
    binding="tns:bdPO-SOAP12HTTP">
    <wsp:Policy>
      <wsam:Addressing>
      <custom:LogMessage wsp:Ignorable/>
    </wsp:Policy>
    <soap12:address location=
      "http://actioncon.com/services/soap12/po"/>
  </port>
</service>

Example 23.6 - A policy expression is attached to a second port element within a service construct.