This text file contains sample code fragments from:
Section 19.1 - WS-Addressing Messaging Rules
Chapter 19 - Advanced Message Design Part II: WS-Addressing Rules and Design Techniques
Book - Web Service Contract Design & Versioning for SOA
Series - The Prentice Hall Service Technology Series from Thomas Erl
Site - www.servicetechbooks.com


<wsa:ReferenceParameters>
  <act:Instance>
    1
  </act:Instance>
  <act:ClientID>
    id-123-456-abc:01:23
  </act:ClientID>
</wsa:ReferenceParameters>

Example 19.1 - The wsa:ReferenceParameters construct, as defined as part of an EPR.


<soap:Header>
  <wsa:To>
    http://megaeuromart.com/client
  </wsa:To>
  <wsa:From>
    <wsa:Address>
      http://actioncon.com/service
    </wsa:Address>
  </wsa:From>
  <wsa:ReplyTo>
    <wsa:Address>
      http://actioncon.com/service/reply
    </wsa:Address>
    <wsa:ReferenceParameters>
      <act:Instance>
        1
      </act:Instance>
      <act:ClientID>
        id-123-456-abc:01:23
      </act:ClientID>
    </wsa:ReferenceParameters>
  </wsa:ReplyTo>
</soap:Header>

Example 19.2 - The ERP containing the wsa:ReferenceParameters construct is assigned to a wsa:ReplyTo element.


<soap:Header>
  <wsa:To>
    http://actioncon.com/service/reply
  </wsa:To>
  <wsa:From>
    http://megaeuromart.com/client
  </wsa:From>
  <act:Instance wsa:isReferenceParameter="1">
    1
  </act:Instance>
  <act:ClientID wsa:isReferenceParameter="1">
    id-123-456-abc:01:23
  </act:ClientID>
</soap:Header>

Example 19.3 - The complexion of the response SOAP message changes significantly, as the wsa:ReferenceParameters element is stripped away and elements representing custom parameters become individual, peer-level SOAP header blocks. The bolded text highlights the address that was originally in the EPR's wsa:Address element and is now
assigned to the wsa:To element.


<soap:Envelope
  xmlns:soap="http:www.w3.org/2003/05/soap-envelope"
  xmlns:wsa="http://www.w3.org/2005/08/addressing">
  <soap:Header>
    <wsa:To>
      http://megaeuromart.com/client
    </wsa:To>
    <wsa:ReplyTo>
      <wsa:Address>
        http://actioncon.com/service/reply
      </wsa:Address>
      <wsa:ReferenceParameters>
        <act:Instance>
          1
          </act:Instance>
            <act:ClientID>
          id-123-456-abc:01:23
        </act:ClientID>
      </wsa:ReferenceParameters>
    </wsa:ReplyTo>
    <wsa:FaultTo>
      <wsa:Address>
        http://actioncon.com/service/fault
      </wsa:Address>
      <wsa:ReferenceParameters>
        <act:ClientID>
          id-123-456-abc:01:23
        </act:ClientID>
      </wsa:ReferenceParameters>
    </wsa:FaultTo>
    <wsa:Action>
      http://actioncon.com/service/poresponse
    </wsa:Action>
    <wsa:MessageId>
      urn:uuid:246d44f9-5a2f-11d7-944a-006097b0abf
    </wsa:MessageId>
  </soap:Header>
  <soap:Body>
    ...
  </soap:Body>
</soap:Envelope>

Example 19.4 - A message from the Purchase Order endpoint containing an EPR for use by the consumer program.


<soap:Envelope
  xmlns:soap="http:www.w3.org/2003/05/soap-envelope"
  xmlns:wsa="http://www.w3.org/2005/08/addressing">
  <soap:Header>
    <wsa:To>
      http://actioncon.com/service/reply
    </wsa:To>
    <wsa:Action>
      http://actioncon.com/service/posubmit
    </wsa:Action>
    <wsa:RelatesTo>
      urn:uuid:246d44f9-5a2f-11d7-944a-006097b0abf
    </wsa:RelatesTo>
    <act:Instance wsa:isReferenceParameter="1">
      1
    </act:Instance>
    <act:ClientID wsa:isReferenceParameter="1">
      id-123-456-abc:01:23
    </act:ClientID>
  </soap:Header>
  <soap:Body>
    ...
  </soap:Body>
</soap:Envelope>

Example 19.5 - A message that replies to the previous message that contained the EPR.


<soap:Envelope
  xmlns:soap="http:www.w3.org/2003/05/soap-envelope"
  xmlns:wsa="http://www.w3.org/2005/08/addressing">
  <soap:Header>
    <wsa:To>
      http://megaeuromart.com/service/fault
    </wsa:To>
    <wsa:Action>
      http://actioncon.com/service/posubmitfault
    </wsa:Action>
    <wsa:RelatesTo>
      urn:uuid:246d44f9-5a2f-11d7-944a-006097b0abf
    </wsa:RelatesTo>
    <act:ClientID wsa:isReferenceParameter="1">
      id-123-456-abc:01:23
    </act:ClientID>
  </soap:Header>
  <soap:Body>
    ...
  </soap:Body>
</soap:Envelope>

Example 19.6 - A sample fault message sent as a reply by the consumer instead of the message in the previous example.