This text file contains sample code fragments from:
Section 19.2 - EPRs and WSDL Binding
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:EndpointReference ...>
  <wsa:Address>
    http://actioncon.com/service
  </wsa:Address>
  <wsa:Metadata>
    <wsam:InterfaceName>
      act:ptPurchaseOrder
    </wsam:InterfaceName>
    <wsam:ServiceName>
      act:svPurchaseOrder
    </wsam:ServiceName>
  </wsa:Metadata>
</wsa:EndpointReference>

Example 19.7 - This EPR contains a wsa:Metadata construct that has references to the portType and service elements from the Purchase Order WSDL definition described in Chapter 8.


<service name="svPurchaseOrder">
  <port name="purchaseOrder-http-soap11"
    binding="tns:bdPO-SOAP11HTTP">
    <soap11:address location=
      "http://actioncon.com/services/soap11/purchaseOrder"/>
  </port>
  <port name="purchaseOrder-http-soap12"
    binding="tns:bdPO-SOAP12HTTP">
    <soap12:address location=
      "http://actioncon.com/services/soap12/purchaseOrder"/>
  </port>
</service>

Example 19.8 - The entire service contract from the concrete WSDL description that was built in Chapter 8.


<wsa:EndpointReference ...>
  ...
  <wsa:Metadata>
    <wsam:InterfaceName>
      act:ptPurchaseOrder
    </wsam:InterfaceName>
    <wsam:ServiceName
      EndpointName="act:purchaseOrder-http-soap11">
      act:svPurchaseOrder
    </wsam:ServiceName>
  </wsa:Metadata>
</wsa:EndpointReference>

Example 19.9 - The EndpointName attribute is added to limit access to the Web service endpoint to a specific port.


<wsa:EndpointReference ...>
  <wsa:Metadata
    xmlns:wsdli="http://www.w3.org/ns/wsdl-instance"
    wsdli:wsdlLocation="http://actioncon.com/contract/po">
    ...
  </wsa:Metadata>
</wsa:EndpointReference>

Example 19.10 - The wsdli:wsdlLocation attribute is added to the wsa:Metadata element.


<definitions ...>
  ...
  <service name="svPurchaseOrder">
    <port name="purchaseOrder-http-soap11"
      binding="tns:bdPO-SOAP11HTTP">
      <soap11:address location=
        "http://actioncon.com/services/soap11/purchaseOrder"/>
      <wsa:EndpointReference xmlns:act="...">
        <wsa:Address>
          http://actioncon.com/services/soap11/purchaseOrder
        </wsa:Address>
        <wsa:ReferenceParameters>
          <act:Instance>
            1
          </act:Instance>
        </wsa:ReferenceParameters>
      </wsa:EndpointReference>
    </port>
  </service>
</definitions>

Example 19.11 - An entire wsa:EndpointReference construct, embedded within a WSDL service construct, as an extensibility element for the port element.


<soap:Envelope
  xmlns:soap="http:www.w3.org/2003/05/soap-envelope"
  xmlns:wsa="http://www.w3.org/2005/08/addressing"
  xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata">
  <soap:Header>
    <wsa:From soap:mustUnderstand="1">
      <wsa:Address>
        http://actioncon.com/service
      </wsa:Address>
      <wsa:Metadata xmlns:po=
        "http://actioncon.com/contract/po"
        xmlns:wsdli="http://www.w3.org/ns/wsdl-instance"
        wsdli:location=
          "http://actioncon.com/contract/po">
        <wsam:InterfaceName>
          po:ptPurchaseOrder
        </wsam:InterfaceName>
        <wsam:ServiceName
          EndpointName="purchaseOrder-http-soap12">
          po:svPurchaseOrder
        </wsam:ServiceName>
      </wsa:Metadata>
    </wsa:From>
    <wsa:To soap:mustUnderstand="1">
      http://megaeuromart.com/partner/ActionCon/reply
    </wsa:To>
    <wsa:Action soap:mustUnderstand="1">
      http://actioncon.com/action/poresponse
    </wsa:Action>
    <wsa:RelatesTo soap:mustUnderstand="1">
      urn:uuid:a46d54f9-5d2f-21d7-944a-106097bf065
    </wsa:RelatesTo>
    <wsa:MessageId>
      urn:uuid:246d44f9-5a2f-11d7-944a-006097b0abf
    </wsa:MessageId>
  </soap:Header>
  <soap:Body>
    <acknowledgement
      xmlns="http://actioncon.com/schema/po"
      version="1.0">
      ...
      </acknowledgement>
  </soap:Body>
</soap:Envelope>

Example 19.12 - An acknowledgement message sent by the Purchase Order Web service with additional wsa:Metadata elements that make the message more descriptive.