This text file contains sample code fragments from:
Section 15.4 - Custom Header Blocks and Header Faults
Chapter 15 - Advanced WSDL Part II: Message Dispatch, Service Instance Identification, and Non-SOAP HTTP Binding
Book - Web Service Contract Design & Versioning for SOA
Series - Prentice Hall Service-Oriented Computing Series from Thomas Erl
Site - www.soabooks.com


<types>
  <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns="http://actioncon.com/schema/purchasing"
    targetNamespace="http://actioncon.com/schema/purchasing"
    elementFormDefault="qualified">
    <xsd:element name="purchaseOrder"
      type="PurchaseOrderType"/>
    <xsd:element name="purchaseOrderResponse"
      type="PurchaseOrderResponseType"/>
    <xsd:element name="headerElement"
      type="HeaderType"/>
    <xsd:element name="responseHeaderElement"
      type="ResponseHeaderType"/>
    <xsd:element name="headerFaultElement"
      type="HeaderFaultType"/>
    <xsd:complexType name="PurchaseOrderType">
      ...
    </xsd:complexType>
    <xsd:complexType name="PurchaseOrderResponseType">
      ...
    </xsd:complexType>
    <xsd:complexType name="HeaderType">
      ...
    </xsd:complexType>
    <xsd:complexType name="ResponseHeaderType">
      ...
    </xsd:complexType>
    <xsd:complexType name="PurchaseOrderType">
      ...
    </xsd:complexType>
    ...
  </xsd:schema>
</types>

Example 15.20 - The three global element declarations representing the header-related types.


<message name="msgPurchaseOrderRequest">
  <part name="PurchaseOrder" element="po:purchaseOrder/>
  <part name="HeaderPart" element="po:headerElement"/>
</message>
<message name="msgPurchaseOrderResponse">
  <part name="PurchaseOrderResponse"
    element="po:purchaseOrderResponse/>
  <part name="ResponseHeaderPart" element=
    "po:responseHeaderElement"/>
  <part name="responseHeaderFaultPart" element=
    "po:headerFaultElement"/>
</message>

Example 15.21 - The three header-related global elements assigned to the element attributes of part elements.


<portType name="ptPurchaseOrder">
  <operation name="opSubmitOrder">
    <input message="tns:msgPurchaseOrderRequest"/>
    <output message="tns:msgPurchaseOrderResponse"/>
  </operation>
  ...
</portType>

Example 15.22 - The three global element declarations representing the header-related types.


<binding name="bdPurchaseOrder" type="ptPurchaseOrder">
<soap11bind:binding style="document" .... >
  <operation name="opSubmitOrder"
    soapAction="http://actioncon.com/submitOrder/request">
    <input message="tns:msgSubmitOrderRequest">
      <soap11bind:body parts="tns:PurchaseOrder"
        use="literal"/>
      <soap11:header message="msgPurchaseOrderRequest"
        part="HeaderPart"/>
    </input>
    <output message="tns:msgSubmitOrderResponse">
      <soap11bind:body parts="tns:PurchaseOrderResponse"
        use="literal"/>
      <soap11:header message="msgPurchaseOrderResponse"
        part="ResponseHeaderPart">
      <soap11:headerfault message="msgPurchaseOrderResponse"
        part="ResponseHeaderFaultPart"/>
      </soap11:header>
    </input>
  </operation>
  ...
</binding>

Example 15.23 - The binding construct hosting SOAP binding extensibility elements that are used to assign the part elements from the message definitions to the header portions of input and output SOAP messages.


<message name="msgSubmitOrderRequest">
  <part name="SecurityHeader" element="po:securityType"/>
  <part name="PurchaseOrder" element="po:purchaseOrder"/>
</message>
<message name="msgSubmitOrderResponse">
  <part name="Acknowledgement" element="po:acknowledgement"/>
</message>

Example 15.24 - The msgSubmitOrderRequest message definition with a SecurityHeader part element that will be assigned to the SOAP header section.


<binding ...>
  <operation name="opSubmitOrder">
    <input>
      <soap11:body use="literal" part="PurchaseOrder"/>
      <soap11:header message="tns:msgSubmitOrderRequest"
        part="SecurityHeader" use="literal"/>
    </input>
    <output>
      <soap11:body use="literal"/>
    </output>
  </operation>
  ...
</binding>

Example 15.25 - The binding construct with a SOAP extensibility header element used to assign the SecurityHeader part to the input message of the opSubmitOrder operation.


<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" ...>
  <soap:Header>
      <po:security
        xmlns:po="http://actioncon.com/schema/purchasing">
          secret
      </po:security>
  </soap:Header>
  <soap:Body>
    ...
  </soap:Body>
</soap:Envelope>

Example 15.26 - The highlighted text represents the po:securityType construct that represents the header block as it might exist in an actual SOAP message.


<soap:header element="po:securityType" mustUnderstand="true"
  wsdl:required="true"/>