Table of contents

Appendices

2.12 Binding Message Reference

The Binding Message Reference Component[top]

A Binding Message Reference component describes a concrete binding of a particular message participating in an operation to a particular concrete message format.

The properties of the Binding Message Reference component are as follows:

• {message label} OPTIONAL. A wsdls:NCName as defined by [ Type]. The value of this property identifies the role that the message for which binding details are being specified plays in the {message exchange pattern} of the Interface Operation component being bound by the containing Binding Operation component.

• {direction} REQUIRED. A wsdls:Token with one of the values in or out indicating whether the message is coming to the service or going from the service, respectively. The direction MUST be the same as the direction of the message identified by the {message label} property in the {message exchange pattern} of the Interface Operation component being bound by the containing Binding Operation component.

• {features} OPTIONAL. A set of Feature components.

• {properties} OPTIONAL. A set of Property components.

For each Binding Message Reference component in the {message references} property of a Binding Operation component, the {message label} property MUST be unique. That is, the same message cannot be bound twice within the same operation.

XML Representation of Binding Message Reference Component[top]

<definitions>
  <binding>
    <operation>
      <input
            messageLabel="xs:NCName"? >
        <documentation />?
        [ <feature /> | <property /> ]*
      </input>
      <output
            messageLabel="xs:NCName"? >
        <documentation />?
        [ <feature /> | <property /> ]*
      </output>
    </operation>
  </binding>
</definitions>

The XML representation for a Binding Message Reference component is an element information item with the following Infoset properties:

• A [local name] of input or output.

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

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

  • An OPTIONAL messageLabel attribute information item as described below in [ ].

    If the {message exchange pattern} of the Interface Operation component being bound has only one message with a given value for {direction}, then the messageLabel attribute information item is optional for the XML representation of the Binding Message Reference component with that {direction}.

  • Zero or more namespace qualified attribute information items. The [namespace name] of such attribute information items MUST NOT be http://www.w3.org/2004/08/wsdl.

• Zero or more element information item amongst its [children], in order, as follows:

  1. An OPTIONAL documentation element information item (see [Documentation]).

  2. Zero or more element information items from among the following, in any order:

     • Zero or more feature element information items [XML Representation of Feature Component]

     • Zero or more property element information items [XML Representation of Property Component]

     • Zero or more namespace-qualified element information items amongst its [children]. The [namespace name] of such element information items MUST NOT be http://www.w3.org/2004/08/wsdl. Such element information items are considered to be binding message reference extension elements as described below (see [Binding Message Reference extension elements]).

messageLabel attribute information item with input or output [owner][top]

The messageLabel attribute information item has the following Infoset properties:

• A [local name] of messageLabel.

• A [namespace name] which has no value.

The type of the messageLabel attribute information item is xs:NCName.

Binding Message Reference extension elements[top]

Binding Message Reference extension elements are used to provide information specific to a particular message in an operation. The semantics of such element information items are defined by the specification for those element information items. Such specifications are expected to annotate the Binding Message Reference component with additional properties and specify the mapping between those properties and the XML representation.

Mapping Binding Message Reference's XML Representation to Component Properties[top]

The mapping between the properties of the Binding Message Reference component (see [The Binding Message Reference Component]) and the XML Representation of the binding element information item (see [XML Representation of Binding Message Reference Component]) is as described in [tab_Binding_Message_Reference_Mapping].