This text file contains sample code fragments from:
Section 16.1 - Reusability and Policy Centralization
Chapter 16 - Advanced WS-Policy Part I: Policy Centralization and Nested, Parameterized, and Ignorable Assertions
Book - Web Service Contract Design & Versioning for SOA
Series - Prentice Hall Service-Oriented Computing Series from Thomas Erl
Site - www.soabooks.com


<wsp:PolicyAttachment>
  ...
  <wsp:Policy>
    <wsam:Addressing><wsp:Policy/></wsam:Addressing>
    <wsrmp:RMAssertion optional="true"/>
  </wsp:Policy>
</wsp:PolicyAttachment>

Example 16.1 - A wsp:PolicyAttachment construct containing a policy expression. This code presumably resides in a separate policy definition document.


<wsp:PolicyAttachment>
  <wsp:AppliesTo>
    <wsp:URI>
      http://actioncon.com/purchaseOrder.wsdl20
      #wsdl.endpoint(PurchaseOrderService/Endpoint)
    </wsp:URI>
  </wsp:AppliesTo>
  <wsp:Policy>
    <wsam:Addressing><wsp:Policy/></wsam:Addressing>
    <wsrmp:RMAssertion optional="true"/>
  </wsp:Policy>
</wsp:PolicyAttachment>

Example 16.2 - The wsp:AppliesTo and wsp:URI child elements with a URL that identifies the target element of the policy.


<portType name="ptPurchaseOrder"
  wsp:PolicyURIs="custom:commonPolicies.xml">
  <operation name="opSubmitOrder">
    <input message="tns:msgSubmitOrderRequest"/>
    <output message="tns:msgsubmitOrderResponse"/>
  </operation>
  ...
</portType>

Example 16.3 - The portType element is extended with the wsp:PolicyURIs attribute.


<wsp:Policy Name="http://actioncon.com/policies/common">
  <wsam:Addressing><wsp:Policy/></wsam:Addressing>
</wsp:Policy>

Example 16.4 - A wsp:Policy construct residing within a separate policy definition document. The Name attribute provides the policy expression with an externally "referenceable" identifier.


<wsp:PolicyReference
  URI="http://actioncon.com/policies/common"/>

Example 16.5 - A wsp:PolicyReference element that points to the previously displayed wsp:Policy construct via the URI attribute.


<definitions targetNamespace=
  "http://actioncon.com/policies/common">
  <wsp:Policy wsu:Id="addressing-policy">
    <wsam:Addressing><wsp:Policy/></wsam:Addressing>
  </wsp:Policy>
  ...
</definitions>

Example 16.6 - A WSDL definitions construct that acts as a container for common policies.


<definitions targetNamespace=
  "http://actioncon.com/contract/PurchaseOrder" ...>
  <import
    namespace="http://actioncon.com/policies/common"
    location="http://actioncon.com/policies/common"/>
  ...
  <wsp:PolicyReference URI="#addressing-policy"/>
  ...
</definitions>

Example 16.7 - An example of a WSDL definition that includes a wsp:PolicyReference statement that points to an imported wsp:Policy construct. If you check back to the Attaching Policies to WSDL Definitions section from Chapter 10, you can see that this code resembles the same syntax used for local references within a WSDL document. 


<wsp:Policy Name="http://actioncon.com/policies/common">
  <wsam:Addressing><wsp:Policy/></wsam:Addressing>
</wsp:Policy>

Example 16.9 - By virtue of the fact that this simple policy expression is part of a global policy definition, it is expected to extend all Web service contracts within Steve's planned service inventory.