2004-08-03 diff-marked version: Web Services Description Language (WSDL) Version 1.2 2.0 Part 3: Bindings

2.4.1 Description

An [owner] of <code> Every SOAP binding </code> MUST indicate what underlying protocol is in use, as defined in the namespace named "http://www.w3.org/2003/06/wsdl/soap12" SOAP Protocol Binding Framework section of [ SOAP 1.2 Part 1: Messaging Framework ].

The type of SOAP binding defined by this specification supports the <code> styleDefault </code> <em> attribute information item </em> is <em> xsd:string </em>. The value of SOAP HTTP binding defined by the <code> styleDefault </code> <em> attribute information item </em> [ SOAP 1.2 Part 2: Adjuncts ] specification. This is either "document" or "rpc"; if indicated by assigning the <code> styleDefault </code> <em> attribute information item </em> is omitted, URI "http://www.w3.org/2003/05/soap/bindings/HTTP/" (as defined by [ SOAP 1.2 Part 2: Adjuncts ]) to the value is "document". See below {soap underlying protocol} property defined below. Other values MAY be used for more information on this property in conjunction with the SOAP binding defined by this specification provided that the semantics of the <code> style </code> <em> attribute information item </em>. such protocols are consistent with this binding.

<a name="_soap_binding_name" id="_soap_binding_name"> 2.1.3 <code> namespaceDefault </code> Attribute with <code> binding </code> [owner] 2.4.2 Relationship to WSDL Component Model

The <code> namespaceDefault </code> <em> attribute information item </em> indicates SOAP protocol specification adds the default namespace following property to use the WSDL component model (as defined in [ WSDL 2.0 Core Language ]):

• {soap underlying protocol}, an absolute URI as defined by [ IETF RFC 2396 ], to the Binding component.

2.4.3 XML Representation

<definitions >
  <binding  name="xs:NCName" interface="xs:QName"? type="xs:anyURI"
            wsoap:protocol="xs:anyURI" >
    ...
  </binding>
</definitions>

The XML representation for any operation contained within specifying the [ancestor] binding with <code> style </code> SOAP protocol is a REQUIRED attribute information item with deleted text: value "rpc". The <code> namespaceDefault </code> <em> attribute information item </em> has the following Infoset properties:

• A [local name] of namespaceDefault protocol

• A [namespace name] deleted text: which has no value </p> </li> <li> <p> An [owner] of <code> binding </code> in the namespace named "http://www.w3.org/2003/06/wsdl/soap12" "http://www.w3.org/2004/08/wsdl/soap12"

2.4.4 Mapping Between Component Properties and XML Representation

See Table 2-1 .

2.5.1 Description

Every Binding Operation component of a SOAP binding MUST indicate the XML namespace SOAP Message Exchange Pattern (MEP) (see [ SOAP 1.2 Part 2: Adjuncts ]) to use for the 'wrapper' element be used for that operation. This binding specification allows the user to indicate a default SOAP Envelope body block(s). See below MEP to be used for more information on the semantics all Binding Operation components of the <code> namespace </code> <em> attribute information item </em>. this Binding component.

<a name="_soap_binding_encoding" id= "_soap_binding_encoding"> 2.1.4 <code> encodingStyleDefault </code> Attribute with <code> binding </code> [owner] 2.5.2 Relationship to WSDL Component Model

The deleted text: <code> encodingStyleDefault </code> <em> attribute information item </em> indicates the default encodingStyle to use for any operation contained within SOAP MEP specification is a syntactic convenience and does not affect the [ancestor] binding. underlying component model.

2.5.3 XML Representation

<definitions >
  <binding  name="xs:NCName" interface="xs:QName"? type="xs:anyURI"
            wsoap:protocol="xs:anyURI"
            wsoap:mepDefault="xs:anyURI ?" >
    ...
  </binding>
</definitions>

The <code> encodingStyleDefault </code> XML representation for specifying the default SOAP MEP is an OPTIONAL attribute information item has with the following Infoset properties:

• A [local name] of encodingStyleDefault mepDefault

• A [namespace name] deleted text: which has no value </p> </li> <li> <p> An [owner] of <code> binding </code> in the namespace named "http://www.w3.org/2003/06/wsdl/soap12" "http://www.w3.org/2004/08/wsdl/soap12"

2.6.1 Description

The type of the <code> encodingStyleDefault </code> <em> attribute information item </em> In SOAP, it is <em> xsd:anyURI </em>. permissible for specification interaction to engage one or more additional features (typically implemented as one or more SOAP header blocks), as defined by SOAP Modules (see [ SOAP 1.2 Part 1: Messaging Framework ]). This binding specification allows users to indicate which SOAP Modules are in use across the entire binding, on a per operation basis or on a per message basis.

2.6.2 Relationship to WSDL Component Model

The <code> encodingStyle </code> and <code> encodingStyleDefault </code> <em> attribute information item </em> s indicate how SOAP Module component adds the type description for following property to the SOAP Envelope WSDL component was derived. This information MAY be exploited by tools that generate data structures from model (as defined in [ WSDL 2.0 Core Language ]):

• {soap modules} to the type description. Binding, Binding Operation and Binding Message Reference components.

The [normalized value] "http://www.w3.org/2003/05/soap-envelope/encoding/none" indicates that the type description was not derived as SOAP modules applicable for a function particular operation of a well-known encoding. The [normalized value] MUST NOT be "". any service consists of all modules specified in the input or output Binding Message reference components, and those specified within the Binding Operation components and those specified within the Binding component. If no <code> encodingStyleDefault </code> any module is declared in scope, multiple components, then the [normalized value] is "http://www.w3.org/2003/05/soap-envelope/encoding/none" </p> <p> For all [normalized value]s requiredness of the <code> encodingStyle </code> and <code> encodingStyleDefault </code> <em> attribute information item </em> s, the SOAP Envelope component(s) MUST be exactly as described that module is defined by the type description; closest declaration, where closeness is defined by whether it is specified directly at the writer of Binding Message Reference component level, the SOAP Envelope component(s) MUST it exactly as described by Binding Operation component level or the type description. Binding component level, respectively.

<a name="_soap_module" id="_soap_module"> 2.2 <code> module </code> Element with <code> binding </code> [parent] </h3> <div class="exampleInner"> <pre> <definitions > <binding > <<b>soap:module</b> uri="uri" required="boolean"? > </<b>soap:module</b>> </binding> </definitions> </pre> </div> 2.6.3 SOAP Module Component

The optional <code> SOAP Module component identifies a SOAP module </code> <em> element information item </em> indicates that is in use. The properties of the SOAP module(s) supported Module component are as follows:

• {uri} An absolute URI as defined by a <code> binding </code> <em> element information item </em>. A [ IETF RFC 2396 ]. The value of this property identifies the specific SOAP module[ module that is in use, as defined in the SOAP Protocol Binding Framework section of [ <a href="#SOAP12-PART1"> SOAP 1.2 Part 1: Messaging Framework ] realizes zero or more SOAP features implemented as one or more ].

• {required} A boolean indicating if the SOAP header blocks. module is required.

2.6.4 XML Representation

<definitions >
  <binding >
    <wsoap:module uri="uri"
                  required="boolean"? >
      <documentation ... />?
    </wsoap:module>
    <operation>
      <wsoap:module ... />*
      <input>
        <wsoap:module ... />*
      </input>
      <output>
        <wsoap:module ... />*
      </output>
    </operation>
  </binding>
</definitions>

The <code> module </code> XML representation for a SOAP Module component is an element information item has with the following Infoset properties:

• A [local name] of module

• A [namespace name] of "http://www.w3.org/2003/06/wsdl/soap12" </p> </li> <li> <p> A [parent] of <code> binding </code> in the namespace named "http://www.w3.org/2003/06/wsdl" "http://www.w3.org/2004/08/wsdl/soap12"

• One or more attribute information item s amongst its [attributes] as follows:

  • A required REQUIRED uri attribute information item deleted text: as described below </p> </li> <li> <p> An optional <code> required </code> <em> attribute information item </em> as described below </p> </li> </ul> </li> </ul> <div class="div3"> <h4> <a name="_soap_module_uri" id="_soap_module_uri"> </a> 2.2.1 <code> uri </code> Attribute with deleted text: <code> module </code> [owner] </h4> <p> The <code> uri </code> <em> attribute information item </em> specifies the URI of the SOAP module for the [owner] <code> module </code> . The <code> uri </code> <em> attribute information item </em> has the following Infoset properties:

    • A [local name] of uri

    • A [namespace name] which has no value

  • An [owner] of <code> module </code> in the namespace named "http://www.w3.org/2003/06/wsdl/soap12" </p> </li> </ul> <p> The type of the <code> uri </code> <em> attribute information item </em> is <code> xsd:anyURI </code>. The value of the <code> uri </code> <em> attribute information item </em> is a URI that identifies a specific SOAP module. </p> </div> <div class="div3"> <h4> <a name="_soap_module_required" id= "_soap_module_required"> </a> 2.2.2 <code> required </code> Attribute with <code> binding </code> [owner] </h4> <p> The <code> required </code> <em> attribute information item </em> specifies whether the [owner] <code> module </code> is required by the [parent] binding. The OPTIONAL required attribute information item has with the following Infoset properties:

    • A [local name] of required

    • A [namespace name] which has no value

  • An [owner] of <code> module </code> in the Zero or more namespace named "http://www.w3.org/2003/06/wsdl/soap12" </p> </li> </ul> <p> The type of the <code> required </code> <em> attribute information item </em> is <code> xsd:boolean </code>. </p> <p> Omitting this qualified attribute information item is defined as being semantically equivalent to including it with a value of "false". </p> </div> </div> <div class="div2"> <h3> <a name="_soap_property" id="_soap_property"> </a> 2.3 <code> propertyConstraint </code> Element with <code> module </code> [parent] </h3> <div class="exampleInner"> <pre> <definitions> <binding> <soap:module> <<b>soap:propertyConstraint</b> uri="uri" type="qname"? /> </soap:module> </binding> </definitions> </pre> </div> <p> The optional <code> propertyConstraint </code> <em> element information item </em> indicates SOAP module(s) supported by a <code> module </code> <em> element information item </em>. </p> <p> s. The <code> propertyConstraint </code> [namespace name] of such element attribute information item has the following Infoset properties: </p> <ul> <li> <p> A [local name] of <code> propertyConstraint </code> </p> </li> <li> <p> A [namespace name] of "http://www.w3.org/2003/06/wsdl/soap12" s MUST NOT be "http://www.w3.org/2004/08/wsdl" and MUST NOT be "http://www.w3.org/2004/08/wsdl/soap12".

  • <li> <p> A [parent] of <code> module </code> in the namespace named "http://www.w3.org/2003/06/wsdl" </p>

• One Zero or more attribute element information item deleted text: s amongst its [attributes] [children], in order, as follows:

  <ul> <li> <p> A required <code> uri </code> <em> attribute information item </em> as described below </p> </li>

  1. An optional OPTIONAL type documentation attribute element information item as described below defined in [ WSDL 2.0 Core Language ].

  2. </ul> </li> </ul>

  3. The value of the <code> propertyConstraint </code> Zero or more namespace-qualified element information item is the value that is required for the SOAP property of the [parent] <code> module </code> . </p> <p> s amongst its [children]. The <code> propertyConstraint </code> [namespace name] of such element information item has no [children]. s MUST NOT be "http://www.w3.org/2004/08/wsdl" and MUST NOT be "http://www.w3.org/2004/08/wsdl/soap12".

<a name="_soap_property_uri" id="_soap_property_uri"> 2.3.1 <code> uri </code> Attribute with <code> propertyConstraint </code> [owner] 2.6.5 Mapping Between Component Properties and XML Representation

The <code> uri </code> <em> attribute information item </em> specifies the URI of the SOAP property for the [ancestor] <code> module </code> . The <code> uri </code> <em> attribute information item </em> has the following Infoset properties: See Table 2-2 .

2.7.1 Description

For every Interface Fault component contained in an Interface component, a URI that identifies mapping to a deleted text: specific SOAP property for Fault must be described. This binding specification allows the [ancestor] <code> module </code> . user to indicate the SOAP fault code and subcodes that are transmitted for a given Interface Fault component.

<a name="_soap_property_type" id= "_soap_property_type"> 2.3.2 <code> type </code> Attribute with <code> propertyConstraint </code> [owner] 2.7.2 Relationship to WSDL Component Model

The <code> type </code> <em> attribute information item </em> specifies the type of the value of the [owner] <code> propertyConstraint </code> . The <code> type </code> <em> attribute information item </em> has SOAP Fault binding adds the following Infoset properties: properties to the WSDL component model (as defined in [ WSDL 2.0 Core Language ]):

• A [local name] of <code> type </code> {soap fault code}, a QName as defined by [ </p> </li> <li> <p> A [namespace name] which has no XML 1.0 ], to the Binding Fault component. The value deleted text: </p> </li> <li> <p> An [owner] of <code> propertyConstraint </code> in this property identifies a possible SOAP fault (see [ SOAP 1.2 Part 1: Messaging Framework ]) for the namespace named "http://www.w3.org/2003/06/wsdl/soap12" operation in scope.

• </ul>

• The type {soap fault subcodes}, a list of QNames, to the <code> type </code> <em> attribute information item </em> is <code> xsd:QName </code>. Binding Fault component. The value of the <code> type </code> <em> attribute information item </em> is XML Qualified Name that this property identifies the type of the value one or more subcodes for the [owner] <code> propertyConstraint </code> . this SOAP fault.

<a name="_soap_operation" id="_soap_operation"> 2.4 <code> operation </code> Element with <code> operation </code> [parent] </h3> 2.7.3 XML Representation

<definitions>
 <binding>
  <operation>
   <<b>soap:operation</b> style="document|rpc"? 
                   soapAction="uri"? /> ?
  </operation>
 </binding>



<definitions >
  <binding >
    <fault ref="xs:QName"
           wsoap:code="xs:QName"
           wsoap:subcodes="list of xs:QName"? />
    </fault>*
  </binding>


</definitions>

The optional <code> operation </code> <em> element information item </em> provides binding information XML representation for the [parent] operation. The <code> operation </code> binding a SOAP Fault are two element attribute information item has s with the following Infoset properties:

• wsoap:code REQUIRED attribute information item

  • A [local name] of operation code

  • A [namespace name] of "http://www.w3.org/2003/06/wsdl/soap12" </p> </li> <li> <p> A [parent] of <code> operation </code> in the namespace named "http://www.w3.org/2003/06/wsdl" "http://www.w3.org/2004/08/wsdl/soap12"

  • <li> <p> Zero or more <em> attribute information item </em> s amongst its [attributes] as follows: </p> <ul> <li> <p> An optional <code> style </code> <em> attribute information item </em> as described below </p>

• An optional <code> soapAction </code> wsoap:subcodes OPTIONAL attribute information item deleted text: as described below </p> </li> </ul> </li> </ul> <p> The <code> operation </code> <em> element information item </em> has no [children]. </p> <p> If the <code> operation </code> <em> element information item </em> has no [attributes], it MAY be omitted. </p> <div class="div3"> <h4> deleted text: <a name="_soap_operation_style" id= "_soap_operation_style"> </a> 2.4.1 <code> style </code> Attribute with <code> operation </code> [owner] </h4> <p> The <code> style </code> <em> attribute information item </em> indicates the serialization style of the <code> operation </code> owner. The <code> style </code> <em> attribute information item </em> has the following Infoset properties:

  • A [local name] of style subcodes

  • A [namespace name] deleted text: which has no value </p> </li> <li> <p> An [owner] of <code> operation </code> in the namespace named "http://www.w3.org/2003/06/wsdl/soap12" "http://www.w3.org/2004/08/wsdl/soap12"

2.7.4 Mapping Between Component Properties and XML Representation

See Table 2-3 .

2.8.1 Description

For every Interface Operation component contained in an appropriate programming model. The value of this <em> attribute information item </em> also affects the way Interface component, in which the <code> Fault </code> of addition to the SOAP message is constructed, as explained default binding rules described in section <a href="#_soap_body"> 2.5 body Element with input or output [parent] 2.3 Default Binding Rules </a> . If the <code> style </code> <em> attribute ,there may be additional binding information deleted text: item </em> is not specified, it defaults to be specified. This binding specification allows the value specified in user to indicate the [ancestor] <code> binding </code> <em> element information item </em> in SOAP Message Exchange Pattern (MEP) and a value for the namespace named "http://www.w3.org/2003/06/wsdl/soap12". SOAP Action Feature (see [ SOAP 1.2 Part 2: Adjuncts ]) on a per-operation basis.

<a name="_soap_operation_action" id= "_soap_operation_action"> 2.4.2 <code> soapAction </code> Attribute with <code> operation </code> [owner] 2.8.2 Relationship to WSDL Component Model

The SOAP 1.2 HTTP Operation binding does not define a SOAPAction HTTP header. This is a known issue. </td> </tr> </table> <p> The <code> soapAction </code> <em> attribute information item </em> specifies the value of the HTTP SOAPAction header for the <code> operation </code> owner. The <code> soapAction </code> <em> attribute information item </em> has specification adds the following Infoset properties: property to the WSDL component model (as defined in [ WSDL 2.0 Core Language ]):

• A [local name] of <code> soapAction </code> {soap mep}, an absolute URI as defined by [ </p> </li> <li> <p> A [namespace name] which has no value </p> </li> <li> <p> An [owner] of <code> operation </code> in the namespace named "http://www.w3.org/2003/06/wsdl/soap12" </p> </li> </ul> <p> The type of IETF RFC 2396 ], to the <code> soapAction </code> <em> attribute information item </em> is <em> xsd:anyURI </em>. </p> <p> Binding Operation component. The value of this property identifies the <code> soapAction </code> <em> attribute information item </em> is the URI to be included in the HTTP SOAPAction header SOAP Message Exchange Pattern (MEP) (as defined by [ SOAP 1.2 Part 1: Messaging Framework ]) for the [owner] this specific operation. This URI If no specific value should be used directly as is assigned, then the value for assigned by the HTTP SOAPAction header; no attempt should be made default rules apply (see 2.3 Default Binding Rules ). It is an error for this property to make not have a deleted text: relative URI value absolute when making (which MAY happen if the request. For default rules are not applicable).

• {soap action}, an absolute URI as defined by [ IETF RFC 2396 ], to the HTTP protocol binding Binding Operation component. The value of deleted text: SOAP, this property identifies the value is required (it has no default value). For other of the SOAP protocol bindings, it MUST NOT be specified. Action Feature (as defined by [ SOAP 1.2 Part 1: Messaging Framework ]) for this specific operation.

<a name="_soap_body" id="_soap_body"> 2.5 <code> body </code> Element with <code> input </code> or <code> output </code> [parent] </h3> 2.8.3 XML Representation

<definitions>
 <binding>
  <operation>
   [ <input> | <output> ]
    <<b>soap:body</b> namespace="uri"?
               encodingStyle="uri"? /> ?
   [ </input> | </output> ]
  </operation>
 </binding>



<definitions >
  <binding >
    <operation ref="xs:QName" 
               wsoap:mep="xs:anyURI"?
               wsoap:action="xs:anyURI"? >
    </operation>
  </binding>


</definitions>

The optional <code> body </code> <em> element information item </em> specifies properties of the SOAP Envelope body block(s) XML representation for the [parent] operation. The <code> body </code> binding an Operation are two element attribute information item has s with the following Infoset properties:

• wsoap:mep OPTIONAL attribute information item

  • A [local name] of body mep

  • A [namespace name] of "http://www.w3.org/2003/06/wsdl/soap12" "http://www.w3.org/2004/08/wsdl/soap12"

  • <li> <p> A [parent] of <code> input </code> or <code> output </code> in the namespace named "http://www.w3.org/2003/06/wsdl" </p>

• Zero or more wsoap:action OPTIONAL attribute information item s amongst its [attributes] as follows:

  • An optional A [local name] of namespace action <em> attribute information item </em> as described below

  • An optional <code> encodingStyle </code> <em> attribute information item </em> as described below A [namespace name] of "http://www.w3.org/2004/08/wsdl/soap12"

2.8.4 Mapping Between Component Properties and XML Representation

See Table 2-4 .