WSDL 2.0 MTOM Extension

1.1 Notational Conventions

This specification uses a number of namespace prefixes throughout; they are listed in Table 1-1. Note that the choice of any namespace prefix is arbitrary and not semantically significant (see [XML Information Set]).

This specification uses curly brackets (e.g., {property}) to indicate a property in the WSDL component model, as defined in Part 1 [WSDL 2.0 Core] Component Model.

Namespace names of the general form "http://example.org/..." and "http://example.com/..." represent application or context-dependent URIs [RFC3986].

All parts of this specification are normative, with the EXCEPTION of examples, and sections explicitly marked as "Non-Normative".

2.1 Relationship to WSDL Component Model

This extension adds the following property to the Endpoint, Binding, Binding Operation, Binding Fault, Binding Message Reference and Binding Fault Reference component model (as defined in [WSDL 2.0 Core]):

• {optimized mime serialization} OPTIONAL. An xs:token with one of the values "required" or "optional". When present, the property indicates that the use of MTOM has been declared. When absent, NO assertion is made on the support and use of MTOM.

The availability and requiredness of MTOM support and engagement is defined by the closest {optimized mime serialization} property, where closeness is defined by whether it is at the Endpoint component level, the Binding Message Reference component, the Binding Fault Reference component level, the Binding Operation level, the Binding Fault Reference level, or the Binding component level, respectively.

2.2 XML Representation

The XML representation for the WSDL2.0 MTOM extension is an element information item as follow:

<description>
  <wsdl:binding wsoap:protocol="http://www.w3.org/2003/05/soap/bindings/HTTP/">
     <wso:OptimizedMimeSerialization
	        wsdl:required="xs:boolean"?/>*
    <wsdl:fault>
      <wso:OptimizedMimeSerialization ... />*
    </wsdl:fault>
    <wsdl:operation>
      <wso:OptimizedMimeSerialization ... />*
      <wsdl:input>
        <wso:OptimizedMimeSerialization ... />*
      </wsdl:input>
      <wsdl:output>
        <wso:OptimizedMimeSerialization ... />*
      </wsdl:output>
      <wsdl:infault>
        <wso:OptimizedMimeSerialization ... />*
      </wsdl:infault>
      <wsdl:outfault>
        <wso:OptimizedMimeSerialization ... />*
      </wsdl:outfault>
    </wsdl:operation>
  </wsdl:binding>
</wsdl:description>

This is an empty global element that allows any namespaced attribute, especially the wsdl:required attribute.

The XML representation for the MTOM extension is an element information item with the following Infoset properties:

• A [local name] of wso:OptimizedMimeSerialization .

• A [namespace name] of "http://www.w3.org/@@@@/@@/wsdl/soap/mime/optimisation".

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

  • A [local name] of required

  • A [namespace name] of "http://www.w3.org/@@@@/@@/wsdl"

  • A type of xs:boolean.

2.3 Mapping from XML Representation to Component Properties

The mapping from the XML Representation of the wso:OptimizedMimeSerialization element information item to the {optimized mime serialization} property of the Endpoint, Binding, Binding Operation, Binding Fault, Binding Message Reference and Binding Fault Reference component model is as described in Table 2-2.

3.1 Other Uses of OptimizedMimeSerialization Extension Element

The wso:OptimizedMimeSerialization element MAY be used in other contexts than WSDL2.0 (e.g., as a policy assertion in a policy framework). Its use in such contexts is semantically equivalent to the use of wso:OptimizedMimeSerialization as a WSDL extension element.

3.2 HTTP Content Negociation

A client MAY indicate that it supports MTOM by using the Accept header field in the request. The service can then decide to engage MTOM or not in the response based on the Accept header field value.

4.1 Normative References

[SOAP MTOM]

SOAP Message Transmission Optimization Mechanism, Martin Gudgin, Noah Mendelsohn, Mark Nottingham, and Herve' Ruellan, Editors. World Wide Web Consortium, 25 January 2005.

[SOAP12 Part 1]

SOAP Version 1.2 Part 1: Messaging Framework, M. Gudgin, M. Hadley, N. Mendelsohn, J-J. Moreau, H. Frystyk Nielsen, Editors. World Wide Web Consortium, 24 June 2003. This version of the "SOAP Version 1.2 Part 1: Messaging Framework" Recommendation is http://www.w3.org/TR/2003/REC-soap12-part1-20030624/. The latest version of "SOAP Version 1.2 Part 1: Messaging Framework" is available at http://www.w3.org/TR/soap12-part1/.

[WSDL 2.0 Core]

Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language, R. Chinnici, J-J. Moreau, A. Ryman, S. Weerawarana, Editors. World Wide Web Consortium, @@ @@@@ @@@@. This version of the "Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language" Specification is available is available at wsdl20.html. The latest version of "Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language" is available at http://www.w3.org/2002/ws/desc/wsdl20.

[WSDL 2.0 Adjuncts]

Web Services Description Language (WSDL) Version 2.0 Part 2: Adjuncts , R. Chinnici, H. Haas, A. Lewis, J-J. Moreau, D. Orchard, S. Weerawarana, Editors. World Wide Web Consortium, @@ @@@@ @@@@. This version of the "Web Services Description Language (WSDL) Version 2.0 Part 2: Adjuncts" Specification is available at wsdl20-adjuncts.html. The latest version of "Web Services Description Language (WSDL) Version 2.0 Part 2: Adjuncts" is available at http://www.w3.org/2002/ws/desc/wsdl20-adjuncts.

[XML Information Set]

XML Information Set (Second Edition), J. Cowan and R. Tobin, Editors. World Wide Web Consortium, 4 February 2004. This version of the XML Information Set Recommendation is http://www.w3.org/TR/2004/REC-xml-infoset-20040204. The latest version of XML Information Set is available at http://www.w3.org/TR/xml-infoset.

4.2 Informative References

[WSDL 2.0 Primer]

Web Services Description Language (WSDL) Version 2.0 Part 0: Primer, D. Booth, C.K. Liu, Editors. World Wide Web Consortium, @@ @@@@ @@@@. This version of "Web Services Description Language (WSDL) Version 2.0 Part 0: Primer" is wsdl20-primer.html. The latest version of the "Web Services Description Language (WSDL) Version 2.0 Part 0: Primer" document is available from http://www.w3.org/2002/ws/desc/wsdl20-primer.