Table of contents

Appendices

3.6 Binding Operations

Description[top]

This binding specification provides a binding to HTTP of Interface Operation components whose [{message exchange pattern}] property has the value 'http://www.w3.org/2004/08/wsdl/in-only', 'http://www.w3.org/2004/08/wsdl/robust-in-only' or 'http://www.w3.org/2004/08/wsdl/in-out'.

For every Binding operation component corresponding to such Interface Operation components, this binding specification allows the user to indicate the HTTP method to use, the input, output and fault serialization, and the location of the bound operation.

Relationship to WSDL Component Model[top]

The HTTP Operation component adds the following property to the Binding Operation component of the WSDL component model (as defined in [WSDL-PART1]):

• {http location}, an absolute or relative URI as defined by [RFC2396]. The value of this property specifies a template for the relative portion of the request URI for an operation. This URI is combined with the base URI specified in the [{address}] property of the endpoint element to form the full URI for the HTTP request to invoke the operation. It MUST contain an absolute or a relative URI, i.e. it MUST NOT include a fragment identifier in the URI.

  If the resulting URI uses the https scheme, then HTTP over TLS [RFC2818] is used to send the HTTP request.

• {http method}, a string value indicating, if present, the value for the HTTP Request Method for this specific operation. Otherwise, the default HTTP method as defined in [Specifying the Default HTTP Method] applies. One or the other MUST be present

• {http input serialization}, a string value indicating, if present, the value for the serialization of the HTTP Request message for this specific operation. Its value MUST be the name of a IANA media type token. If not present, the default input serialization associated with the {http method} property applies, as specified in [Default Binding Rules].

• {http output serialization}, a string value indicating, if present, the value for the serialization of the HTTP Response message for this specific operation. Its value MUST be the name of a IANA media type token. If not present, the default output serialization associated with the {http method} property applies, as specified in [Default Binding Rules].

• {http fault serialization}, a string value indicating the value for the serialization of the HTTP Response message for this specific operation in case a fault is returned. Its value MUST be the name of a IANA media type token.

XML Representation of HTTP Operation Component[top]

<definitions>
 <binding>
   <operation ref="xs:QName" 
              whttp:location="xs:anyURI"?
              whttp:method="xs:string"? 
              whttp:inputSerialization="xs:string"? 
              whttp:outputSerialization="xs:string"? 
              whttp:faultSerialization="xs:string"? >
  </operation>
 </binding>
</definitions>
	  

The XML representation for binding an Operation are four attribute information items with the following Infoset properties:

• An OPTIONAL location attribute information item with the following Infoset properties:

  • A [local name] of location

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

  • A type of wsdls:anyURI

  • No default value

• An OPTIONAL method attribute information item with the following Infoset properties:

  • A [local name] of method

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

  • A type of wsdls:string

  • No default value

• An OPTIONAL inputSerialization attribute information item with the following Infoset properties:

  • A [local name] of inputSerialization

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

  • A type of wsdls:string

  • No default value

• An OPTIONAL outputSerialization attribute information item with the following Infoset properties:

  • A [local name] of outputSerialization

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

  • A type of wsdls:string

  • No default value

• An OPTIONAL faultSerialization attribute information item with the following Infoset properties:

  • A [local name] of faultSerialization

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

  • A type of wsdls:string

  • A default value of "application/xml"

Mapping Between HTTP Operation's XML Representation to Component Properties[top]

See [tab_HTTP_Operation_Mapping].