Table of contents

Appendices

2.7 Binding

Ed. Note:  Should WSDL 1.2 (part 2) including bindings for SOAP 1.1? June 25, 2002 The WS Description WG currently investigating whether it will support SOAP 1.1 in this specification, as a W3C note, or otherwise. We will of course support SOAP 1.2.

The Binding Component[top]

A binding component described a concrete binding of a port type component and associated operations to a particular concrete message format and transmission protocol.

No concrete binding details are given in this specification. The companion specification, WSDL (Version 1.2): Bindings [WSDL-PART2] defines such bindings for SOAP 1.1 [SOAP11], SOAP 1.2 [SOAP12-PART1], HTTP [RFC2616] and MIME [RFC2045]. Other specifications MAY define additional binding details. Such specifications are expected to annotate the binding component ( and its sub-components ) with additional properties and specify the mapping between those properties and the XML representation.

Bindings are named constructs and can be referred to by QName (see [QName resolution]). For instance, service components refer to bindings in this way.

The properties of the Binding Component are as follows:

• {name} An NCName as defined by [XMLNS].

• {target namespace} A namespace name, as defined in [XMLNS].

• {port type} A named port type definition

• {operations} A set of named binding operation definitions

For each binding component in the {bindings} property of a definitions container the combination of {name} and {target namespace} properties must be unique.

XML Representation of Binding Component[top]

The XML representation for a binding component is an element information item with the following Infoset properties;

• A [local name] of binding

• A [namespace name] of http://www.w3.org/2003/03/wsdl

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

  • A name attribute information item as described below in [ ].

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

• Zero or more element information items amongst its [children], as follows;

  • An optional documentation element information item (see [Documentation]).

  • Zero or more operation element information items (see [XML Representation of Binding Operation Component]).

• Zero or more namespace qualified element information items amongst its [children]. Such element information items MUST be a member of one of the element substitution groups related to bindings described in [Language Extensibility]. Such element information items are considered to be binding extension elements (see [Binding extension elements]).

name attribute information item with binding [owner][top]

The name attribute information item together with the targetNamespace attribute information item of the definitions element information item forms the QName of the binding.

The name attribute information item has the following Infoset properties;

• A [local name] of name

• A [namespace name] which has no value

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

type attribute information item with binding [owner][top]

The type attribute information item refers, by QName, to a port type component

The type attribute information item has the following Infoset properties;

• A [local name] of type

• A [namespace name] which has no value

The type of the type attribute information item is xs:QName.

Binding extension elements[top]

Binding extension elements are used to provide information specific to a particular binding. 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 component with additional properties and specify the mapping between those properties and the XML representation.

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

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