This text file contains sample code fragments from:
Section 11.3 - SOAP Header Blocks and Targeted Processing
Chapter 11 - Fundamental Message Design: SOAP Envelope Structure, Fault Messages, and Header Processing
Book - Web Service Contract Design & Versioning for SOA
Series - Prentice Hall Service-Oriented Computing Series from Thomas Erl
Site - www.soabooks.com


<soap:Header>
  <wsse:Security soap:role=
    "http://megaeuromart.com/soap/roles/signature-verification" ...>
      ...
  </wsse:Security>
</soap:Header>

Example 11.5 - A header block comprised of a wsse:Security element with a soap:role attribute.


<soap:Header>
  <wsse:Security soap:role=
    "http://www.w3.org/2003/05/soap-envelope/role/next" ...>
    ...
  </wsse:Security>
</soap:Header>

Example 11.6 - The same wsse:Security header block from Example 11.5, except the soap:role attribute value has been changed to "next."


<soap:Header>
  <wsse:Security soap:role=
    "http://www.w3.org/2003/05/soap-envelope/role/none" ...>
    ...
  </wsse:Security>
</soap:Header>

Example 11.7 - The wsse:Security header now with a soap:role setting of "none."


<soap:Envelope
  xmlns:soap="http://www.w3.org/2003/05/soap-envelope" ...>
  <soap:Header>
    <wsse:Security soap:role="http://megaeuromart.com/soap/roles/
      signature-verification" ...>
      <wsse:BinarySecurityToken ...>
        ...
      </wsse:BinarySecurityToken>
      <ds:Signature>
        ...
      </ds:Signature>
    </wsse:Security>
  </soap:Header
  <soap:Body ...>
    <po:poNumber xmlns:po="http://actioncon.com/schema/po">
      123456
    </po:poNumber>
  </soap:Body>
</soap:Envelope>

Example 11.8
The same header block from Example 11.5 positioned within the overall envelope.


<soap:Header>
  <wsse:Security soap:role=
    "http://megaeuromart.com/soap/roles/signature-verification"
    soap:mustUnderstand="true" ...>
    ...
  </wsse:Security>
</soap:Header>

Example 11.9 - The wsse:Security element with a soap:mustUnderstand attribute.


<soap:Envelope ...>
  <soap:Header>
    <wsa:Action soap:mustUnderstand="1">
      http://actioncon.com/action/po
    </wsa:Action>
    <wsa:MessageID soap:mustUnderstand="1">
      uuid:246d44f9-5a2f-11d7-944a-006097b0abf
    </wsa:MessageId>
    <custom:ActivityID soap:mustUnderstand="0">
      39930
    </custom:ActivityID>
  </soap:Header>
  <soap:Body>
    <purchaseOrder version="1.0"
      xmlns="http://actioncon.com/schema/po">
      ...
    </purchaseOrder>
  </soap:Body>
</soap:Envelope>

Example 11.10 - A SOAP message with three WS-Addressing header blocks with varying soap:MustUnderstand settings.


<soap:Envelope
  xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
  xmlns:rep="http://www.w3.org/2004/08/representation"
  xmlns:xmlmime="http://www.w3.org/2004/11/xmlmime">
  <soap:Header>
    <rep:Representation
      resource="http://www.actioncon.com/photo">
      <rep:Data xmlmime:contentType="image/jpg">
        ...
      </rep:Data>
    </rep:Representation>
  </soap:Header>
  <soap:Body>
    ...
  </soap:Body>
</soap:Envelope>

Example 11.11 - A SOAP message containing the rep:Representation header.


<soap:Envelope
  xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
  xmlns:wsrm="http://docs.oasis-open.org/ws-rx/wsrm/200702">
  <soap:Header>
    <wsrm:Sequence>
      <wsrm:Identifier>
        http://actioncon.com/rm/123
      </wsrm:Identifier>
      <wsrm:MessageNumber>
        4
      </wsrm:MessageNumber>
    </wsrm:Sequence>
  </soap:Header>
  <soap:Body>
    ...
  </soap:Body>
</soap:Envelope>

Example 11.12  - A SOAP message containing the wsrm:Sequence header.


<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
  xmlns:wscoor=
    "http://docs.oasis-open.org/ws-tx/wscoor/2006/06"
  xmlns:wsa:"http://www.w3.org/2005/08/addressing" >
  <soap:Header>
    <wscoor:CoordinationContext
      <wscoor:Identifier>
        http://actioncon.com/activity-1
      </wscoor:Identifier>
      <wscoor:Expires>
        4000
      </wscoor:Expires>
      <wscoor:CoordinationType>
        http://docs.oasis-open.org/ws-tx/wsat/2006/06
      </wscoor:CoordinationType>
      <wscoor:RegistrationService>
        <wsa:Address>
          http://actioncon.com/registration
        </wsa:Address>
      </wscoor:RegistrationService>
    </wscoor:CoordinationContext>
  </soap:Header>
  <soap:Body>
    ...
  </soap:Body>
</soap:Envelope>

Example 11.13 - A SOAP message containing the wscoor:CoordinationContext header block comprised of a variety of nested elements, including elements from the WS-Addressing standard.