Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language

2.1.1 The Definitions Component

At the abstract level, the Definitions component is just a container for two categories of components; WSDL components and type system components.

WSDL components are interfaces, bindings and services.

Type system components describe the constraints on a message's content. By default, these constraints are expressed in terms of the [XML Information Set], i.e. they define the [local name], [namespace name], [children] and [attributes] properties of an element information item. Type systems based upon other data models are generally accommodated by extensions to WSDL; see 6. Language Extensibility. In the case where they define information equivalent to that of a XML Schema global element declaration, they can more simply be treated as if they were such a declaration.

The properties of the Definitions component are as follows:

• {interfaces} OPTIONAL. A set of Interface components.

• {bindings} OPTIONAL. A set of Binding components.

• {services} OPTIONAL. A set of Service components.

• {element declarations} OPTIONAL. A set of named element declarations, each one isomorphic to a global element declaration as defined by XML Schema.

• {type definitions} OPTIONAL. A set of named type definitions, each one isomorphic to a global type definition as defined by XML Schema.

The set of interfaces/binding/services/etc. available in the Definitions component include those that are defined within the component itself and those that are imported and/or included. Note that at the component model level, there is no distinction between directly defined components vs. imported/included components.

The components directly defined within a single Definitions component are said to belong to the same target namespace. The target namespace therefore groups a set of related component definitions and represents an unambiguous name for the intended semantics of the collection of components. The target namespace URI SHOULD point to a human or machine processable document that directly or indirectly defines the intended semantics of those components.

Note that it is RECOMMENDED that the value of the targetNamespace attribute information item SHOULD be a dereferencible URI and that it resolve to a WSDL document which provides service description information for that namespace.

If a service description is split into multiple documents (which may be combined as needed via 4.1 Including Descriptions), then the targetNamespace attribute information item SHOULD resolve to a master document which includes all the WSDL documents needed for that service description. This approach enables the WSDL component designators' fragment identifiers to be properly resolvable.

Imported components have different target namespace values from the Definitions component that is importing them. Thus importing is the mechanism to use components from one namespace in another set of definitions.

Each WSDL or type system component MUST be uniquely identified by its qualified name. That is, if two distinct components of the same kind (Interface, Binding etc.) are in the same target namespace, then their QNames MUST be unique. However, different kinds of components (e.g., an Interface component and a Binding component) MAY have the same QName. Thus, QNames of components must be unique within the space of those components in a given target namespace.

In addition to WSDL components and type system components, additional extension components MAY be added via extensibility 6. Language Extensibility. Further, additional properties to WSDL and type system components MAY also be added via extensibility.

2.1.2 XML Representation of Definitions Component

<definitions
      targetNamespace="xs:anyURI" >
  <documentation />?
  [ <import /> | <include /> ]*
  <types />?
  [ <interface /> | <binding /> | <service /> ]*
</definitions>

WSDL definitions are represented in XML by one or more WSDL Information Sets (Infosets), that is one or more definitions element information items. A WSDL Infoset contains representations for a collection of WSDL components which share a common target namespace. A WSDL Infoset which contains one or more import element information items 4.2 Importing Descriptions corresponds to a collection with components drawn from multiple target namespaces.

The targetNamespace URI MUST be an absolute URI (see [IETF RFC 2396]).

The definitions element information item has the following Infoset properties:

• A [local name] of definitions .

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

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

  • A REQUIRED targetNamespace attribute information item as described below in 2.1.2.1 targetNamespace attribute information item.

  • 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 items amongst its [children], in order as follows:

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

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

     • Zero or more include element information items (see 4.1 Including Descriptions)

     • Zero or more import element information items (see 4.2 Importing Descriptions)

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

  3. An OPTIONAL types element information item (see 3. Types).

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

     • interface element information items (see 2.2.2 XML Representation of Interface Component).

     • binding element information items (see 2.9.2 XML Representation of Binding Component).

     • service element information items (see 2.13.2 XML Representation of Service Component).

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

2.1.3 Mapping Definitions' XML Representation to Component Properties

The mapping between the properties of the Definitions component (see 2.1.1 The Definitions Component) and the XML Representation of the definitions element information item (see 2.1.2 XML Representation of Definitions Component) is described in Table 2-1.

2.2.1 The Interface Component

An Interface component describes sequences of messages that a service sends and/or receives. It does this by grouping related messages into operations. An operation is a sequence of input and output messages, and an interface is a set of operations. Thus, an interface defines the design of the application.

An interface can optionally extend one or more other interfaces. To avoid circular definitions, an interface MUST NOT appear as an element of the set of interfaces it extends, either directly or indirectly. An interface contains all the operations defined by the interfaces it extends, along with any operations it directly defines. In the process, operation components that are equivalent per 2.16 Equivalence of Components are treated as one. The interface extension mechanism behaves in a similar way for all other components that can be defined inside an interface, namely Interface Fault, Feature and Property components.

Interfaces are named constructs and can be referred to by QName (see 2.18 QName resolution). For instance, Binding components refer to interfaces in this way.

The properties of the Interface component are as follows:

• {name} REQUIRED. A wsdls:NCName as defined by 2.15.3 NCName Type.

• {target namespace} REQUIRED. A wsdls:anyURI, as defined in 2.15.4 anyURI Type.

• {extended interfaces} OPTIONAL. A set of Interface components which this interface extends. This set MUST be closed under the operation of adding the values of the {extended interfaces} properties of all its members.

• {faults} OPTIONAL. A set of Interface Fault components. This set MUST include the values of the {faults} properties of all the interface definitions that are listed under the {extended interfaces} property of the component.

• {operations} OPTIONAL. A set of Interface Operation components. This set MUST include the values of the {operations} properties of all the Interface components that are listed under the {extended interfaces} property of the component.

• {features} OPTIONAL. A set of Feature components. This set MUST include the values of the {features} properties of all the Interface components that are listed under the {extended interfaces} property of the component.

• {properties} OPTIONAL. A set of Property components. This set MUST include the values of the {properties} properties of all the Interface components that are listed under the {extended interfaces} property of the component.

For each Interface component in the {interfaces} property of a definitions container, the combination of {name} and {target namespace} properties MUST be unique.

Additionally, an Interface component MUST satisfy the Operation Name Mapping requirement, as defined below. This requirement is intended to ensure that a received message can be uniquely mapped to a corresponding wsdl:operation.

2.2.2 XML Representation of Interface Component

<definitions>
  <interface
        name="xs:NCName" 
        extends="list of xs:QName"?
        styleDefault="list of xs:anyURI"? >
    <documentation />?
    [ <fault /> | <operation /> | <feature /> | <property /> ]*
  </interface>
</definitions>

The XML representation for an Interface component is an element information item with the following Infoset properties:

• A [local name] of interface

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

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

  • A REQUIRED name attribute information item as described below in 2.2.2.1 name attribute information item with interface [owner].

  • An OPTIONAL extends attribute information item as described below in 2.2.2.2 extends attribute information item.

  • An OPTIONAL styleDefault attribute information item as described below in 2.2.2.3 styleDefault attribute information item.

  • 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 items amongst its [children], in order, as follows:

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

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

     • Zero or more fault element information items 2.3.2 XML Representation of Interface Fault Component.

     • Zero or more operation element information items 2.4.3 XML Representation of Interface Operation Component.

     • Zero or more feature element information items 2.7.2 XML Representation of Feature Component.

     • Zero or more property element information items 2.8.2 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".

2.2.3 Mapping Interface's XML Representation to Component Properties

The mapping between the properties of the Interface component (see 2.2.1 The Interface Component) and the XML Representation of the interface element information item (see 2.2.2 XML Representation of Interface Component) is as described in Table 2-2.

Note that, per 2.2.1 The Interface Component, the Interface components in the {extended interfaces} property of a given Interface component MUST NOT contain that Interface component in any of their {extended interfaces} properties, that is to say, recursive extension of interfaces is disallowed.

2.3.1 The Interface Fault Component

A fault is an event that occurs during the execution of a message exchange that disrupts the normal flow of messages.

A fault is typically raised when a party is unable to communicate an error condition inside the normal message flow, or a party wishes to terminate a message exchange. A fault message may be used to communicate out of band information such as the reason for the error, the origin of the fault, as well as other informal diagnostics such as a program stack trace.

An Interface Fault component describes a fault that MAY occur during invocation of an operation of the interface. The Interface Fault component declares an abstract fault by naming it and indicating the contents of the fault message. When and how the fault message flows is indicated by the Interface Operation component 2.4 Interface Operation.

The Interface Fault component provides a clear mechanism to name and describe the set of faults an interface may generate. This allows operations to easily identify the individual faults they may generate by name. This mechanism allows the ready identification of the same fault occurring across multiple operations and referenced in multiple bindings as well as reducing duplication of description for an individual fault.

Note that faults other than the ones described in the Interface component can also be generated at run-time, i.e. faults are an open set.

The properties of the Interface Fault component are as follows:

• {name} REQUIRED. A wsdls:NCName as defined by 2.15.3 NCName Type.

• {target namespace} REQUIRED. A wsdls:anyURI, as defined in 2.15.4 anyURI Type.

• {element} OPTIONAL. A reference to an XML element declaration in the {element declarations} property of 2.1.1 The Definitions Component. This element represents the content or "payload" of the fault.

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

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

If a type system NOT based on the XML Infoset [XML Information Set] is in use (as considered in 3.2 Using Other Schema Languages) then additional properties would need to be added to the Fault Component (along with extensibility attributes to its XML representation) to allow associating such message types with the message reference.

For each Interface Fault component in the {faults} property of an Interface component, the combination of {name} and {target namespace} properties must be unique.

Interface Fault components are local to Interface components; they cannot be referred to by QName, despite having both {name} and {target namespace} properties. That is, two Interface components sharing the same {target namespace} property but with different {name} properties MAY contain Interface Fault components which share the same {name} property. Thus, the {name} and {target namespace} properties of the Interface Fault components are not sufficient to form the unique identity of an Interface Fault component. To uniquely identify an Interface Fault component one must first identify the Interface component (by QName) and then identify the Interface Fault within that Interface component (by a further QName).

In cases where, due to an interface extending one or more other interfaces, two or more Interface Faults components have the same value for their {name} and {target namespace} properties, then the component models of those Interface Fault components MUST be equivalent (see 2.16 Equivalence of Components). If the Interface Fault components are equivalent then they are considered to collapse into a single component. It is an error if two Interface Fault components have the same value for their {name} and {target namespace} properties but are not equivalent.

Note that, due to the above rules, if two interfaces that have the same value for their {target namespace} property also have one or more faults that have the same value for their {name} property then those two interfaces cannot both form part of the derivation chain of a derived interface unless those faults are the same fault.

2.3.2 XML Representation of Interface Fault Component

<definitions>
  <interface>
    <fault
          name="xs:NCName" 
          element="xs:QName"? >
      <documentation />?
      [ <feature /> | <property /> ]*
    </fault>
  </interface>
</definitions>

The XML representation for an Interface Fault component is an element information item with the following Infoset properties:

• A [local name] of fault

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

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

  • A REQUIRED name attribute information item as described below in 2.3.2.1 name attribute information item with fault [owner].

  • An OPTIONAL element attribute information item as described below in 2.3.2.2 element attribute information item with fault [owner].

  • 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 5. Documentation).

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

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

     • Zero or more property element information items 2.8.2 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".

2.3.3 Mapping Interface Fault's XML Representation to Component Properties

The mapping between the properties of the Interface Fault component (see 2.3.1 The Interface Fault Component) and the XML Representation of the fault element information item (see 2.3.2 XML Representation of Interface Fault Component) is as described in Table 2-3.

2.4.1 The Interface Operation Component

An Interface Operation component describes an operation that a given interface supports. An operation is an interaction with the service consisting of a set (ordinary and fault) messages exchanged between the service and the other roles involved in the interaction, in particular the service requester. The sequencing and cardinality of the messages involved in a particular interaction is governed by the message exchange pattern used by the operation (see {message exchange pattern} property).

A message exchange pattern defines placeholders for messages, the participants in the pattern (i.e., the sources and sinks of the messages), and the cardinality and sequencing of messages exchanged by the participants. The message placeholders are associated with specific message types by the operation that uses the pattern by means of message and fault references (see {message references} and {fault references} properties). The service whose operation is using the pattern becomes one of the participants of the pattern. This specification does not define a machine understandable language for defining message exchange patterns, nor does it define any specific patterns. The companion specification, [WSDL 2.0 Predefined Extensions] defines a set of such patterns and defines identifying URIs any of which MAY be used as the value of the {message exchange pattern} property.

The properties of the Interface Operation component are as follows:

• {name} REQUIRED. A wsdls:NCName as defined by 2.15.3 NCName Type.

• {target namespace} REQUIRED. A wsdls:anyURI, as defined in 2.15.4 anyURI Type.

• {message exchange pattern} REQUIRED. A wsdls:anyURI identifying the message exchange pattern used by the operation. This URI MUST be an absolute URI (see [IETF RFC 2396]).

• {message references} OPTIONAL. A set of Message Reference components for the ordinary messages the operation accepts or sends. (See 2.5 Message Reference.)

• {fault references} OPTIONAL. A set of Fault Reference components for the fault messages the operation accepts or sends. (See 2.6 Fault Reference.)

• {style} OPTIONAL. A set of wsdls:anyURIs identifying the rules that were used to construct the {element} properties of {message references}. (See 2.4.1.1 Operation Style.) These URIs MUST be absolute URIs (see [IETF RFC 2396]).

• {safety} REQUIRED. A wsdls:boolean (see 2.15.6 boolean Type) indicating whether the operation is asserted to be safe (as defined in Section 3.5 of [Web Architecture]) for users of the described service to invoke. If this property is false, then no assertion has been made about the safety of the operation, thus the operation MAY or MAY NOT be safe. However, an operation SHOULD be marked safe if it meets the criteria for a safe interaction defined in Section 3.5 of [Web Architecture].

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

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

For each Interface Operation component in the {operations} property of an Interface component, the combination of {name} and {target namespace} properties MUST be unique.

Interface Operation components are local to Interface components; they cannot be referred to by QName, despite having both {name} and {target namespace} properties. That is, two Interface components sharing the same {target namespace} property but with different {name} properties MAY contain Interface Operation components which share the same {name} property. Thus, the {name} and {target namespace} properties of the Interface Operation components are not sufficient to uniquely identify an Interface Operation component. In order to uniquely identify an Interface Operation component, one must first identify the Interface component (by QName) and then identify the Interface Operation within that Interface component (by a further QName).

In cases where, due to an interface extending one or more other interfaces, two or more Interface Operation components have the same value for their {name} and {target namespace} properties, then the component models of those Interface Operation components MUST be equivalent (see 2.16 Equivalence of Components). If the Interface Operation components are equivalent then they are considered to collapse into a single component. It is an error if two Interface Operation components have the same value for their {name} and {target namespace} properties but are not equivalent.

Note that, due to the above rules, if two interfaces that have the same value for their {target namespace} property also have one or more operations that have the same value for their {name} property then those two interfaces cannot both form part of the derivation chain of a derived interface unless those operations are the same operation.

2.4.2 RPC Style

The RPC style is selected by assigning to an Interface Operation component's {style} property the value http://www.w3.org/2004/08/wsdl/style/rpc.

The RPC style MUST NOT be used for Interface Operation components whose {message exchange pattern} property has a value other than 'http://www.w3.org/2004/08/wsdl/in-only' or 'http://www.w3.org/2004/08/wsdl/in-out'.

When this value is used, the associated messages MUST conform to the rules below, described using XML Schema [XML Schema: Structures]. Note that operations containing messages described by other type systems may also indicate use of the RPC style, as long as they are constructed in such a way as to follow these rules.

If the Interface Operation component uses a {message exchange pattern} for which there is no output element, such as 'http://www.w3.org/2004/08/wsdl/in-only', then the conditions stated below that refer to output elements MUST be considered to be implicitely satisfied.

• The content model of input and output {element} elements MUST be defined using a complex type that contains a sequence from XML Schema.

• The sequence MUST only contain elements. It MUST NOT contain other structures such as xs:choice.

• The sequence MUST contain only local element children. Note that these child elements MAY contain the following attributes: nillable, minOccurs and maxOccurs.

• The LocalPart of input element's QName MUST be the same as the Interface operation component's name.

• The LocalPart of the output element's QName is obtained by concatenating the name of the operation and the string value "Response".

• Input and output elements MUST both be in the same namespace.

• The complex type that defines the body of an input or an output element MUST NOT contain any attributes.

• If elements with the same qualified name appear as children of both the input and output elements, then they MUST both be declared using the same type.

• The input or output sequence MUST NOT contain multiple children elements declared with the same name.

<xs:attribute name="signature" type="wrpc:signatureType"/>

<xs:simpleType name="signatureType">
  <xs:list itemType="wrpc:signatureItemType"/>
</xs:simpleType>

<xs:simpleType name="signatureItemType">
  <xs:union memberTypes="wrpc:directionToken xsd:QName"/>
</xs:simpleType>

<xs:simpleType name="directionToken">
  <xs:restriction base="xs:token">
    <xs:enumeration value="#in"/>
    <xs:enumeration value="#out"/>
    <xs:enumeration value="#inout"/>
    <xs:enumeration value="#return"/>
  </xs:restriction>
</xs:simpleType>
          
           

2.4.3 XML Representation of Interface Operation Component

<definitions>
  <interface>
    <operation
          name="xs:NCName" 
          pattern="xs:anyURI"
          style="list of xs:anyURI"? 
          safe="xs:boolean"? >
      <documentation />?
      [ <feature /> | <property /> | 
        [ <input /> | <output /> | <infault /> | <outfault /> ]+
      ]*
    </operation>
  </interface>
</definitions>

The XML representation for an Interface Operation component is an element information item with the following Infoset properties:

• A [local name] of operation

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

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

  • A REQUIRED name attribute information item as described below in 2.4.3.1 name attribute information item with operation [owner].

  • A REQUIRED pattern attribute information item as described below in 2.4.3.2 pattern attribute information item with operation [owner].

  • An OPTIONAL style attribute information item as described below in 2.4.3.3 style attribute information item with operation [owner].

  • An OPTIONAL safe attribute information item as described below in 2.4.3.4 safe attribute information item with operation [owner].

  • 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 5. Documentation).

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

     • Zero or more input element information items (see 2.5.2 XML Representation of Message Reference Component).

     • Zero or more output element information items (see 2.5.2 XML Representation of Message Reference Component).

     • Zero or more infault element information items (see 2.6.2 XML Representation of Fault Reference Component).

     • Zero or more outfault element information items (see 2.6.2 XML Representation of Fault Reference Component).

     • A feature element information item (see 2.7.2 XML Representation of Feature Component).

     • A property element information item (see 2.8.2 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".

• At least one of the [children] MUST be an input , output , infault , or outfault element information item.

2.4.4 Mapping Interface Operation's XML Representation to Component Properties

The mapping between the properties of the Interface Operation component (see 2.4.1 The Interface Operation Component) and the XML Representation of the operation element information item (see 2.4.3 XML Representation of Interface Operation Component) is as described in Table 2-5.

2.5.1 The Message Reference Component

A Message Reference component associates a defined type with a message exchanged in an operation. By default, the type system is based upon the XML Infoset [XML Information Set].

A message exchange pattern defines a set of placeholder messages that participate in the pattern and assigns them unique message labels within the pattern (e.g. 'In', 'Out'). The purpose of a Message Reference component is to associate an actual message type (XML element declaration or some other declaration (see 3.2 Using Other Schema Languages) for message content) with a message in the pattern, as identified by its message label. Later, when the message exchange pattern is instantiated, messages corresponding to that particular label will follow the type assignment made by the Message Reference component.

The properties of the Message Reference component are as follows:

• {message label} REQUIRED. A wsdls:NCName as defined by 2.15.3 NCName Type. This property identifies the role this message plays in the {message exchange pattern} of the Interface Operation component this is contained within. The value of this property MUST match the name of a placeholder message defined by the message exchange pattern.

• {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 this is contained within.

• {message content model} OPTIONAL. A wsdls:token with one of the values #any, #none, or #element. A value of #any indicates that the message content is any single element. A value of #none indicates there is no message content. A value of #element indicates that the message consists of a single element described by the global element declaration reference by the {element} property.

• {element} OPTIONAL. A reference to an XML element declaration in the {element declarations} property of 2.1.1 The Definitions Component. This element represents the content or "payload" of the message. When the {message content model} property has the value #any or #none the {element} property MUST be empty.

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

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

If a type system not based upon the XML Infoset is in use (as considered in 3.2 Using Other Schema Languages) then additional properties would need to be added to the Message Reference Component (along with extensibility attributes to its XML representation) to allow associating such message types with the message reference.

For each Message Reference component in the {message references} property of an Interface Operation component, its {message label} property MUST be unique.

2.5.2 XML Representation of Message Reference Component

<definitions>
  <interface>
    <operation>
      <input
            messageLabel="xs:NCName"?
            element="union of xs:QName, xs:Token"? >
        <documentation />?
        [ <feature /> | <property /> ]*
      </input>
      <output
            messageLabel="xs:NCName"?
            element="union of xs:QName, xs:Token"? >
        <documentation />?
        [ <feature /> | <property /> ]*
      </output>
    </operation>
  </interface>
</definitions>

The XML representation for a 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"

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

  • An OPTIONAL messageLabel attribute information item as described below in 2.5.2.1 messageLabel attribute information item with input, or output [owner].

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

  • An OPTIONAL element attribute information item as described below in 2.5.2.2 element attribute information item with input, or output [owner].

  • 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 5. Documentation).

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

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

     • Zero or more property element information items 2.8.2 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".

2.5.3 Mapping Message Reference's XML Representation to Component Properties

The mapping between the properties of the Message Reference component (see 2.5.1 The Message Reference Component) and the XML Representation of the message reference element information item (see 2.5.2 XML Representation of Message Reference Component) is as described in Table 2-6.

2.6.1 The Fault Reference Component

A Fault Reference component associates a defined type, specified by an Interface Fault component, to a fault message exchanged in an operation.

A message exchange pattern defines a set of placeholder messages that participate in the pattern and assigns them unique message labels within the pattern (e.g. 'In', 'Out'). The purpose of a Fault Reference component is to associate an actual message type (XML element declaration or some other declaration (see 3.2 Using Other Schema Languages) for message content, as specified by an Interface Fault component) with a fault message occurring in the pattern. In order to identify the fault message it describes, the Fault Reference component uses the message label of the message the fault is associated with as a key.

The companion specification [WSDL 2.0 Predefined Extensions] defines two fault patterns that a given message exchange pattern may use. For the pattern fault-replaces-message, the message that the fault relates to identifies the message in place of which the declared fault message will occur. Thus, the fault message will travel in the same direction as the message it replaces in the pattern. For the pattern message-triggers-fault, the message that the fault relates to identifies the message after which the indicated fault may occur, in the opposite direction of the referred to message. That is, the fault message will travel in the opposite direction of the message it comes after in the pattern.

More than one Fault Reference component may refer to the same message label. This allows one to indicate that there is more than one type of fault that is related to that message.

The properties of the Fault Reference component are as follows:

• {fault reference} REQUIRED. An Interface Fault component in the {faults} property of the parent Interface Operation component's parent Interface component. Identifying the Interface Fault component therefore indirectly defines the actual content or payload of the fault message.

• {message label} REQUIRED. A wsdls:NCName as defined by 2.15.3 NCName Type. This property identifies the message this fault relates to among those defined in the {message exchange pattern} property of the Interface Operation component it is contained within. The value of this property MUST match the name of a placeholder message defined by the message exchange pattern.

• {direction} REQUIRED. A wsdls:Token with one of the values in or out, indicating whether the fault is coming to the service or going from the service, respectively. The direction MUST be consistent with the direction implied by the fault rule used in the message exchange pattern of the operation. For example, if the fault rule fault-replaces-message is used, then a fault which refers to an outgoing message would have a {direction} property value of out. On the other hand, if the fault rule message-triggers-fault is used, then a fault which refers to an outgoing message would have a {direction} property value of in as the fault travels in the opposite direction of the message.

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

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

2.6.2 XML Representation of Fault Reference Component

<definitions>
  <interface>
    <operation>
      <infault
            ref="xs:QName"
            messageLabel="xs:NCName"? >
        <documentation />?
        [ <feature /> | <property /> ]*
      </infault>*
      <outfault
            ref="xs:QName"
            messageLabel="xs:NCName"? >
        <documentation />?
        [ <feature /> | <property /> ]*
      </outfault>*
    </operation>
  </interface>
</definitions>

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

• A [local name] of infault or outfault

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

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

  • A REQUIRED ref attribute information item as described below in 2.6.2.1 ref attribute information item with infault, or outfault [owner].

  • An OPTIONAL messageLabel attribute information item as described below in 2.6.2.2 messageLabel attribute information item with infault, or outfault [owner].

    If the {message exchange pattern} of the Interface Operation component has only one message with a given value for {direction}, the messageLabel attribute information item is optional for the XML representation of any Fault Reference component with the same value for {direction} (if the fault pattern of the {message exchange pattern} is fault-replaces-message) or of any Fault Reference component with the opposite value for {direction} (if the fault pattern is message-triggers-fault).

  • 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 5. Documentation).

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

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

     • Zero or more property element information items 2.8.2 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".

2.6.3 Mapping Fault Reference's XML Representation to Component Properties

The mapping between the properties of the Fault Reference component (see 2.6.1 The Fault Reference Component) and the XML Representation of the message reference element information item (see 2.6.2 XML Representation of Fault Reference Component) is as described in Table 2-7.

2.7.1 The Feature Component

A feature component describes an abstract piece of functionality typically associated with the exchange of messages between communicating parties. Although WSDL poses no constraints on the potential scope of such features, examples might include "reliability", "security", "correlation", and "routing". The presence of a feature component in a WSDL description indicates that the service supports the feature and may require a requester agent that interacts with the service to use that feature. Each Feature is identified by its URI.

The properties of the Feature component are as follows:

• {name} REQUIRED. A wsdls:anyURI as defined in 2.15.4 anyURI Type. This URI MUST be absolute as defined by [IETF RFC 2396]. This URI SHOULD be dereferenceable to a document that directly or indirectly defines the meaning and use of the Feature that it identifies.

• {required} REQUIRED. A wsdls:boolean value as defined by 2.15.6 boolean Type. If the value of this property is true, then the requester agent MUST use the Feature that is identified by the {name} URI. Otherwise, the requester agent MAY use the Feature that is identified by the {name} URI. In either case, if the requester agent does use the Feature that is identified by the {name} URI, then the requester agent MUST obey all semantics implied by the definition of that Feature.

<definitions targetNamespace="http://example.com/bank"
     xmlns:ns1="http://example.com/bank">
  <interface name="ns1:Bank">
    <!-- All implementations of this interface must be secure -->
    <feature uri="http://example.com/secure-channel"
             required="true"/>
    <operation name="withdrawFunds">
      <!-- This operation must have ACID properties -->
      <feature uri="http://example.com/transaction"
               required="true"/>
      ...
    </operation>
    <operation name="depositFunds">
      <!-- This operation requires notarization -->
      <feature uri="http://example.com/notarization"
               required="true"/>
      ...
    </operation>
  </interface>

  <binding name="ns1:BankSOAPBinding">
    <!-- This particular binding requires ISO9001
         compliance to be verifiable -->
    <feature uri="http://example.com/ISO9001"
             required="true"/>
    <!-- This binding also requires notarization -->
    <feature uri="http://example.com/notarization"
             required="true"/>
  </binding>

  <service name="ns1:BankService"
           interface="tns:Bank">
    <endpoint binding="ns1:BankSOAPBinding">
      ...
    </endpoint>
  </service>
</definitions>

2.7.2 XML Representation of Feature Component

<feature
      uri="xs:anyURI" 
      required="xs:boolean"? >
  <documentation />?
</feature>

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

• A [local name] of feature

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

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

  • A REQUIRED uri attribute information item as described below in 2.7.2.1 uri attribute information item with feature [owner].

  • An OPTIONAL required attribute information item as described below in 2.7.2.2 required attribute information item with feature [owner].

  • 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 items amongst its [children], in order as follows:

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

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

2.7.3 Mapping Feature's XML Representation to Component Properties

The mapping between the properties of the Feature component (see 2.7.1 The Feature Component) and the XML Representation of the feature element information item (see 2.7.2 XML Representation of Feature Component) is as described in Table 2-8.

2.8.1 The Property Component

A "property" in the Features and Properties architecture represents a named runtime value which affects the behaviour of some aspect of a Web service interaction, much like an environment variable. For example, a reliable messaging SOAP module may specify a property to control the number of retries in the case of network failure. WSDL documents may specify the value constraints for these properties by referring to a Schema type, or by specifying a particular value. Properties, and hence property values, can be shared amongst features/bindings/modules, and are named with URIs precisely to allow this type of sharing.

The properties of the Property component are as follows:

• {name} REQUIRED. A wsdls:anyURI as defined in 2.15.4 anyURI Type. This URI MUST be absolute as defined by [IETF RFC 2396]. This URI SHOULD be dereferenceable to a document that directly or indirectly defines the meaning and use of the Property that it identifies.

• {required} REQUIRED. A wsdls:boolean value as defined by 2.15.6 boolean Type. If the {required} property is true, then the requester agent MUST use the Property that is identified by the {name} URI. Otherwise, the requester agent MAY use the Property that is identified by the {name} URI. In either case, if the requester agent does use the Property that is identified by the {name} URI, then the requester agent MUST obey all semantics implied by the definition of that Property.

• {value constraint} OPTIONAL. A type definition constraining the value of the property, or the token #value if the {value} property is not empty.

• {value} OPTIONAL. The value of the property, an ordered list of child information items, as specified by the [children] property of element information items in [XML Information Set].

If a type system not based upon the XML Infoset is in use (as considered in 3.2 Using Other Schema Languages) then additional properties would need to be added to the Property Component (along with extensibility attributes to its XML representation) to allow using such a type system to describe values and constraints for properties.

2.8.2 XML Representation of Property Component

<property
      uri="xs:anyURI" 
      required="xs:boolean"? >
  <documentation />?
  [ <value /> | <constraint /> ]?
</property>

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

• A [local name] of property

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

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

  • A REQUIRED uri attribute information item as described below in 2.8.2.1 uri attribute information item with property [owner].

  • An OPTIONAL required attribute information item as described below in 2.8.2.2 required attribute information item with property [owner].

  • 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".

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

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

  2. One OPTIONAL element information item from among the following:

     • A value element information item as described in 2.8.2.3 value element information item with property [parent]

     • A constraint element information item as described in 2.8.2.4 constraint element information item with property [parent]

  3. 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".

<property>
  <value>
    xs:anyType
  </value>
</property>

<property>
  <constraint>
    xs:QName
  </constraint>
</property>

2.8.3 Mapping Property's XML Representation to Component Properties

The mapping between the properties of the Property component (see 2.8.1 The Property Component) and the XML Representation of the property element information item (see 2.8.2 XML Representation of Property Component) is as described in Table 2-9.

2.9.1 The Binding Component

A Binding component describes a concrete message format and transmission protocol which may be used to define an endpoint (see 2.14 Endpoint). That is, a Binding component defines the implementation details necessary to accessing the service.

Binding components can be used to describe such information in a re-usable manner for any interface or specifically for a given interface. Furthermore, binding information MAY be specified on a per-operation basis (see 2.11.1 The Binding Operation Component) within an interface in addition to across all operations of an interface.

If a Binding component specifies any operation-specific binding details (by including Binding Operation components) or any fault binding details (by including Binding Fault components) then it MUST specify an interface the Binding component applies to, so as to indicate which interface the operations come from.

Conversely, a Binding component which omits any operation-specific binding details and any fault binding details MAY omit specifying an interface. Binding components that do not specify an interface MAY be used to specify operation-independent binding details for Service components with different interfaces. That is, such Binding components are reusable across one or more interfaces.

No concrete binding details are given in this specification. The companion specification, WSDL (Version 2.0): Bindings [WSDL 2.0 Bindings] defines such bindings for SOAP 1.2 [SOAP 1.2 Part 1: Messaging Framework] and HTTP [IETF RFC 2616]. 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.

A Binding component which defines bindings for an Interface component MUST define bindings for all the operations of that Interface component. The bindings may occur via defaulting rules which allow one to specify default bindings for all operations (see, for example [WSDL 2.0 Bindings]) or by directly listing each Operation component of the Interface component and defining bindings for them. Thus, it is an error for a Binding component to not define bindings for all the Operation components of the Interface component for which the Binding component purportedly defines bindings for.

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

The properties of the Binding component are as follows:

• {name} REQUIRED. A wsdls:NCName as defined by 2.15.3 NCName Type.

• {target namespace} REQUIRED. A wsdls:anyURI as defined in 2.15.4 anyURI Type.

• {interface} OPTIONAL. An Interface component indicating the interface for which binding information is being specified.

• {type} REQUIRED. A wsdls:anyURI as defined by 2.15.4 anyURI Type. This URI MUST be absolute as defined by [IETF RFC 2396]. The value of this URI indicates what kind of concrete binding details are contained within this Binding component. Specifications (such as [WSDL 2.0 Bindings] ) that define such concrete binding details MUST specify appropriate values for this property. The value of this property MAY be the namespace name of the extension elements or attributes which define those concrete binding details.

• {faults} OPTIONAL. A set of Binding Fault components.

• {operations} OPTIONAL. A set of Binding Operation components.

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

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

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

2.9.2 XML Representation of Binding Component

<definitions>
  <binding
        name="xs:NCName" 
        interface="xs:QName"?
        type="xs:anyURI" >
    <documentation />?
    [ <fault /> | <operation /> | <feature /> | <property /> ]*
  </binding>
</definitions>

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/2004/08/wsdl"

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

  • A REQUIRED name attribute information item as described below in 2.9.2.1 name attribute information item with binding [owner].

  • An OPTIONAL interface attribute information item as described below in 2.9.2.2 interface attribute information item with binding [owner].

  • An REQUIRED type attribute information item as described below in 2.9.2.3 type attribute information item with binding [owner].

  • 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 items amongst its [children], in order, as follows:

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

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

     • Zero or more fault element information items (see 2.10.2 XML Representation of Binding Fault Component).

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

     • Zero or more feature element information items (see 2.7.2 XML Representation of Feature Component).

     • Zero or more property element information items (see 2.8.2 XML Representation of Property Component).

     • Zero or more namespace-qualified element information items. 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 extension elements(see 2.9.2.4 Binding extension elements).

2.9.3 Mapping Binding's XML Representation to Component Properties

The mapping between the properties of the Binding component (see 2.9.1 The Binding Component) and the XML Representation of the binding element information item (see 2.9.2 XML Representation of Binding Component) is as described in Table 2-10.

2.10.1 The Binding Fault Component

A Binding Fault component describes a concrete binding of a particular fault within an interface to a particular concrete message format. A particular fault of an interface is uniquely identified by the target namespace of the interface and the name of the fault within that interface.

Note that the fault does not occur by itself - it occurs as part of a message exchange as defined by an Interface Operation component (and its binding counterpart the Binding Operation component). Thus, the fault binding information specified in a Binding Fault component describes how faults that occur within a message exchange of an operation will be formatted.

The properties of the Binding Fault component are as follows:

• {fault reference} REQUIRED. An Interface Fault component in the {faults} property of the Interface component identified by the {interface} property of the parent Binding component. This is the Interface Fault component for which binding information is being specified.

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

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

For each Binding Fault component in the {faults} property of a Binding component, the {fault reference} property MUST be unique. That is, one cannot define multiple bindings for the same fault within a given Binding component.

2.10.2 XML Representation of Binding Fault Component

<definitions>
  <binding>
    <fault
          ref="xs:QName" >
      <documentation />?
      [ <feature /> | <property /> ]*
    </fault>
  </binding>
</definitions>

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

• A [local name] of fault

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

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

  • A REQUIRED ref attribute information item as described below in 2.10.2.1 ref attribute information item with fault [owner].

  • 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 5. Documentation).

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

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

     • Zero or more property element information items 2.8.2 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 fault extension elements as described below (see 2.10.2.2 Binding Fault extension elements).

2.10.3 Mapping Binding Fault's XML Representation to Component Properties

The mapping between the properties of the Binding Fault component (see 2.10.1 The Binding Fault Component) and the XML Representation of the fault element information item (see 2.10.2 XML Representation of Binding Fault Component) is as described in Table 2-11.

2.11.1 The Binding Operation Component

The Binding Operation component describes the concrete message format(s) and protocol interaction(s) associated with a particular interface operation for a given endpoint. A particular operation of an interface is uniquely identified by the target namespace of the interface and the name of the operation within that interface.

The properties of the Binding Operation component are as follows:

• {operation reference} REQUIRED. An Interface Operation component in the {operations} property of the Interface component identified by the {interface} property of the parent Binding component. This is the Interface Operation component for which binding information is being specified.

• {message references} OPTIONAL. A set of Binding Message Reference components

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

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

For each Binding Operation component in the {operations} property of a Binding component, the {operation reference} property MUST be unique. That is, one cannot define multiple bindings for the same operation within a given Binding component.

2.11.2 XML Representation of Binding Operation Component

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

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

• A [local name] of operation

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

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

  • A REQUIRED ref attribute information item as described below in 2.11.2.1 ref attribute information item with operation [owner].

  • 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 items amongst its [children], in order, as follows:

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

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

     • Zero or more input element information items (see 2.12 Binding Message Reference )

     • Zero or more output element information items (see 2.12 Binding Message Reference )

     • Zero or more feature element information items (see 2.7.2 XML Representation of Feature Component)

     • Zero or more property element information items (see 2.7.2 XML Representation of Feature 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 operation extension elements as described below (see 2.11.2.2 Binding Operation extension elements).

2.11.3 Mapping Binding Operation's XML Representation to Component Properties

The mapping between the properties of the Binding Operation component (see 2.11.1 The Binding Operation Component) and the XML Representation of the operation element information item (see 2.11.2 XML Representation of Binding Operation Component) is as described in Table 2-12.

2.12.1 The Binding Message Reference Component

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 2.15.3 NCName 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.

2.12.2 XML Representation of Binding Message Reference Component

<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 2.12.2.1 messageLabel attribute information item with input or output [owner].

    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 5. Documentation).

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

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

     • Zero or more property element information items 2.8.2 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 2.12.2.2 Binding Message Reference extension elements).

2.12.3 Mapping Binding Message Reference's XML Representation to Component Properties

The mapping between the properties of the Binding Message Reference component (see 2.12.1 The Binding Message Reference Component) and the XML Representation of the binding element information item (see 2.12.2 XML Representation of Binding Message Reference Component) is as described in Table 2-13.

2.13.1 The Service Component

A Service component describes a set of endpoints (see 2.14 Endpoint) at which a particular deployed implementation of the service is provided. The endpoints thus are in effect alternate places at which the service is provided.

Services are named constructs and can be referred to by QName (see 2.18 QName resolution).

The properties of the Service component are as follows:

• {name} REQUIRED. A wsdls:NCName as defined by 2.15.3 NCName Type.

• {target namespace} REQUIRED. A wsdls:anyURI as defined in 2.15.4 anyURI Type.

• {interface} REQUIRED. An Interface component.

• {endpoints} REQUIRED. A non-empty set of Endpoint components.

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

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

For each Service component in the {services} property of a definitions container, the combination of {name} and {target namespace} properties MUST be unique.

2.13.2 XML Representation of Service Component

<definitions>
  <service
        name="xs:NCName" 
        interface="xs:QName" >
    <documentation />?
    <endpoint />+
    [ <feature /> | <property /> ]*
  </service>
</definitions>

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

• A [local name] of service

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

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

  • A REQUIRED name attribute information item as described below in 2.13.2.1 name attribute information item with service [owner].

  • A REQUIRED interface attribute information item as described below in 2.13.2.2 interface attribute information item with service [owner].

  • 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".

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

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

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

     • One or more endpoint element information items (see 2.14.2 XML Representation of Endpoint Component

     • Zero or more feature and/or property element information items (see 2.7.2 XML Representation of Feature Component and 2.8.2 XML Representation of Property Component, respectively).

     • 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".

Note that the XML Schema [XML Schema: Structures] type of the element information item service as defined in the WSDL schema MAY be used as the basis for defining new elements which can be used as service references in message exchanges. To enable such reuse, the WSDL schema defines the attribute information item name as optional in the type of the element information item service , while it is REQUIRED for the element information item service as indicated above.

2.13.3 Mapping Service's XML Representation to Component Properties

The mapping between the properties of the Service component (see 2.13.1 The Service Component) and the XML Representation of the service element information item (see 2.13.2 XML Representation of Service Component) is as described in Table 2-14.

2.14.1 The Endpoint Component

An Endpoint component defines the particulars of a specific endpoint at which a given service is available.

Endpoint components are local to a given Service component; they cannot be referred to by QName.

The properties of the Endpoint component are as follows:

• {name} REQUIRED. A wsdls:NCName as defined by 2.15.3 NCName Type.

• {binding} REQUIRED. A named Binding component.

• {address} OPTIONAL. A wsdls:anyURI as defined by 2.15.4 anyURI Type. This URI MUST be absolute as defined by [IETF RFC 2396]. If present, the value of this attribute represents the network address at which the service indicated by the parent Service component's {interface} property is offered via the binding referred to by the {binding} property.

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

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

For each Endpoint component in the {endpoints} property of a Service component, the {binding} property (see 2.14.1 The Endpoint Component) MUST either be a Binding component with an unspecified {interface} property (see 2.9.1 The Binding Component or a Binding component with an {interface} property equal to the {interface} property of the Service component.

For each Endpoint component in the {endpoints} property of a Service component, the {name} property MUST be unique.

2.14.2 XML Representation of Endpoint Component

<definitions>
  <service>
    <endpoint
          name="xs:NCName" 
          binding="xs:QName"
          address="xs:anyURI"? >
      <documentation />?
      [ <feature /> | <property /> ]*
    </endpoint>
  </service>+
</definitions>

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

• A [local name] of endpoint .

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

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

  • A REQUIRED name attribute information item as described below in 2.14.2.1 name attribute information item with endpoint [owner].

  • A REQUIRED binding attribute information item as described below in 2.14.2.2 binding attribute information item with endpoint [owner].

  • An OPTIONAL address attribute information item as described below in 2.14.2.3 address attribute information item with endpoint [owner].

  • 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 5. Documentation).

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

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

     • Zero or more property element information items 2.8.2 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 endpoint extension elements as described below (see 2.14.2.4 Endpoint extension elements).

2.14.3 Mapping Endpoint's XML Representation to Component Properties

The mapping between the properties of the Endpoint component (see 2.14.1 The Endpoint Component) and the XML Representation of the endpoint element information item (see 2.14.2 XML Representation of Endpoint Component) is as described in Table 2-15.

2.15.1 string Type

The value space of the wsdls:string type consists of finite-length sequences of characters in the range #x0-#x10FFFF inclusive, where a character is an atomic unit of text as specified by ISO/IEC 10646 [ISO/IEC 10646] and Unicode [Unicode].

2.15.2 Token Type

The value space of the wsdls:Token type is the subset of the value space of the wsdls:string type consisting of strings that do not contain the line feed (#xA), tab (#x9) characters, that have no leading or trailing spaces (#x20) and that have no internal sequences of two or more spaces.

2.15.3 NCName Type

The value space of the wsdls:NCName type is the subset of the value space of the wsdls:Token type consisting of tokens that do not contain the space (#x20) and ':' characters.

2.15.4 anyURI Type

The value space of the wsdls:anyURI type consists of all Uniform Resource Identifiers (URI) as defined by [IETF RFC 2396] and amended by [IETF RFC 2732].

2.15.5 QName Type

The value space of the wsdls:QName type consists of the set of 2-tuples whose first component is of type wsdls:anyURI and whose second component is of type wsdls:NCName.

2.15.6 boolean Type

The value space of the wsdls:boolean type consists of the two distinct values true and false.

2.15.7 int Type

The value space of the wsdls:int type consists of the infinite set {...,-2,-1,0,1,2,...} representing the standard mathematical concept of the integer numbers.

3.1.1 Importing XML Schema

Importing an XML Schema uses the syntax and semantics of the xs:import mechanism defined by XML Schema [XML Schema: Structures],[XML Schema: Datatypes], with some additional restrictions. The schema components defined in the imported schema are available for reference by QName (see 2.18 QName resolution). Note that only components defined in the schema itself and components included by it via xs:include are available to WSDL. Specifically, components that the schema imports via xs:import are NOT available to WSDL.

A child element information item of the types element information item is defined with the Infoset properties as follows:

• A [local name] of "import".

• A [namespace name] of "http://www.w3.org/2001/XMLSchema".

• One or two attribute information items as follows:

  • A REQUIRED namespace attribute information item as described below.

  • An OPTIONAL schemaLocation attribute information item as described below.

3.1.2 Embedding XML Schema

Embedding an XML schema uses the existing top-level xs:schema element information item defined by XML Schema [XML Schema: Structures]. It may be viewed as simply cutting and pasting an existing, stand-alone schema, to a location inside the types element information item.

The schema components defined in the embedded schema are available to WSDL for reference by QName (see 2.18 QName resolution). Note that only components defined in the schema itself and components included by it via xs:include are available to WSDL. Specifically components that the schema imports via xs:import are NOT available to WSDL.

Similarly, components defined in an embedded XML schema are NOT automatically made available to a WSDL description that imported (using wsdl:import ) the description that embeds the schema (see 4.2 Importing Descriptions for more details). For this reason, it is recommended that XML schema documents intended to be shared across several WSDL descriptions be placed in separate documents and imported using xs:import , rather than embedded inside a WSDL document.

Inside an embedded XML schema, the xs:import and xs:include element information items MAY be used to refer to other XML schemas embedded in the same WSDL description, provided that an appropriate value is specified for their schemaLocation attribute information items. The semantics of such element information items are governed solely by the XML Schema specification [XML Schema: Structures].

The xs:schema element information item has the following Infoset properties:

• A [local name] of schema.

• A [namespace name] of "http://www.w3.org/2001/XMLSchema".

• A REQUIRED targetNamespace attribute information item, amongst its [attributes] as described below.

• Additional OPTIONAL attribute information items as specified for the xs:schema element information item by the XML Schema specification.

• Zero or more child element information items as specified for the xs:schema element information item by the XML Schema specification.

3.1.3 References to Element Declarations and Type Definitions

Whether embedded or imported, the element declarations present in a schema may be referenced from a Message Reference or Interface Fault component. Similarly, regardless of whether they are embedded or imported, the type definitions present in a schema may be referenced from a Property component.

A named, global xs:element declaration may be referenced from the element attribute information item of an input , output or fault element information item. The QName is constructed from the targetNamespace of the schema and the value of the name attribute information item of the xs:element element information item. An element attribute information item MUST NOT refer to a global xs:simpleType or xs:complexType definition.

A named, global xs:simpleType or xs:complexType declaration may be referenced from the constraint attribute information item of property element information item. The QName is constructed from the targetNamespace of the schema and the value of the name attribute information item of the xs:simpleType or xs:complexType element information item. A constraint attribute information item MUST NOT refer to a global xs:element definition.

4.1.1 location attribute information item with include [owner]

The location attribute information item has the following Infoset properties:

• A [local name] of location .

• A [namespace name] which has no value.

A location attribute information item is of type xs:anyURI . Its actual value is the location of some information about the namespace identified by the targetNamespace attribute information item of the containing definitions element information item.

If the URI indicated by location is not dereferenceable or does not resolve to a WSDL document then the processor MUST fail immediately. That is, include elements MUST be processed immediately by WSDL processors.

The actual value of the targetNamespace attribute information item of the included WSDL document MUST match the actual value of the targetNamespace attribute information item of the definitions element information item which is the [parent] of the include element information item.

4.2.1 namespace attribute information item

The namespace attribute information item has the following Infoset properties:

• A [local name] of namespace .

• A [namespace name] which has no value.

The namespace attribute information item is of type xs:anyURI . Its actual value indicates that the containing WSDL document MAY contain qualified references to WSDL definitions in that namespace (via one or more prefixes declared with namespace declarations in the normal way). This value MUST NOT match the actual value of the enclosing WSDL document targetNamespace attribute information item. If the import statement results in the import of a WSDL document then the actual value of the namespace attribute information item MUST be identical to the actual value of the imported WSDL document's targetNamespace attribute information item.

4.2.2 location attribute information item with import [owner]

The location attribute information item has the following Infoset properties:

• A [local name] of location .

• A [namespace name] which has no value.

The location attribute information item is of type xs:anyURI . Its actual value is the location of some information about the namespace identified by the namespace attribute information item.

The location attribute information item is optional. This allows WSDL components to be constructed from information other than serialized XML 1.0. It also allows the development of WSDL processors that have a priori (i.e., built-in) knowledge of certain namespaces.

6.1.1 Mandatory extensions

Extension elements can be marked as mandatory by annotating them with a wsdl:required attribute information item (see 6.1.2 required attribute information item) with a value of "true". A mandatory extension is an extension that MAY change the meaning of the element to which it is attached, such that the meaning of that element is no longer governed by this specification. Instead, the meaning of an element containing a mandatory extension is governed by the meaning of that extension. Thus, the definition of the element's meaning is delegated to the specification that defines the extension.

An extension that is NOT marked as mandatory MUST NOT invalidate the meaning of any part of the WSDL document. Thus, a NON-mandatory extension merely provides additional description of capabilities of the service. This specification does not provide a mechanism to mark extension attributes as being required. Therefore, all extension attributes are NON-mandatory.

If a WSDL document declares an extension, Feature or Property as optional (i.e., NON-mandatory), then the provider agent MUST NOT assume that the requester agent supports that extension, Feature or Property, unless the provider agent knows (through some other means) that the requester agent has in fact elected to engage and support that extension, Feature or Property.

On the other hand, a requester agent MAY engage an extension, Feature or Property that is declared as optional in the WSDL document. Therefore, the provider agent MUST support every extension, Feature or Property that is declared as optional in the WSDL document, in addition to supporting every extension, Feature or Property that is declared as mandatory.

6.1.2 required attribute information item

WSDL provides a global attribute information item with the following Infoset properties:

• A [local name] of required .

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

• A [specified] property with a value of "true".

The type of the required attribute information item is xs:boolean.