"soap:body" - Binding for SOAP Body

WSDL Tutorials - Herong's Tutorial Examples

∟WSDL 1.1 Binding Extension for SOAP 1.1

∟"soap:body" - Binding for SOAP Body

This section describes 'soap:body', a SOAP extension element that specifies how the SOAP Body should be constructed in the SOAP message for an operation input and output. 'literal' means no encoding.

"soap:body" is a SOAP extension element used as a sub element of the "wsdl:input" or "wsdl:output" element inside the "wsdl:binding" and "wsdl:operation" element structure. "soap:body" is used to provide information on how the content of the SOAP Body element is constructed. The syntax of "soap:body" looks like this:

<wsdl:definitions ...>
  <wsdl:binding ...>
    <wsdl:operation ...>
      <wsdl:input>
        <soap:body parts="nmtokens" use="literal|encoded"
          encodingStyle="uri-list" namespace="uri"/>
      </wsdl:input>
      <wsdl:output>
        <soap:body parts="nmtokens" use="literal|encoded"
          encodingStyle="uri-list" namespace="uri"/>
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>
</wsdl:definitions>

Notes on the "soap:body" element:

parts="nmtokens" - Indicates with part or parts defined in the input or output message (specified through the "wsdl:portType" element) are used to construct this SOAP Body. If not provided, all parts are used.
use="literal|encoded" - Indicates whether the message part(s) should be used as is (literal) or encoded. This is a required attribute. If use="literal", the message part(s) are referring to concrete schema definition(s) and no encoding is needed. If use="encoded", the message part(s) are referring to abstract schema definition(s) and concrete message can be produced by applying the specified encoding style.
encodingStyle="uri-list" - Indicates encoding style(s) to be used in case of use="encoded".
namespace="uri" - Indicates the namespace to be used in case of use="encoded".

Here is an example of "soap:operation" element:

  <wsdl:binding name="helloBinding" type="hy:helloPortType">
    <soap:binding style="document"
      transport="http://schemas.xmlsoap.org/soap/http"/>
    <wsdl:operation name="Hello">
      <soap:operation
        soapAction="https://www.herongyang.com/Service/Hello"/>
      <wsdl:input name="helloInput">
        <soap:body use="literal"/>
      </wsdl:input>
      <wsdl:output name="helloOutput">
        <soap:body use="literal"/>
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>

In this example,

use="literal" indicates that no encoding is needed. My message parts for "helloInput" and "helloOutput" have concrete schema definitions.
parts="nmtokens" is not specified. So all message parts defined for "helloInput" should be used to construct the SOAP Body for the SOAP request. Add all message parts defined for "helloOutput" should be used to construct the SOAP Body for the SOAP response.