Web Services Addressing 1.0 - WSDL Binding

1.1 Notational Conventions

The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 [IETF RFC 2119].

When describing abstract data models, this specification uses the notational convention used by the XML Infoset [XML Information Set]. Specifically, abstract property names always appear in square brackets (e.g., [some property]).

When describing concrete XML schemas [XML Schema Structures, XML Schema Datatypes], this specification uses the notational convention of WS-Security [WS-Security]. Specifically, each member of an element's [children] or [attributes] property is described using an XPath-like notation (e.g., /x:MyHeader/x:SomeProperty/@value1). The use of {any} indicates the presence of an element wildcard (<xs:any/>). The use of @{any} indicates the presence of an attribute wildcard (<xs:anyAttribute/>).

1.2 Namespaces

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 Namespaces]).

WS-Addressing is defined in terms of the XML Information Set [XML Information Set]. WS-Addressing is designed to be able to work with WSDL 2.0 [WSDL 2.0] and also (for backwards compatibility with WSDL 1.1 [WSDL 1.1] described services. WS-Addressing may be used with SOAP [SOAP 1.2 Part 1: Messaging Framework] as described in Web Services Addressing 1.0 - SOAP Binding[WS-Addressing-SOAP]. The examples in this specification use an XML 1.0 [XML 1.0] representation but this is not a requirement.

All information items defined by WS-Addressing are identified by the XML namespace URI [XML Namespaces] "http://www.w3.org/2005/02/addressing". A normative XML Schema [XML Schema Structures, XML Schema Datatypes] document can be obtained by dereferencing the XML namespace URI.

2.1 Information Model for Endpoint References

The WSDL binding of Web Services Addressing introduces the following additional abstract properties:

[selected interface] : QName (0..1)

A QName identifying a description of the sequences of messages that a service sends and/or receives. This corresponds to a WSDL 2.0 interface and/or a WSDL 1.1 port type.

[service endpoint] : (QName, NCName (0..1)) (0..1)

A QName, NCName pair that provide a reference to a to a full description of a set of service endpoints. The QName identifies the set of endpoints at which a particular Web service is deployed, the NCName identifies one endpoint in particular. The set of endpoints is represented by a service in WSDL 2.0 and WSDL 1.1. A particular endpoint is represented by an endpoint in WSDL 2.0 and a port in WSDL 1.1.

3.1 Explicit Association

WS-Addressing defines a global attribute, wsa:Action, that may be used to explicitly define the value of the [action] property for messages in a WSDL description. The type of the attribute is xs:anyURI and it is used as an extension on the WSDL input, output and fault elements.

For example consider the following WSDL excerpt:

<definitions targetNamespace="http://example.com/stockquote" ...>
  ...
  <interface name="StockQuoteInterface">
    <operation name="GetLastTradePrice" pattern="http://www.w3.org/2004/08/wsdl/in-out">
      <input element="tns:GetTradePricesInput" messageLabel="In"
            wsa:Action="http://example.com/GetQuote"/>
      <output element="tns:GetTradePricesOutput" messageLabel="Out"
            wsa:Action="http://example.com/Quote"/>
    </operation>
  </interface>
  ...
</definitions>
      

The action for the input of the GetLastTradePrice operation within the StockQuoteInterface is explicitly defined to be http://example.com/GetQuote. The action for the output of this same operation is http://example.com/Quote.

<definitions targetNamespace="http://example.com/stockquote" ...>
  ...
  <portType name="StockQuotePortType">
    <operation name="GetLastTradePrice">
      <input message="tns:GetTradePricesInput"
            wsa:Action="http://example.com/GetQuote"/>
      <output message="tns:GetTradePricesOutput"
            wsa:Action="http://example.com/Quote"/>
    </operation>
  </portType>
  ...
</definitions>
      

The action for the input of the GetLastTradePrice operation within the StockQuotePortType is explicitly defined to be http://example.com/GetQuote. The action for the output of this same operation is http://example.com/Quote.

3.2 Default Action Pattern for WSDL 2.0

In the absence of the wsa:Action attribute, the following pattern is used in WSDL 2.0 documents to construct a default action for inputs and outputs. The general form of an action URI is as follows:

[target namespace]/[interface name]/[operation name][direction token]

For fault messages, the general form of an action URI is as follows:

[target namespace]/[interface name]/[fault name]

The "/" is a literal character to be included in the action. The values of the properties are as defined below.

[target namespace] is the {target namespace} of the interface. If [target namespace] ends with a "/" an additional "/" is not added.

[interface name] is the {name} of the interface.

[operation name] is the {name} of the operation.

[fault name] is the {name} of the fault.

[direction token] is:

• Empty ("") where the operation's {message exchange pattern} is "http://www.w3.org/2004/08/wsdl/in-only", "http://www.w3.org/2004/08/wsdl/robust-in-only", "http://www.w3.org/2004/08/wsdl/out-only", or "http://www.w3.org/2004/08/wsdl/robust-out-only".

• "Request" where the operation's {message exchange pattern} is "http://www.w3.org/2004/08/wsdl/in-out" or "http://www.w3.org/2004/08/wsdl/in-opt-out" and the message reference's {message label} = 'in'.

• "Solicit" where the operation's {message exchange pattern} is "http://www.w3.org/2004/08/wsdl/out-in" or "http://www.w3.org/2004/08/wsdl/out-opt-in" and the message reference's {message label} = 'out'.

• "Response" where the operation's {message exchange pattern} is "http://www.w3.org/2004/08/wsdl/in-out" or "http://www.w3.org/2004/08/wsdl/in-opt-out" and the message reference's {message label} = 'out'.

• "Response" where the operation's {message exchange pattern} is "http://www.w3.org/2004/08/wsdl/out-in", or "http://www.w3.org/2004/08/wsdl/out-opt-in" and the message reference's {message label} = 'in'.

• {message label} where the {message exchange pattern} is not one of the MEP URIs defined in WSDL 2.0 Part 2.

For example consider the following WSDL excerpt:

<definitions targetNamespace="http://example.com/stockquote" ...>
  ...
  <interface name="StockQuoteInterface">
    <operation name="GetLastTradePrice" pattern="http://www.w3.org/2004/08/wsdl/in-out">
      <input element="tns:GetTradePricesInput" messageLabel="in" name="GetQuote"/>
      <output element="tns:GetTradePricesOutput" messageLabel="out" name="Quote"/>
    </operation>
  </portType>
  ...
</definitions>
      

3.3 Default Action Pattern for WSDL 1.1

In the absence of the wsa:Action attribute, the following pattern is used to construct a default action for inputs and outputs. The general form of an action URI is as follows:

[target namespace]/[port type name]/[input|output name]

For fault messages, the general form of an action URI is as follows:

[target namespace]/[port type name]/[operation name]Fault:[fault name]

The "/" and ":" are literal characters to be included in the action. The values of the properties are as defined below.

[target namespace] is the target namespace (/definition/@targetNamespace). If [target namespace] ends with a "/" an additional "/" is not added.

[port type name] is the name of the port type (/definition/portType/@name).

[input|output name] is the name of the element as defined in Section 2.4.5 of WSDL 1.1.

[fault name] is the name of the fault (/definition/porttype/operation/fault/@name).

For example consider the following WSDL excerpt:

<definitions targetNamespace="http://example.com/stockquote" ...>
  ...
  <portType name="StockQuotePortType">
    <operation name="GetLastTradePrice">
      <input message="tns:GetTradePricesInput" name="GetQuote"/>
      <output message="tns:GetTradePricesOutput" name="Quote"/>
          <fault message="tns:ErrorMessage" name="Error"/>
    </operation>
  </portType>
  ...
</definitions>
      

WSDL defines rules for a default input or output name if the name attribute is not present. Consider the following example:

<definitions targetNamespace="http://example.com/stockquote" ...>
  ...
  <portType name="StockQuotePortType">
    <operation name="GetLastTradePrice">
      <input message="tns:GetTradePricesInput"/>
      <output message="tns:GetTradePricesOutput"/>
    </operation>
  </portType>
  ...
</definitions>
      

4.1 WSDL 1.1 Message Exchange Patterns

This section describes which of the core message properties are mandatory or optional for messages in the various MEPs defined by WSDL 1.1.

4.2 WSDL 2.0 Message Exchange Patterns

This section describes which of the core message properties are mandatory or optional for messages in the various MEPs defined by WSDL 2.0.