This text file contains sample code fragments from:
Section 17.1 - Designing Custom Policy Assertions
Chapter 17 - Advanced WS-Policy Part II: Custom Policy Assertion Design, Runtime Representation, and Compatibility
Book - Web Service Contract Design & Versioning for SOA
Series - Prentice Hall Service-Oriented Computing Series from Thomas Erl
Site - www.soabooks.com


<wsp:Policy
  xmlns:wsam=" http://www.w3.org/2007/05/addressing/metadata">
  <wsam:Addressing><wsp:Policy/></wsam:Addressing>
</wsp:Policy>

Example 17.1 - The standard wsam:Addressing assertion we've been using in many examples.


<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE xsd:schema (View Source for full doctype...)>
<!-- W3C XML Schema defined in the Web Services Addressing 1.0 - Metadata specification
http://www.w3.org/TR/ws-addr-metadata Copyright c 2007 World Wide Web Consortium,
(Massachusetts Institute of Technology, European Research Consortium for Informatics
and Mathematics, Keio University). All Rights Reserved. This work is distributed under
the W3CR Software License [1] in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. [1] http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231 $Id:
ws-addr-metadata.xsd,v 1.1 2007/05/15 15:03:00 plehegar Exp $ -->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
  xmlns:tns="http://www.w3.org/2007/05/addressing/metadata"
  xmlns:wsp="http://www.w3.org/2006/07/ws-policy"
  targetNamespace=
    "http://www.w3.org/2007/05/addressing/metadata"
  blockDefault="#all" elementFormDefault="qualified"
  finalDefault="" attributeFormDefault="unqualified">
  <xs:element name="ServiceName"
    type="tns:ServiceNameType" />
  <xs:complexType name="ServiceNameType" mixed="false">
    <xs:simpleContent>
      <xs:extension base="xs:QName">
        <xs:attribute name="EndpointName" type="xs:NCName"
          use="optional" />
        <xs:anyAttribute namespace="##other"
          processContents="lax" />
      </xs:extension>
    </xs:simpleContent>
  </xs:complexType>
  <xs:element name="InterfaceName"
    type="tns:AttributedQNameType" />
  <xs:complexType name="AttributedQNameType" mixed="false">
    <xs:simpleContent>
      <xs:extension base="xs:QName">
        <xs:anyAttribute namespace="##other"
          processContents="lax" />
      </xs:extension>
    </xs:simpleContent>
  </xs:complexType>
  <xs:attribute name="Action" type="xs:anyURI" />
  <!-- WS-Policy assertions -->
  <xs:element name="Addressing">
    <xs:complexType mixed="false">
      <xs:sequence>
      <xs:element ref="wsp:Policy" />
      </xs:sequence>
        <xs:anyAttribute namespace="##other"
          processContents="lax" />
    </xs:complexType>
  </xs:element>
    <xs:element name="AnonymousResponses">
      <xs:complexType mixed="false">
        <xs:anyAttribute namespace="##other"
          processContents="lax" />
      </xs:complexType>
  </xs:element>
    <xs:element name="NonAnonymousResponses">
      <xs:complexType mixed="false">
        <xs:anyAttribute namespace="##other"
          processContents="lax" />
      </xs:complexType>
  </xs:element>
</xs:schema>

Example 17.2 - The W3C XML Schema definition that provides the element declaration for the wsam:Addressing policy assertion. Note the use of the xs:anyAttribute element that allows for extensibility attributes, such as wsp:Optional or wsp:Ignorable, to be added when required. (You can access this schema at: http://www.w3.org/2007/05/addressing/metadata/.)


<wsp:Policy ...>
  <custom:TraceMessage wsp:Ignorable="true"/>
</wsp:Policy>

Example 17.3 - The custom:TraceMessage assertion from the Ignorable Assertions section in Chapter 16.


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  targetNamespace="http://actioncon.com/policy/custom">
  <xsd:element name="TraceMessage">
    <xsd:complexType mixed="false">
      <xsd:anyAttribute namespace="##other"
        processContents="lax" />
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

Example 17.4 - A simple XML Schema that defines the type for the TraceMessage global element.


<wsp:Policy
  xmlns:custom="http://actioncon.com/policy/custom">
  <custom:TraceMessage wsp:Ignorable="true"/>
</wsp:Policy>

Example 17.5 - The completed policy expression, now including the namespace used to reference the target namespace of the XML schema for the TraceMessage global element.

<wsp:Policy
  xmlns:custom="http://actioncon.com/policy/custom">
  <custom:TraceMessageDetail wsp:Optional="true"/>
</wsp:Policy>

Example 17.6 - The optional custom:TraceMessageDetail assertion. (This is a separate example from Example 17.5, meaning that this assertion is not related to the custom:TraceMessage assertion we explained earlier.)


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  targetNamespace="http://actioncon.com/policy/custom"
  xmlns="http://actioncon.com/policy/custom"
  elementFormDefault="qualified">
  <xsd:element name="TraceMessageDetail" type="TraceType"/>
  <xsd:complexType name="TraceType">
    <xsd:sequence>
      <xsd:element name="TraceID" type="xsd:int"/>
      <xsd:element name="TraceCode" type="xsd:string"/>
    </xsd:sequence>
    <xsd:attribute name="TimeStamp" type="xsd:dateTime"/>
    <xsd:anyAttribute namespace="##other"
      processContents="lax" />
    </xsd:complexType>
  </xsd:schema>

Example 17.7
An XML schema that corresponds to the XML document instance from the previous example. The statements associated with the highlighted name attributes give us an idea of how an XML schema defines the structure of an XML document.


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  targetNamespace="http://actioncon.com/policy/custom">
  <xsd:element name="LogMessage">
    <xsd:complexType mixed="false">
      <xsd:anyAttribute namespace="##other"
        processContents="lax" />
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

Example 17.8 - The XML Schema definition for the custom:LogMessage assertion.


<wsp:Policy Name="http://actioncon.com/policies/finance"
  xmlns:custom="http://actioncon.com/policy/custom"
  xmlns:wsp="http://www.w3.org/2006/07/ws-policy"
  ...>
  <wsp:All>
    <custom:LogMessage wsp:Ignorable="true"/>
    <wsp:ExactlyOne>
      <sp:TransportBinding>
        ...
      </sp:TransportBinding>
      <sp:SymmetricBinding>
        ...
      </sp:SymmetricBinding>
    </sp:ExactlyOne>
  </wsp:All>
</wsp:Policy>

Example 17.9 - The WS-Policy definition for the custom:LogMessage assertion.


<?xml version="1.0" encoding="utf-8" ?>
<xs:schema targetNamespace=
  "http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"
  xmlns:tns=
    "http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"
  xmlns:wsp=
    "http://schemas.xmlsoap.org/ws/2004/09/policy"
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  elementFormDefault="qualified"
  blockDefault="#all">
  ...
  <xs:complexType name="NestedPolicyType">
    <xs:sequence>
      <xs:element ref="wsp:Policy" />
      <xs:any minOccurs="0" maxOccurs="unbounded"
        namespace="##other" processContents="lax" />
    </xs:sequence>
    <xs:anyAttribute namespace="##any"
      processContents="lax" />
  </xs:complexType>
  ...
  <xs:element name="TransportBinding"
    type="tns:NestedPolicyType">
      <xs:annotation>
        <xs:documentation xml:lang="en">
          8.3 TransportBinding Assertion
        </xs:documentation>
      </xs:annotation>
  </xs:element>
  ...
  <xs:element name="SymmetricBinding"
    type="tns:NestedPolicyType">
    <xs:annotation>
      <xs:documentation xml:lang="en">
        8.4 SymmetricBinding Assertion
      </xs:documentation>
    </xs:annotation>
  </xs:element>
  ...
</xs:schema>

Example 17.10 - Some excerpts from the OASIS WS-SecurityPolicy XML Schema definition for the sp:TransportBinding and sp:SymmetricBinding assertions.


<wsp:Policy
  xmlns:wsam=" http://www.w3.org/2007/05/addressing/metadata"
  xmlns:custom="http://actioncon.com/policy/custom">
  <wsam:Addressing custom:ActionconMetadata="true"/>
</wsp:Policy>

Example 17.11 - The wsam:Addressing assertion being extended by a custom attribute.


<wsp:Policy
  xmlns:wsam=" http://www.w3.org/2007/05/addressing/metadata"
  xmlns:custom="http://actioncon.com/policy/custom">
  <wsam:Addressing><wsp:Policy/></wsam:Addressing>
  <custom:ActionconMetadata wsp:Optional="true"/>
</wsp:Policy>

Example 17.12 - A policy expression containing the wsam:Addressing assertion along with the optional custom:ActionconMetadata assertion.