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

Editors' copy $Date: 2003/09/09 16:55:55 $ @@ @@@@ @@@@

This version:
wsdl12.html
Latest version:
http://www.w3.org/2002/ws/desc/wsdl12
Previous versions:
http://www.w3.org/TR/2003/WD-wsdl12-20030303
Editors:
Roberto Chinnici, Sun Microsystems
Martin Gudgin, Microsoft
Jean-Jacques Moreau, Canon
Sanjiva Weerawarana, IBM Research

This document is also available in these non-normative formats: .

Copyright © @@@@ W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply.

Abstract

This document describes the Web Services Description Language (WSDL) Version 1.2, an XML language for describing Web services. This specification defines the core language which can be used to describe Web services based on an abstract model of what the service offers.

Status of this Document

This document is an editors' copy that has no official standing.

Short Table of Contents

1. Introduction
2. Component Model
3. Types
4. Modularizing WSDL descriptions
5. Documentation
6. Language Extensibility
7. References
A. The application/wsdl+xml Media Type
B. Acknowledgements (Non-Normative)
C. URI References for WSDL constructs (Non-Normative)
D. Migrating from WSDL 1.1 to WSDL 1.2 (Non-Normative)
E. Examples of Specifications of Extension Elements for Alternative Schema Language Support. (Non-Normative)
F. Part 1 Change Log (Non-Normative)

Table of Contents

1. Introduction
    1.1 Web Service
    1.2 Notational Conventions
2. Component Model
    2.1 Definitions
        2.1.1 The Definitions Component
        2.1.2 XML Representation of Definitions Component
            2.1.2.1 targetNamespace attribute information item
        2.1.3 Mapping Definitions' XML Representation to Component Properties
    2.2 Message
        2.2.1 The Message Component
        2.2.2 XML Representation of Message Component
            2.2.2.1 name attribute information item with message [owner]
        2.2.3 Mapping Message's XML Representation to Component Properties
    2.3 Part
        2.3.1 The Part Component
        2.3.2 XML Representation of Part Component
            2.3.2.1 name attribute information item with part [owner]
            2.3.2.2 element attribute information item
            2.3.2.3 type attribute information item
        2.3.3 Mapping Part's XML Representation to Component Properties
    2.4 Interface
        2.4.1 The Interface Component
        2.4.2 XML Representation of Interface Component
            2.4.2.1 name attribute information item with interface [owner]
            2.4.2.2 extends attribute information item
            2.4.2.3 encodingStyleDefault attribute information item with interface [owner]
        2.4.3 Mapping Interface's XML Representation to Component Properties
    2.5 Feature
        2.5.1 The Feature Component
        2.5.2 XML Representation of Feature Component
            2.5.2.1 uri attribute information item with feature [owner]
            2.5.2.2 required attribute information item with feature [owner]
        2.5.3 Mapping Feature's XML Representation to Component Properties
    2.6 Property
        2.6.1 The Property Component
        2.6.2 XML Representation of Property Component
            2.6.2.1 uri attribute information item with property [owner]
            2.6.2.2 required attribute information item with feature [owner]
            2.6.2.3 value element information item with property [parent]
            2.6.2.4 constraint element information item with property [parent]
        2.6.3 Mapping Property's XML Representation to Component Properties
    2.7 Interface Operation
        2.7.1 The Interface Operation Component
        2.7.2 XML Representation of Interface Operation Component
            2.7.2.1 name attribute information item with operation [owner]
            2.7.2.2 pattern attribute information item with operation [owner]
            2.7.2.3 encodingStyle attribute information item with operation [owner]
        2.7.3 Mapping Interface Operation's XML Representation to Component Properties
    2.8 Message Reference
        2.8.1 The Message Reference Component
        2.8.2 XML Representation of Message Reference Component
            2.8.2.1 name attribute information item with input, or output [owner]
            2.8.2.2 message attribute information item with input, or output [owner]
            2.8.2.3 body attribute information item with input, or output [owner]
            2.8.2.4 headers attribute information item with input, or output [owner]
        2.8.3 Mapping Message Reference's XML Representation to Component Properties
    2.9 Fault Reference
        2.9.1 The Fault Reference Component
        2.9.2 XML Representation of Fault Reference Component
            2.9.2.1 name attribute information item with infault or outfault [owner]
            2.9.2.2 messages attribute information item with infault or outfault [owner]
        2.9.3 Mapping Fault Reference's XML Representation to Component Properties
    2.10 Binding
        2.10.1 The Binding Component
        2.10.2 XML Representation of Binding Component
            2.10.2.1 name attribute information item with binding [owner]
            2.10.2.2 interface attribute information item with binding [owner]
            2.10.2.3 Binding extension elements
        2.10.3 Mapping Binding's XML Representation to Component Properties
    2.11 Binding Operation
        2.11.1 The Binding Operation Component
        2.11.2 XML Representation of Binding Operation Component
            2.11.2.1 name attribute information item with operation [owner]
            2.11.2.2 Binding Operation extension elements
        2.11.3 Mapping Binding Operation's XML Representation to Component Properties
    2.12 Binding Message Reference
        2.12.1 The Binding Message Reference Component
        2.12.2 XML Representation of Binding Message Reference Component
            2.12.2.1 name attribute information item with input, output or fault [owner]
            2.12.2.2 Binding Message Reference extension elements
        2.12.3 Mapping Binding Message Reference's XML Representation to Component Properties
    2.13 Service
        2.13.1 The Service Component
        2.13.2 XML Representation of Service Component
            2.13.2.1 name attribute information item with service [owner]
            2.13.2.2 interface attribute information item with service [owner]
        2.13.3 Mapping Service's XML Representation to Component Properties
    2.14 Endpoint
        2.14.1 The Endpoint Component
        2.14.2 XML Representation of Endpoint Component
            2.14.2.1 name attribute information item with endpoint [owner]
            2.14.2.2 binding attribute information item with endpoint [owner]
            2.14.2.3 Endpoint extension elements
        2.14.3 Mapping Endpoint's XML Representation to Component Properties
    2.15 Equivalence of Components
    2.16 Symbol Spaces
    2.17 QName resolution
3. Types
    3.1 Using W3C XML Schema Description Language
        3.1.1 Importing XML Schema
            3.1.1.1 namespace attribute information item
            3.1.1.2 schemaLocation attribute information item
        3.1.2 Embedding XML Schema
            3.1.2.1 targetNamespace attribute information item
        3.1.3 References to Type and Element Definitions
    3.2 Using Other Schema Languages
4. Modularizing WSDL descriptions
    4.1 Including Descriptions
        4.1.1 location attribute information item with include [owner]
    4.2 Importing Descriptions
        4.2.1 namespace attribute information item
        4.2.2 location attribute information item with import [owner]
5. Documentation
6. Language Extensibility
    6.1 Element based extensibility
        6.1.1 Mandatory extensions
        6.1.2 required attribute information item
    6.2 Attribute-based extensibility
7. References
    7.1 Normative References
    7.2 Informative References

Appendices

A. The application/wsdl+xml Media Type
    A.1 Registration
    A.2 Security considerations
B. Acknowledgements (Non-Normative)
C. URI References for WSDL constructs (Non-Normative)
    C.1 WSDL URIs
    C.2 Fragment Identifiers
    C.3 Extension Elements
    C.4 Example
    C.5 Relation to WSDL 1.1
D. Migrating from WSDL 1.1 to WSDL 1.2 (Non-Normative)
    D.1 Operation Overloading
    D.2 PortTypes
    D.3 Ports
E. Examples of Specifications of Extension Elements for Alternative Schema Language Support. (Non-Normative)
    E.1 DTD
        E.1.1 namespace attribute information item
        E.1.2 location attribute information item
        E.1.3 References to Element Definitions
    E.2 RELAX NG
        E.2.1 Importing RELAX NG
            E.2.1.1 ns attribute information item
            E.2.1.2 href attribute information item
        E.2.2 Embedding RELAX NG
            E.2.2.1 ns attribute information item
        E.2.3 References to Type and Element Definitions
F. Part 1 Change Log (Non-Normative)
    F.1 WSDL Specification Changes

1. Introduction

Web Services Description Language (WSDL) provides a model and an XML format for describing Web services. WSDL enables one to separate the description of the abstract functionality offered by a service from concrete details of a service description such as "how" and "where" that functionality is offered.

This specification defines a language for describing the abstract functionality of a service as well as a framework for describing the concrete details of a service description. The WSDL Version 1.2 Part 2: Message Patterns specification [WSDL 1.2 Message Patterns] defines define the sequence and cardinality of abstract messages sent or received by an operation. The WSDL Version 1.2 Part 3: Bindings specification [WSDL 1.2 Bindings] defines a language for describing such concrete details for SOAP 1.2 [SOAP 1.2 Part 1: Messaging Framework], HTTP [IETF RFC 2616] and MIME [IETF RFC 2045].

1.1 Web Service

WSDL describes Web services starting with the messages that are exchanged between the service provider and requester. The messages themselves are described abstractly and then bound to a concrete network protocol and message format. A message consists of a collection of typed data items. An exchange of messages between the service provider and requester is described as an operation.

A collection of operations is called an interface. An interface is bound to a concrete protocol and message format via one or more bindings. A binding, and therefore an interface, is accessible via one or more endpoint, each endpoint having its own URI. A service is a collection of endpoints bound to the same interface.

WSDL describes a Web service in two fundamental stages: one abstract and one concrete. Within each stage, the description uses a number of constructs to promote reusability of the description and separate independent design concerns.

At an abstract level, WSDL describes a Web service in terms of the messages it sends and receives; messages are described independent of a specific wire format using a type system, typically XML Schema.

An operation associates a message pattern with one or more messages. A pattern identifies the sequence and cardinality of messages sent and/or received as well as who they are logically sent to and/or received from. An interface groups together operations without any commitment to transport or wire format.

At a concrete level, a binding specifies transport and wire format details for one or more interfaces. An endpoint associates a network address with a binding. And finally, a service groups together endpoints that implement a common interface.

1.2 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].

This specification uses properties from the XML Information Set [XML Information Set]. Such properties are denoted by square brackets, e.g. [namespace name].

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


Table 1-1. Prefixes and Namespaces used in this specification
Prefix Namespace Notes
wsdl "http://www.w3.org/@@@@/@@/wsdl" A normative XML Schema [XML Schema: Structures], [XML Schema: Datatypes] document for the "http://www.w3.org/@@@@/@@/wsdl" namespace can be found at http://www.w3.org/@@@@/@@/wsdl. WSDL documents that do NOT conform to this schema are not valid WSDL documents. WSDL documents that DO conform to this schema and also conform to the other constraints defined in this specification are valid WSDL documents.
soap12 "http://www.w3.org/@@@@/@@/wsdl/soap12" Defined by WSDL 1.2: Bindings [WSDL 1.2 Bindings].
http "http://www.w3.org/@@@@/@@/wsdl/http"
mime "http://www.w3.org/@@@@/@@/wsdl/mime"
xs "http://www.w3.org/2001/XMLSchema" Defined in the W3C XML Schema specification [XML Schema: Structures], [XML Schema: Datatypes].
xsi "http://www.w3.org/2001/XMLSchema-instance"

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

All parts of this specification are normative, with the EXCEPTION of pseudo-schemas, examples, and sections explicitly marked as "Non-Normative". Pseudo-schemas are provided for each component, before the description of this component.

2. Component Model

This section describes the conceptual model for WSDL as a set of components with properties, each aspect of a Web service that WSDL can describe having its own property. In addition an XML Infoset representation for these components is provided, along with a mapping from that representation to the various component properties. How the XML Infoset representation of a given set of WSDL components is constructed is outside the scope of this specification.

2.1 Definitions

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

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

2.1.1 The Definitions Component

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

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

Type system components are element declarations and type definitions drawn from some type system. The former define the [local name], [namespace name], [children] and [attributes] properties of an element information item; the latter define only the [children] and [attributes] properties.

The properties of the Definitions component are as follows:

  • {messages} A set of named message definitions

  • {interfaces} A set of named interface definitions

  • {bindings} A set of named binding definitions

  • {services} A set of named service definitions

  • {type definitions} A set of named type definitions, each one isomorphic to a simple or complex type as defined by XML Schema

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

2.1.2 XML Representation of Definitions Component

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 target namespace represents an unambiguous name for the intended semantics of the WSDL Infoset. The targetNamespace URI SHOULD point to a human or machine processable document that directly or indirectly defines the semantics of the WSDL Infoset.

The definitions element information item has the following Infoset properties:

  • A [local name] of definitions .

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

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

    • A 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/@@@@/@@/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/@@@@/@@/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:

  • 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 allowed at the top-level of a WSDL document as described in 6. Language Extensibility.

2.1.2.1 targetNamespace attribute information item

The targetNamespace attribute information item defines the namespace affiliation of top-level components defined in this definitions element information item. Messages, Interfaces, Bindings and Services are top-level components.

The targetNamespace attribute information item has the following Infoset properties:

  • A [local name] of targetNamespace

  • A [namespace name] which has no value

The type of the targetNamespace attribute information item is xs:anyURI.

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.


Table 2-1. Mapping between Definitions Component Properties and XML Representation
Property Mapping
{messages} The message definitions corresponding to all the message element information items in the [children] of the definitions element information item, if any, plus any included or imported definitions (see 4. Modularizing WSDL descriptions).
{interfaces} The interface definitions corresponding to all the interface element information items in the [children] of the definitions element information item, if any, plus any included or imported definitions (see 4. Modularizing WSDL descriptions).
{bindings} The binding definitions corresponding to all the binding element information items in the [children] of the definitions element information item, if any, plus any included or imported definitions (see 4. Modularizing WSDL descriptions).
{services} The service definitions corresponding to all the service element information items in the [children] of the definitions element information item, if any, plus any included or imported definitions (see 4. Modularizing WSDL descriptions).
{type definitions} The type definition components corresponding to all the type definitions defined as descendants of the types element information item, if any, plus any imported definitions. At a minimum this will include all the types defined by XML Schema simpleType and complexType element information items. It MAY also include any definition from some other type system which describes the [attributes] and [children] properties of an element information item.
{element declarations} The element declaration components corresponding to all the element declarations defined as descendants of the types element information item, if any, plus any imported definitions. At a minimum this will include all the global element declarations defined by XML Schema element element information items. It MAY also include any definition from some other type system which describes the [local name], [namespace name], [attributes] and [children] properties of an element information item.

2.2 Message

<definitions>
  <message
        name="xs:NCName" >
    <documentation />?
    <part />*
  </message>
</definitions>

2.2.1 The Message Component

A Message component describes the abstract format of a particular message that a Web service sends or receives. The format of a message is typically described in terms of XML element information items and attribute information items. A message binding (see 2.10 Binding) describes how the abstract content is mapped into a concrete format. However, in some cases, the abstract definition may match the concrete representation very closely or exactly for one or more bindings. Such bindings will supply little or no mapping information. However, another binding of the same message definition may require extensive mapping information. For this reason, it is not until the binding is inspected that one can determine "how abstract" a message really is.

Messages are named constructs and can be referred to by QName (see 2.17 QName resolution). For instance, Interface components refer to messages in this way (see 2.8 Message Reference).

The properties of the Message component are as follows:

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

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

  • {parts} A list of named part definitions.

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

2.2.2 XML Representation of Message Component

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

  • A [local name] of message

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

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

  • 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 part element information items (see 2.3.2 XML Representation of Part 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/@@@@/@@/wsdl".

  • 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 messages described in 6. Language Extensibility.

2.2.2.1 name attribute information item with message [owner]

The name attribute information item together with the targetNamespace attribute information item of the definitions element information item forms the QName of the message,

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.

2.2.3 Mapping Message's XML Representation to Component Properties

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


Table 2-2. Mapping between Message Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item
{target namespace} The actual value of the targetNamespace attribute information item of the [parent] definitions element information item
{parts} The list of part definitions corresponding to the part element information items in [children], if any.

2.3 Part

<definitions>
  <message>
    <part
          name="xs:NCName" 
          element="xs:QName"? 
          type="xs:QName"? >
      <documentation />?
    </part>
  </message>
</definitions>

2.3.1 The Part Component

A Part component describes a portion of a particular message that a Web service sends or receives. The format of a part is described by reference to type definition or element declaration components. Such components may be drawn from any appropriate type system. However WSDL makes special recognition of the XML Schema language [XML Schema: Structures],[XML Schema: Datatypes] as the RECOMMENDED type specification language (see 3. Types).

Part components are local to a given Message component; they cannot be referred to by QName.

The properties of the Part component are as follows:

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

  • {content reference} A reference to either an element declaration or a type definition component

For each Part component in the {parts} property of a given Message component the {name} property MUST be unique.

2.3.2 XML Representation of Part Component

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

  • A [local name] of part

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

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

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

    • One of the following:

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

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

    1. An optional documentation element information item (see 5. Documentation) amongst its [children].

    2. Zero or more namespace qualified element information items. Such element information items MUST be a member of one of the element substitution groups related to message parts described in 6. Language Extensibility.

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

A part carries information about its type system by the reference contained in the type , element , or alternative qualified attribute information item. The schema language used is determined by examining the referred-to namespace and associating it with an imported or embedded schema. WSDL uses the type and element attribute information items to refer to constructs in XML Schema [XML Schema: Structures],[XML Schema: Datatypes]. Alternative schema languages may re-use these attribute information items if appropriate. If the concepts embodied by the type and element attribute information item are not appropriate for an alternative schema language, that language should specify an alternative attribute information item with prescribed semantics. Such attribute information items are not defined by this specification.

2.3.2.1 name attribute information item with part [owner]

The name attribute information item identifies a given part element information item inside a given message element information item.

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.

2.3.2.2 element attribute information item

The element attribute information item refers, by QName, to an element declaration component.

The element attribute information item has the following Infoset properties:

  • A [local name] of element

  • A [namespace name] which has no value

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

2.3.2.3 type attribute information item

The type attribute information item refers, by QName, to a type description 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.

2.3.3 Mapping Part's XML Representation to Component Properties

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


Table 2-3. Mapping between Part Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item
{content reference} The element declaration resolved to by the value of the element attribute information item if present, otherwise the type definition resolved to by the value of the type attribute information item if present, otherwise a similar construct in some type system as referred to by some other attribute information item.

2.4 Interface

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

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

2.4.1 The Interface Component

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

An interface can optionally extend one or more other interfaces. In such cases the interface contains the operations of the interfaces it extends, along with any operations it defines. The interfaces a given interface extends MUST NOT themselves extend that interface either directly or indirectly.

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

The properties of the Interface component are as follows:

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

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

  • {extended interfaces} A set of named interface definitions.

  • {operations} A set of named interface operation definitions.

  • {features} A set of named feature definitions.

  • {properties} A set of named property definitions.

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

2.4.2 XML Representation of Interface Component

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

2.4.2.1 name attribute information item with interface [owner]

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

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.

2.4.2.2 extends attribute information item

The extends attribute information item lists the interfaces that this interface derives from.

The extends attribute information item has the following Infoset properties:

  • A [local name] of extends

  • A [namespace name] which has no value

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

2.4.2.3 encodingStyleDefault attribute information item with interface [owner]

The encodingStyleDefault attribute information item indicates the default encoding style used by the message schema for all operations contained within the [owner] interface .

The encodingStyleDefault attribute information item has the following Infoset properties:

  • A [local name] of encodingStyleDefault.

  • A [namespace name] which has no value.

The type of the encodingStyleDefault attribute information item is xs:anyURI.

2.4.3 Mapping Interface's XML Representation to Component Properties

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


Table 2-4. Mapping between Interface Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item
{target namespace} The actual value of the targetNamespace attribute information item of the [parent] definitions element information item
{extended interfaces} The set of interface definitions resolved to by the values in the extends attribute information item if any, plus the set of interface definitions in the {extended interfaces} property of those interface definitions, otherwise empty.
{operations} The set of interface operation definitions corresponding to the operation element information items in [children], if any, plus the set of interface operation definitions in the {operations} property of the interface definitions in {extended interfaces}, if any.
{features} The set of feature definitions corresponding to the feature element information items in [children], if any, plus the set of feature definitions in the {features} property of the feature definitions in {extended interfaces}, if any.
{properties} The set of property definitions corresponding to the property element information items in [children], if any, plus the set of property definitions in the {properties} property of the property definitions in {extended interfaces}, if any.

Note:

Per 2.4.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.5 Feature

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

2.5.1 The Feature Component

A Feature component describes a particular feature that a Web service accepts or requires in particular interactions. Features can be engaged in inbound, outbound messages, or both. Features in the Feature component are identified by their URI. Unless otherwise specified, recognizing a feature's URI is assumed to be semantically equivalent to understanding the feature's specification.

The properties of the Feature component are as follows:

2.5.2 XML Representation of Feature Component

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/@@@@/@@/wsdl"

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

  • 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 amongst its [children]. Such element information items MUST be a member of one of the element substitution groups related to features described in 6. Language Extensibility.

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

2.5.2.1 uri attribute information item with feature [owner]

The uri attribute information item specifies the URI of the feature.

The uri attribute information item has the following Infoset properties:

  • A [local name] of uri

  • A [namespace name] which has no value

The type of the uri attribute information item is xs:anyURI .

2.5.2.2 required attribute information item with feature [owner]

The required attribute information item specifies whether the use of the feature is mandatory or optional.

The required attribute information item has the following Infoset properties:

  • A [local name] of required

  • A [namespace name] which has no value

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

2.5.3 Mapping Feature's XML Representation to Component Properties

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


Table 2-5. Mapping between Feature Component Properties and XML Representation
Property Mapping
{name} The actual value of the uri attribute information item
{required} If the value of the required attribute information item is "true" or "1", then "true", otherwise "false".

2.6 Property

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

2.6.1 The Property Component

A Property component describes the set of possible values for a particular property. The permissible values are specified by references to a Schema description. A property is typically used to control a feature's behavior. Properties, and hence property values, can be shared amongst features.

The properties of the Property component are as follows:

  • {name} A URI as defined by [IETF RFC 2396].

  • {required} A boolean value.

  • {value constraint} A type definition constraining the value of the property.

2.6.2 XML Representation of Property Component

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

2.6.2.1 uri attribute information item with property [owner]

The uri attribute information item specifies the URI of the property. It has the following Infoset properties:

  • A [local name] of uri

  • A [namespace name] which has no value

The type of the uri attribute information item is xs:anyURI .

2.6.2.2 required attribute information item with feature [owner]

The required attribute information item specifies whether the use of the property is mandatory or optional.

The required attribute information item has the following Infoset properties:

  • A [local name] of required

  • A [namespace name] which has no value

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

2.6.2.3 value element information item with property [parent]
<property>
  <value>
    xs:anySimpleType
  </value>
</property>

The value element information item specifies the value of the property. It has the following Infoset properties:

  • A [local name] of value

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

The type of the value element information item is xs:anySimpleType .

2.6.2.4 constraint element information item with property [parent]
<property>
  <constraint>
    xs:QName
  </constraint>
</property>

The constraint element information item specifies a constraint on the value of the property. It has the following Infoset properties:

  • A [local name] of constraint

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

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

2.6.3 Mapping Property's XML Representation to Component Properties

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


Table 2-6. Mapping between Property Component Properties and XML Representation
Property Mapping
{name} The actual value of the uri attribute information item
{value constraint} If the constraint element information item is present, the type referred to by the value of this element information item. Otherwise, if the value element information item is present, an anonymous simple type, whose base type is "xs:anySimpleType", with a single "enumeration" facet whose value is that of the element information item. Otherwise, "xs:anySimpleType".

2.7 Interface Operation

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

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

2.7.1 The Interface Operation Component

An Interface Operation component describes an operation that a given interface supports. An operation is a set of message references and an associated message pattern. Message references are references either to messages accepted by this operation (input messages), or messages sent by this operation (output messages). Such messages may be ordinary messages or fault messages.

Interface Operation components are local to Interface components; they cannot be referred to by QName, despite having both {name} and {target namespace} properties

The properties of the Interface Operation component are as follows:

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

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

  • {message pattern} A URI identifying the message pattern used by the operation

  • {message references} A set of Message Reference components for the ordinary messages the operation accepts or sends

  • {fault references} A set of Fault Reference components for the fault messages the operation accepts or sends

  • {encoding style} A URI identifying the encoding rules that were used to construct the {body} properties of {message references}.

  • {features} A set of named feature definitions used by the operation

  • {properties} A set of named property definitions used by the operation

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

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.15 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:

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. Therefore it is considered good practice to ensure, where necessary, that operation names within a namespace are unique, thus allowing such derivation to occur without error.

2.7.2 XML Representation of Interface Operation Component

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

2.7.2.1 name attribute information item with operation [owner]

The name attribute information item identifies a given operation element information item inside a given interface element information item.

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.

2.7.2.2 pattern attribute information item with operation [owner]

The pattern attribute information item identifies the message pattern a given operation uses.

The pattern attribute information item has the following Infoset properties:

  • A [local name] of pattern

  • A [namespace name] which has no value

The type of the pattern attribute information item is xs:anyURI.

2.7.2.3 encodingStyle attribute information item with operation [owner]

The encodingStyle attribute information item indicates the encoding rules that were used to construct the element declaration components referred to the Message Reference components of the [owner] operation.

The encodingStyle attribute information item has the following Infoset properties:

  • A [local name] of encodingStyle

  • A [namespace name] which has no value

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

2.7.3 Mapping Interface Operation's XML Representation to Component Properties

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


Table 2-7. Mapping between Interface Operation Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item
{target namespace} The actual value of the targetNamespace attribute information item of the [parent] definitions element information item of the [parent] interface element information item.
{message pattern} The actual value of the pattern attribute information item
{message references} The set of message references corresponding to the input and output element information items in [children], if any.
{fault references} The set of fault references corresponding to the infault and outfault element information items in [children] if any.
{encoding style} The actual value of the encodingStyle attribute information item if present, otherwise the actual value of the encodingStyleDefault attribute information item of the [parent] interface element information item if present, otherwise none.
{features} The set of features corresponding to the feature element information items in [children], if any.
{properties} The set of properties corresponding to the property element information items in [children], if any.

2.8 Message Reference

<definitions>
  <interface>
    <operation>
      <input
            name="xs:NCName"? 
            message="xs:QName" >
        <documentation />?
      </input>
      <output
            name="xs:NCName"? 
            message="xs:QName" >
        <documentation />?
      </output>
    </operation>
  </interface>
</definitions>

<definitions>
  <interface>
    <operation>
      <input
            name="xs:NCName"? 
            body="xs:QName"?
            headers="list of xs:QName"? >
        <documentation />?
      </input>
      <output
            name="xs:NCName"?
            body="xs:QName"?
            headers="list of xs:QName"? >
        <documentation />?
      </output>
    </operation>
  </interface>
</definitions>

2.8.1 The Message Reference Component

A Message Reference component refers to a named message that forms part of an operation.

A Message Reference component refers to element declarations that define message body and header content.

Message Reference components are local to a given Interface Operation component; they cannot be referred to by QName

The properties of the Message Reference component are as follows:

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

  • {direction} One of in or out.

  • {message} A reference, by QName (see 2.17 QName resolution), to a named Message component.

  • {body} A reference to an element declaration

  • {headers} A set of references to element declarations

The {name} property disambiguates between two or more Message Reference components with the same {direction}, allowing placeholders within the message pattern (identified by the {message pattern} property of the containing Interface Operation component) to unambiguously refer to Message Reference components.

For each Message Reference component in the {message references} and {fault references} properties of an Interface operation component the {name} property must be unique.

2.8.2 XML Representation of Message Reference Component

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

2.8.2.1 name attribute information item with input , or output [owner]

The name attribute information item identifies a given message reference element information item within a given operation element information item.

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.

2.8.2.2 message attribute information item with input , or output [owner]

The message attribute information item refers, by QName, to a Message component.

The message attribute information item has the following Infoset properties:

  • A [local name] of message

  • A [namespace name] which has no value

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

2.8.2.3 body attribute information item with input , or output [owner]

The body attribute information item refers, by QName, to an element declaration component.

The body attribute information item has the following Infoset properties:

  • A [local name] of body .

  • A [namespace name] which has no value.

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

2.8.2.4 headers attribute information item with input , or output [owner]

The headers attribute information item refers, by QName, to a set of element declaration components.

The headers attribute information item has the following Infoset properties:

  • A [local name] of headers .

  • A [namespace name] which has no value.

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

2.8.3 Mapping Message Reference's XML Representation to Component Properties

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


Table 2-8. Mapping between Message Reference Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item
{direction} If the [local name] of the element information item is input then "in", else if the [local name] of the element information item is output then "out".
{message} The Message component resolved to by the value of the message attribute information item.
{body} The element declaration resolved to by the value of the body attribute information item if present, otherwise a similar construct in some type system as referred to by some other attribute information item.
{headers} The element declarations resolved to by the value of the headers attribute information item if present, otherwise a similar construct in some type system as referred to by some other attribute information item.

2.9 Fault Reference

Editorial note: JCS20030804
The WG has not yet finalized a design for Fault Reference components that do not use the recently-removed Message component. 
<definitions>
  <interface>
    <operation>
      <infault
            name="xs:NCName" 
            messages="list of xs:QName" >
        <documentation />?
      </infault>
      <outfault
            name="xs:NCName" 
            messages="list of xs:QName" >
        <documentation />?
      </outfault>
    </operation>
  </interface>
</definitions>

2.9.1 The Fault Reference Component

A Fault Reference component refers to named fault messages that form part of an operation.

Fault Reference components are local to a given Interface Operation component; they cannot be referred to by QName.

The properties of the Fault Reference component are as follows:

For each Fault Reference component in the {fault references} properties of an Interface Operation component the {name} property must be unique.

2.9.2 XML Representation of Fault Reference Component

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/@@@@/@@/wsdl"

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

  • 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. Such element information items MUST be a member of one of the element substitution groups related to infault or outfault children of interface operations described in 6. Language Extensibility.

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

2.9.2.1 name attribute information item with infault or outfault [owner]

The name attribute information item identifies a given fault reference element information item within a given operation element information item.

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.

2.9.2.2 messages attribute information item with infault or outfault [owner]

The messages attribute information item refers, by QNames, to a set of Message components.

The messages attribute information item has the following Infoset properties:

  • A [local name] of message

  • A [namespace name] which has no value

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

2.9.3 Mapping Fault Reference's XML Representation to Component Properties

The mapping between the properties of the Fault Reference component (see 2.8.1 The Message Reference Component) and the XML Representation of the fault reference element information item (see 2.9.2 XML Representation of Fault Reference Component) is as described in Table 2-9.


Table 2-9. Mapping between Fault Reference Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item
{direction} If the [local name] of the element information item is infault then "in", else if the [local name] of the element information item is outfault then "out".
{messages} The Message components resolved to by the value of the QNames listed in the message attribute information item.

2.10 Binding

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

2.10.1 The Binding Component

A Binding component describes a concrete binding of an Interface component and associated operations to a particular concrete message format and transmission protocol.

A Binding component describes a concrete message format and transmission protocol.

A Binding component MAY specify operation-specific binding details (see 2.11.1 The Binding Operation Component); if it does so, the Binding component MUST specify an interface the Binding component applies to.

Conversely, a Binding component MAY omit any operation-specific binding details and 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.

No concrete binding details are given in this specification. The companion specification, WSDL (Version 1.2): Bindings [WSDL 1.2 Bindings] defines such bindings for

SOAP 1.1 [SOAP 1.1],

SOAP 1.2 [SOAP 1.2 Part 1: Messaging Framework], HTTP [IETF RFC 2616] and MIME [IETF RFC 2045]. 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 2.17 QName resolution). For instance, Endpoint components refer to bindings in this way.

The properties of the Binding component are as follows:

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

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

  • {interface} An optional, named interface definition

  • {operations} A set of named binding operation definitions

  • {features} A set of named feature definitions

  • {properties} A set of named property definitions

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

2.10.2 XML Representation of Binding Component

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

2.10.2.1 name attribute information item with binding [owner]

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.

2.10.2.2 interface attribute information item with binding [owner]

The interface attribute information item refers, by QName, to an Interface component.

The interface attribute information item has the following Infoset properties:

  • A [local name] of interface

  • A [namespace name] which has no value

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

2.10.2.3 Binding extension elements

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.

2.10.3 Mapping Binding's XML Representation to Component Properties

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


Table 2-10. Mapping between Binding Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item
{target namespace} The actual value of the targetNamespace attribute information item of the [parent] definitions element information item.
{interface} The Interface component resolved to by the actual value of the interface attribute information item, if any.
{operations} The set of Binding Operation components corresponding to the operation element information items in [children], if any.
{features} The set of Feature components corresponding to the feature element information items in [children], if any.
{properties} The set of Property components corresponding to the property element information items in [children], if any.

2.11 Binding Operation

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

2.11.1 The Binding Operation Component

A Binding Operation component describes a concrete binding for a particular operation of an interface to a particular concrete message format.

Binding Operation components are local to a given Binding component.

The properties of the Binding Operation component are as follows:

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

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

  • {messages} A set of Binding Message Reference components

For each Binding Operation component in the {operations} property of a Binding component the combination of {name} and {target namespace} properties must be unique.

2.11.2 XML Representation of Binding Operation Component

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/@@@@/@@/wsdl"

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

  • 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 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 binding operations described in 6. Language Extensibility. 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.2.1 name attribute information item with operation [owner]

The name attribute information item identified a given operation element information item within a given binding element information item.

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.

2.11.2.2 Binding Operation extension elements

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

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 binding element information item (see 2.11.2 XML Representation of Binding Operation Component) is as described in Table 2-11.


Table 2-11. Mapping between Binding Operation Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item.
{target namespace} The actual value of the targetNamespace attribute information item of the [parent] definitions element information item of the [parent] interface element information item.
{messages} The set of Binding Message Reference components corresponding to the input , output and fault element information items in [children], if any.
{features} The set of Feature components corresponding to the feature element information item in [children], if any.
{properties} The set of Property components corresponding to the property element information item in [children], if any.

2.12 Binding Message Reference

<definitions>
  <binding>
    <operation>
      <input
            name="xs:NCName"? >
        <documentation />?
      </input>
      <output
            name="xs:NCName"? >
        <documentation />?
      </output>
      <infault
            name="xs:NCName" >
        <documentation />?
      </infault>
      <outfault
            name="xs:NCName" >
        <documentation />?
      </outfault>
    </operation>
  </binding>
</definitions>

2.12.1 The Binding Message Reference Component

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

Binding Message Reference components are local to a given Binding Operation component; they cannot be referred to by QName.

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

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

  • {direction} One of 'in' or 'out'.

For each Binding Message Reference component in the {messages} property of a Binding Operation component the {name} property must be unique.

2.12.2 XML Representation of Binding Message Reference Component

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

  • A [local name] of input , output , infault or outfault .

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

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

  • 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. Such element information items MUST be a member of one of the element substitution groups related to input, output or fault children of binding operations described in 6. Language Extensibility. 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).

      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/@@@@/@@/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.2.1 name attribute information item with input , output or fault [owner]

The name attribute information item identifies a given binding message reference element information item within a given operation element information item.

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.

2.12.2.2 Binding Message Reference extension elements

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.

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-12.


Table 2-12. Mapping between Binding Message Reference Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item if present, otherwise the actual value of the name attribute information item on the element information item with the same [local name] whose [parent] operation element information item has the same value for its name attribute information item as the operation element information item in the binding element information item but is rather in the interface element information item referred to by the type attribute information item.
{variety} If the [local name] of the element information item is input or infault then in, else if the [local name] of the element information item is output or outfault then out.

2.13 Service

<definitions>
  <service
        name="xs:NCName" 
        interface="xs:QName" 
    <documentation />?
    <endpoint />*
  </service>
</definitions>

2.13.1 The Service Component

A Service component describes one and only one interface that a service provides, and the endpoints it is provided over.

Service are named constructs and can be referred to by QName (see 2.17 QName resolution).

The properties of the Service component are as follows:

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

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

  • {interface} An Interface component.

  • {endpoints} A set of Endpoint 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

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/@@@@/@@/wsdl"

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

  • 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 namespace-qualified element information items amongst its [children]. The [namespace name] of such element information items MUST NOT be "http://www.w3.org/@@@@/@@/wsdl".

  • 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 services described in 6. Language Extensibility.

2.13.2.1 name attribute information item with service [owner]

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

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.

2.13.2.2 interface attribute information item with service [owner]

The interface attribute information item identifies the interface that the service is an instantiation of.

The interface attribute information item has the following Infoset properties:

  • A [local name] of interface

  • A [namespace name] which has no value

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

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

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-13.


Table 2-13. Mapping between Service Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item
{target namespace} The actual value of the targetNamespace attribute information item of the [parent] definitions element information item
{interface} The Interface component resolved to by the actual value of the interface attribute information item on the bindings resolved to by the binding attribute information item on the endpoint element information items in [children], if any. The Interface component resolved to by the actual value of the interface attribute information item.
{endpoints} The Endpoint components corresponding to the endpoint element information items in [children] if any.

2.14 Endpoint

<definitions>
  <service>
    <endpoint
          name="xs:NCName" 
          binding="xs:QName" >
      <documentation />?
    </endpoint>
  </service>
</definitions>

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} An NCName as defined by [XML Namespaces].

  • {binding} A named Binding component.

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.10.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

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/@@@@/@@/wsdl".

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

  • 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 namespace qualified element information items. Such element information items MUST be a member of one of the element substitution groups related to endpoints described in 6. Language Extensibility. Such element information items are considered to be endpoint extension elements (see 2.14.2.3 Endpoint extension elements).

      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/@@@@/@@/wsdl". Such element information items are considered to be endpoint extension elements (see 2.14.2.3 Endpoint extension elements).

2.14.2.1 name attribute information item with endpoint [owner]

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

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.

2.14.2.2 binding attribute information item with endpoint [owner]

The binding attribute information item refers, by QName, to a Binding component

The binding attribute information item has the following Infoset properties:

  • A [local name] of binding

  • A [namespace name] which has no value

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

2.14.2.3 Endpoint extension elements

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

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-14.


Table 2-14. Mapping between Endpoint Component Properties and XML Representation
Property Mapping
{name} The actual value of the name attribute information item
{binding} The Binding component resolved to by the actual value of the binding attribute information item.

2.15 Equivalence of Components

Two components of the same type are considered equivalent if the values of the properties of one component are the same as the values of the properties in the second component.

With respect to top-level components (Messages, Interfaces, Bindings and Services) this effectively translates to name-based equivalence given the constraints on names. That is, given two top-level components of the same type, if the {name} properties have the same value and the {target namespace} properties have the same values then the two components are in fact, the same component.

With respect to top-level components (Interfaces, Bindings and Services) this effectively translates to name-based equivalence given the constraints on names. That is, given two top-level components of the same type, if the {name} properties have the same value and the {target namespace} properties have the same values then the two components are in fact, the same component.

2.16 Symbol Spaces

This specification defines 4 symbol spaces, one for each top-level component type (Message, Interface, Binding and Service).

This specification defines 3 symbol spaces, one for each top-level component type (Interface, Binding and Service).

Within a symbol space all names, that is the combination of {name} and {target namespace} properties, are unique. Between symbol spaces, the combination of these two properties need not be unique. Thus it is perfectly coherent to have, for example, a binding and an interface that have the same name.

When XML Schema is being used as one of the type systems for a WSDL description, then 6 other symbol spaces also exist, one for each of global element declarations, global attribute declarations, named model groups, named attribute groups, type definitions and key constraints, as defined by [XML Schema: Structures]. Other type systems may define additional symbol spaces.

2.17 QName resolution

In its serialized form WSDL makes significant use of references between components. Such references are made using the Qualified Name, or QName, of the component being referred to. QNames are a tuple, consisting of two parts; a namespace name and a local name. For example, in the case of an Interface component, the namespace name is represented by the {namespace name} property and the local name is represented by the {name} property.

QName references are resolved by looking in the appropriate property of the Definitions component. For example, to resolve a QName of an interface (as referred to by the interface attribute information item on a binding), the {interfaces} property of the Definitions component would be inspected.

If the appropriate property of the Definitions component does not contains a component with the required QName then the reference is a broken reference, it cannot be resolved.

3. Types

<definitions>
  <types>
    <documentation />?
    [extension elements]*
  </types>
</definitions>

At the abstract level, the {type definitions} and {element declarations} properties of 2.1.1 The Definitions Component are collections of imported and embedded schema components. By design, WSDL supports any schema language for which the syntax and semantics of import or embed have been defined. Support for the W3C XML Schema Description Language [XML Schema: Structures],[XML Schema: Datatypes] is required of all processors. Instances of WSDL may require support for an alternative schema language by using the standard wsdl:required attribute information item (any imported or embedded XML Schema element information items may be regarded as having this attribute information item set). Only the XML Schema implementation is defined in this specification.

The schema components contained in the {type definitions} and {element declarations} properties of 2.1.1 The Definitions Component provide the type system used for message parts. Message parts indicate their structure and content by using the standard attribute information items type and element , or for alternate schema languages in which these concepts do not map well, by defining alternative attribute information item extensions to the part element information item. Such extensions should define how they reference type system components. Such type system components MAY appear in additional collection properties on 2.1.1 The Definitions Component.

The schema components contained in the {type definitions} and {element declarations} properties of 2.1.1 The Definitions Component provide the type system used for Message Reference and Fault Reference components. Message Reference components indicate their structure and content by using the standard attribute information items body and headers , or for alternate schema languages in which these concepts do not map well, by defining alternative attribute information item extensions to the Message Reference components. Fault Reference components behave similarly. Such extensions should define how they reference type system components. Such type system components MAY appear in additional collection properties on 2.1.1 The Definitions Component.

The types element information item encloses data type definitions used to define messages and has the following Infoset properties:

3.1 Using W3C XML Schema Description Language

XML Schema MAY be used as the schema language, via import or embedding. Each method defines a different element information item. All processors MUST support XML Schema type definitions. Using the xs:import and/or xs:schema constructs is a necessary condition for making XML Schema components available to a WSDL description. That is, a WSDL description cannot refer to XML Schema components in a given namespace unless an xs:import and/or xs:schema statement for that namespace is present.

3.1.1 Importing XML Schema

Importing an XML Schema uses the xs:import mechanism defined by XML Schema [XML Schema: Structures],[XML Schema: Datatypes], with its syntax and semantics, plus some restrictions. The schema components defined in the imported schema are available for reference by QName (see 2.17 QName resolution). Note that only components defined in the schema itself and components included 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 namespace attribute information item as described below.

    • An optional schemaLocation attribute information item as described below.

3.1.1.1 namespace attribute information item

The namespace attribute information item defines the namespace of the type and element definitions imported from the referenced schema. If the referenced schema contains a targetNamespace attribute information item on its xs:schema element information item, then these values of these two attribute information items MUST be identical. If the schema does not have a targetNamespace attribute information item, then the namespace specified by the namespace attribute information item is applied to all components of the schema as if it contained a corresponding targetNamespace declaration. The namespace attribute information item has the following Infoset properties:

  • A [local name] of namespace

  • A [namespace name] which has no value.

The type of the namespace attribute information item is xs:anyURI.

3.1.1.2 schemaLocation attribute information item

The schemaLocation attribute information item, if present, provides a hint to the processor as to where the schema may be located. Caching and cataloging technologies may provide better information than this hint. The schemaLocation attribute information item has the following infoset properties:

  • A [local name] of schemaLocation.

  • A [namespace name] that has no value.

The type of the schemaLocation attribute information item is xs:anyURI.

3.1.2 Embedding XML Schema

Embedding an XML schema uses the existing top-level xs:schema element information item. 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.17 QName resolution). Note that only components defined in the schema itself and components included via xs:include are available to WSDL. Specifically components that the schema imports via xs:import are NOT available to WSDL.

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 targetNamespace attribute information item, amongst its [attributes] as described below.

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

  • Child element information items as specified for the xs:schema element information item in the XML Schema specification.

3.1.2.1 targetNamespace attribute information item

The targetNamespace attribute information item defines the namespace of the type and element definitions embedded in this schema. WSDL modifies the XML Schema definition of the xs:schema element information item to make this attribute information item required. The targetNamespace attribute information item has the following infoset properties:

  • A [local name] of targetNamespace.

  • A [namespace name] that has no value.

The type of the targetNamespace attribute information item is xs:anyURI.

3.1.3 References to Type and Element Definitions

Whether embedded or imported, the type and element definitions present in a schema may be referenced from a message part.

Whether embedded or imported, the element definitions present in a schema may be referenced from a Message Reference or Fault Reference component.

A named, global xs:simpleType or xs:complexType definition may be referenced from the part element information item using the type attribute information item. The QName is constructed from the targetNamespace of the schema and the content of the name attribute information item of the simpleType or complexType element information item. A type attribute information item may not be used to refer to an xs:element element information item.

A named, global xs:element definition may be referenced from the part element information item using the element attribute information item. The QName is constructed from the targetNamespace of the schema and the content of the name attribute information item of the xs:element element information item. An element attribute information item may not be used to refer to an xs:simpleType or xs:complexType element information item.

3.2 Using Other Schema Languages

Since it is unreasonable to expect that a single schema language can be used to describe all possible message parts and their constraints, WSDL allows alternate schema languages to be specified via extensibility elements. An extensibility element information item MAY appear under the types element information item to identify the schema language employed, and to locate the schema instance defining the grammar for message parts. Depending upon the schema language used, an element information item MAY be defined to allow embedding, if and only if the schema language can be expressed in XML. A specification of extension syntax for an alternative schema language MUST include an element information item definition, intended to appear as a child of the wsdl:types element information item, which references, names, and locates the schema instance (an "import" element information item). The extension specification SHOULD, if necessary, define additional properties of 2.1.1 The Definitions Component to hold the components of the referenced type system. It is expected that additional extensibility attributes for wsdl:part will also be defined, along with a mechanism for resolving the values of those attributes to a particular imported type system component.

Since it is unreasonable to expect that a single schema language can be used to describe all possible Message Reference and Fault Reference component content and their constraints, WSDL allows alternate schema languages to be specified via extensibility elements. An extensibility element information item MAY appear under the types element information item to identify the schema language employed, and to locate the schema instance defining the grammar for Message Reference and Fault Reference components. Depending upon the schema language used, an element information item MAY be defined to allow embedding, if and only if the schema language can be expressed in XML. A specification of extension syntax for an alternative schema language MUST include an element information item definition, intended to appear as a child of the wsdl:types element information item, which references, names, and locates the schema instance (an "import" element information item). The extension specification SHOULD, if necessary, define additional properties of 2.1.1 The Definitions Component to hold the components of the referenced type system. It is expected that additional extensibility attributes for Message Reference and Fault Reference components will also be defined, along with a mechanism for resolving the values of those attributes to a particular imported type system component.

See E. Examples of Specifications of Extension Elements for Alternative Schema Language Support. for examples of using other schema languages. These example reuse the {element declarations} and {type definitions} properties of 2.1.1 The Definitions Component and the type and element attribute information items of wsdl:part .

4. Modularizing WSDL descriptions

This specification provides two mechanisms, described in this section, for modularizing WSDL descriptions. These mechanisms help to make WSDL descriptions clearer by allowing separation of the various components of a description. Such separation could be performed according to the level of abstraction of a given set of components, or according to the namespace affiliation required of a given set of components or according to some other grouping such as application applicability.

Both mechanisms work at the level of WSDL components and NOT at the level of XML Information Sets or XML 1.0 serializations.

4.1 Including Descriptions

<definitions>
  <include
        location="xs:anyURI" >
    <documentation />?
  </include>
</definitions>

The WSDL include element information item allows for the separation of different components of a service definition, from the same target namespace, into independent WSDL documents which can be merged as needed.

The WSDL include element information item is modeled after the XML Schema include element information item (see [XML Schema: Structures], section 4.2.3 "References to schema components in the same namespace"). Specifically it can be used to include components from WSDL descriptions that share a target namespace with the including description. Components in included descriptions are part of the component model of the including description. The included components can be referenced by QName. Note that because all WSDL descriptions have a target namespace, no-namespace includes (sometimes known as chameleon includes) never occur in WSDL.

The include element information item has:

  • A [local name] of include .

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

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

  • Zero or one element information item amongst its [children], as follows:

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 for the namespace identified by the targetNamespace attribute information item of the containing definitions element information item.

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 Importing Descriptions

<definitions>
  <import
        namespace="xs:anyURI" 
        location="xs:anyURI"? >
    <documentation />?
  </import>
</definitions>

The WSDL import element information item, like the include element information item (see 4.1 Including Descriptions) also allows for the separation of the different components of a WSDL description into independent descriptions, but in this case with different target namespaces, which can be imported as needed. This technique helps writing clearer WSDL descriptions, by separation the definitions according to their level of abstraction, and maximizes reusability.

The WSDL import element information item is modeled after the XML Schema import element information item (see [XML Schema: Structures], section 4.2.3 "References to schema components across namespaces"). Specifically it can be used to import components from WSDL descriptions that do not share a target namespace with the importing document. Components in imported descriptions are part of the component model of the importing description. The imported components can be referenced by QName. Using the import construct is a necessary condition for making components from another namespace available to a WSDL description. That is, a WSDL description cannot refer to components in a namespace other that the target namespace unless an import statement for that namespace is present.

The import element information item has the following Infoset properties:

  • A [local name] of import .

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

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

  • Zero or one element information item amongst its [children], as follows:

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 can 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 for the namespace identified by the namespace attribute information item.

The location attribute information item is optional to allow WSDL components to be constructed from information other than serialized XML 1.0 and to allow for WSDL processors that have a priori knowledge of certain namespaces.

5. Documentation

<documentation>
  [extension elements]*
</documentation>

WSDL uses the optional documentation element information item as a container for human readable documentation. The content of the element information item is arbitrary character information items and element information items ("mixed" in XML Schema[XML Schema: Structures]). The documentation element information item is allowed inside any WSDL element information item.

The documentation element information item has:

6. Language Extensibility

The schema for WSDL has two extensibility models, one based on element substitution groups and another based on qualified attributes.

The schema for WSDL has a two-part extensibility model based on namespace-qualified elements and attributes.

6.1 Element based extensibility

WSDL allows extensions to be defined in terms of element information items. Several abstract global element declarations serve as the heads of substitution groups. Some are specific to a particular point in the schema while others appear in multiple places. This allows extension to be specific to a particular point of the WSDL schema or more general. Table 6-1 shows the complete list of element substitution groups that along with their allowed locations.

WSDL allows extensions to be defined in terms of element information items. Where indicated herein, WSDL allows namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/@@@@/@@/wsdl" to appear as a child of specific element information items whose namespace name IS "http://www.w3.org/@@@@/@@/wsdl". Such element information items can be used to annotate WSDL constructs such as interface, operation, etc.

It is expected that extensions will want to add to the existing properties of components in the component model. The specification for an extension element information item should include definitions of any such properties and the mapping between the XML representation of the extension and the properties in the component model.

The WSDL schema also defines a base type for use by extensibility elements. Example 6-1 shows the type definition. The use of this type as a base type is optional. The element declarations which serve as the heads of the defined substitution groups are all of type "xs:anyType".

Extensibility elements are commonly used to specify some technology specific binding. They allow innovation in the area of network and message protocols without having to revise the base WSDL specification. WSDL recommends that specifications defining such protocols also define any necessary WSDL extensions used to describe those protocols or formats.

An extension element is said to be processed if a WSDL processor decides (through whatever means) that its parent (an element information item in the "http://www.w3.org/@@@@/@@/wsdl" namespace) will be processed. Note that it is possible for WSDL processors to process only a subset of a given WSDL document. For instance, a tool may wish to focus on interfaces and operations only, and will consequently skip bindings.


Table 6-1. Element substitution groups defined for element based extensibility
Element name Allowed in [children] property of Notes
globalExt

  • wsdl:definitions after wsdl:import , wsdl:include and wsdl:types element information items if present.

  • wsdl:message

  • wsdl:part

  • wsdl:interface

  • wsdl:operation

  • wsdl:input

  • wsdl:output

  • wsdl:fault

  • wsdl:binding

  • wsdl:service

  • wsdl:endpoint

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as a child of any element information item in the "http://www.w3.org/@@@@/@@/wsdl" namespace with the exception of wsdl:import , wsdl:include and wsdl:types .
msgAndInterfaceExt

  • wsdl:message

  • wsdl:interface

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as a child of wsdl:message and/or wsdl:interface
msgInterfaceAndBindingExt

  • wsdl:message

  • wsdl:interface

  • wsdl:binding

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as a child of wsdl:message , wsdl:interface and/or wsdl:binding
msgInterfaceBindingServiceExt

  • wsdl:message

  • wsdl:interface

  • wsdl:binding

  • wsdl:service

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as a child of wsdl:message , wsdl:interface , wsdl:binding and/or wsdl:service
bindingAndServiceExt

  • wsdl:binding

  • wsdl:service

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as a child of wsdl:binding and/or wsdl:service
preImportInclude

  • wsdl:definitions before wsdl:import and wsdl:include , if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear before the wsdl:import and wsdl:include element information items
inImportInclude

  • wsdl:definitions before, between or after wsdl:import and wsdl:include , if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear interleaved with the wsdl:import and wsdl:include element information items
preTypes

  • wsdl:definitions after wsdl:import and wsdl:include and before wsdl:types , if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear after the wsdl:import and wsdl:include element information items but before the wsdl:types element information item
postTypes

  • wsdl:definitions after wsdl:types , if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear after the wsdl:types element information item (potentially interleaved with wsdl:message , wsdl:interface , wsdl:/binding and wsdl:service element information items).
Abstract elements related to message
msgExt

  • wsdl:message

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:message
msgPrePartExt

  • wsdl:message before wsdl:part element information items, if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:message before wsdl:part
msgPostPartExt

  • wsdl:message after wsdl:part element information items, if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:message after wsdl:part
msgPartExt

  • wsdl:part

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:message/wsdl:part
Abstract elements related to interface
interfaceExt

  • wsdl:interface

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:interface
interfacePreOpExt

  • wsdl:interface before wsdl:operation element information items, if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:interface before wsdl:operation
interfacePostOpExt

  • wsdl:interface after wsdl:operation element information items, if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:interface after wsdl:operation
interfaceOpExt

  • wsdl:operation with wsdl:interface [parent]

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:operation when it is a child of wsdl:interface
interfaceOpMsgExt

  • wsdl:input with wsdl:operation [parent] which itself has wsdl:interface [parent]

  • wsdl:output with wsdl:operation [parent] which itself has wsdl:interface [parent]

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:input or wsdl:output when they appear as children of wsdl:operation which itself appears as a child of wsdl:interface
interfaceOpFaultExt

  • wsdl:fault with wsdl:operation [parent] which itself has wsdl:interface [parent]

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:fault when it appears as a child of wsdl:operation which itself appears as a child of wsdl:interface
Abstract elements related to features and properties
featureExt

  • wsdl:feature

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:feature
propertyExt

  • wsdl:property

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:property
Abstract elements related to bindings
bindingExt

  • wsdl:binding

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:binding
bindingPreOpExt

  • wsdl:binding before wsdl:operation element information items, if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:binding before wsdl:operation
bindingPostOpExt

  • wsdl:binding after wsdl:operation element information items, if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:binding after wsdl:operation
bindingOpExt

  • wsdl:operation with wsdl:binding [parent]

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:operation appearing as children of wsdl:binding
bindingOpMsgExt

  • wsdl:input with wsdl:operation [parent] which itself has wsdl:binding [parent]

  • wsdl:output with wsdl:operation [parent] which itself has wsdl:binding [parent]

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:input or wsdl:output when they appear as children of wsdl:operation which itself appears as a child of wsdl:binding
bindingOpFaultExt

  • wsdl:fault with wsdl:operation [parent] which itself has wsdl:binding [parent]

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:fault when it appears as a child of wsdl:operation which itself appears as a child of wsdl:binding
Abstract elements related to service
serviceExt

  • wsdl:service

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:service
servicePreEndpointExt

  • wsdl:service before wsdl:endpoint element information items, if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:service before wsdl:endpoint
servicePostEndpointExt

  • wsdl:service after wsdl:endpoint element information items, if present.

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:service after wsdl:endpoint
endpointExt

  • wsdl:endpoint

This element information item serves as the head of a substitution group for extensibility elements that wish to appear as children of wsdl:endpoint

Example 6-1. Base type for extensibility elements

<xs:complexType name='ExtensibilityElement' abstract='true' >
  <xs:attribute ref='wsdl:required' use='optional' />
</xs:complexType>

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". Mandatory extensions are those that MUST be processed correctly by the WSDL processor. If a mandatory extension element is processed, the WSDL processor MUST either agree to fully abide by all the rules and semantics signaled by the extension element's qualified name, or immediate cease processing (fault). In particular, if the WSDL processor does not recognize the qualified name of the extension element, it MUST fault. If the WSDL processor recognizes the qualified name, and determines that the extension in question is incompatible with any other aspect of the document (including other required extensions), it MUST fault.

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/@@@@/@@/wsdl".

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

The type of the required is xs:boolean.

6.2 Attribute-based extensibility

WSDL allows qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/@@@@/@@/wsdl" to appear on any element information item whose namespace name IS "http://www.w3.org/@@@@/@@/wsdl". Such attribute information items can be used to annotate WSDL constructs such as messages, interfaces etc.

WSDL allows qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/@@@@/@@/wsdl" to appear on any element information item whose namespace name IS "http://www.w3.org/@@@@/@@/wsdl". Such attribute information items can be used to annotate WSDL constructs such as interfaces, bindings, etc.

WSDL does not provide a mechanism for marking extension attribute information items as mandatory.

7. References

7.1 Normative References

[IETF RFC 2119]
Key words for use in RFCs to Indicate Requirement Levels, S. Bradner, Author. Internet Engineering Task Force, June 1999. Available at http://www.ietf.org/rfc/rfc2119.txt. (See http://www.ietf.org/rfc/rfc2119.txt.)
[IETF RFC 2396]
Uniform Resource Identifiers (URI): Generic Syntax, T. Berners-Lee, R. Fielding, L. Masinter, Authors. Internet Engineering Task Force, August 1998. Available at http://www.ietf.org/rfc/rfc2396.txt. (See http://www.ietf.org/rfc/rfc2396.txt.)
[XML 1.0]
Extensible Markup Language (XML) 1.0 (Second Edition), T. Bray, J. Paoli, C. M. Sperberg-McQueen, and E. Maler, Editors. World Wide Web Consortium, 10 February 1998, revised 6 October 2000. This version of the XML 1.0 Recommendation is http://www.w3.org/TR/2000/REC-xml-20001006. The latest version of XML 1.0 is available at http://www.w3.org/TR/REC-xml. (See http://www.w3.org/TR/2000/REC-xml-20001006.)
[XML Information Set]
XML Information Set, J. Cowan and R. Tobin, Editors. World Wide Web Consortium, 24 October 2001. This version of the XML Information Set Recommendation is http://www.w3.org/TR/2001/REC-xml-infoset-20011024. The latest version of XML Information Set is available at http://www.w3.org/TR/xml-infoset. (See http://www.w3.org/TR/2001/REC-xml-infoset-20011024.)
[XML Namespaces]
Namespaces in XML, T. Bray, D. Hollander, and A. Layman, Editors. World Wide Web Consortium, 14 January 1999. This version of the XML Information Set Recommendation is http://www.w3.org/TR/1999/REC-xml-names-19990114. The latest version of Namespaces in XML is available at http://www.w3.org/TR/REC-xml-names. (See http://www.w3.org/TR/1999/REC-xml-names-19990114.)
[XML Schema: Structures]
XML Schema Part 1: Structures, H. Thompson, D. Beech, M. Maloney, and N. Mendelsohn, Editors. World Wide Web Consortium, 2 May 2001. This version of the XML Schema Part 1 Recommendation is http://www.w3.org/TR/2001/REC-xmlschema-1-20010502. The latest version of XML Schema Part 1 is available at http://www.w3.org/TR/xmlschema-1. (See http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/.)
[XML Schema: Datatypes]
XML Schema Part 2: Datatypes, P. Byron and A. Malhotra, Editors. World Wide Web Consortium, 2 May 2001. This version of the XML Schema Part 2 Recommendation is http://www.w3.org/TR/2001/REC-xmlschema-2-20010502. The latest version of XML Schema Part 2 is available at http://www.w3.org/TR/xmlschema-2. (See http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/.)
[RFC 3023]
IETF "RFC 3023: XML Media Types", M. Murata, S. St. Laurent, D. Kohn, July 1998. (See http://www.ietf.org/rfc/rfc3023.txt.)
[WSDL MediaType]
IETF Internet Draft "The 'application/wsdl+xml' media type", @@@. (Work to be done once we have consensus on the media type).
[WSDL 1.2 Bindings]
Web Services Description (WSDL) Version 1.2: Bindings, J-J. Moreau, J. Schlimmer, Editors. World Wide Web Consortium, @@ @@@@ @@@@. This version of the "Web Services Description Version 1.2: Bindings" Specification is available at wsdl12-bindings.html. The latest version of "Web Services Description Version 1.2: Bindings" is available at http://www.w3.org/2002/ws/desc/wsdl12-bindings. (See wsdl12-bindings.html.)
[WSDL 1.2 Message Patterns]
Web Services Description (WSDL) Version 1.2: Message Patterns, M. Gudgin, A. Lewis, and J. Schlimmer, Editors. World Wide Web Consortium, @@ @@@@ @@@@. This version of the "Web Services Description Version 1.2: Message Patterns" Specification is available at wsdl12-patterns.html. The latest version of "Web Services Description Version 1.2: Message Patterns" is available at http://www.w3.org/2002/ws/desc/wsdl12-patterns. (See wsdl12-patterns.html.)

7.2 Informative References

[IETF RFC 2045]
Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies, N. Freed, N. Borenstein, Authors. Internet Engineering Task Force, November 1996. Available at http://www.ietf.org/rfc/rfc2045.txt. (See http://www.ietf.org/rfc/rfc2045.txt.)
[IETF RFC 2616]
Hypertext Transfer Protocol -- HTTP/1.1, R. Fielding, J. Gettys, J. Mogul, H. Frystyk, L. Masinter, P. Leach, T. Berners-Lee, Authors. Internet Engineering Task Force, June 1999. Available at http://www.ietf.org/rfc/rfc2616.txt. (See http://www.ietf.org/rfc/rfc2616.txt.)
[SOAP 1.1]
Simple Object Access Protocol (SOAP) 1.1, D. Box, D. Ehnebuske, G. Kakivaya, A. Layman, N. Mendelsohn, H. Frystyk Nielsen, S. Thatte, D. Winer, Editors. World Wide Web Consortium, 8 May 2000. This version of the Simple Object Access Protocol 1.1 Note is http://www.w3.org/TR/2000/NOTE-SOAP-20000508. The latest version of Simple Object Access Protocol 1.1 is available at http://www.w3.org/TR/SOAP. (See http://www.w3.org/TR/2000/NOTE-SOAP-20000508/.)
[SOAP 1.2 Part 1: Messaging Framework]
SOAP Version 1.2 Part 1: Messaging Framework, M. Gudgin, M. Hadley, N. Mendelsohn, J-J. Moreau, H. Frystyk Nielsen, Editors. World Wide Web Consortium, 7 May 2003. This version of the SOAP Version 1.2 Part 1 Specification is http://www.w3.org/TR/2003/PR-soap12-part1-20030507/. The latest version of SOAP Version 1.2 Part 1 is available at http://www.w3.org/TR/soap12-part1/. (See http://www.w3.org/TR/2003/PR-soap12-part1-20030507/.)
[XML Linking]
XML Linking Language (XLink) Version 1.0, S. DeRose, E. Maler, D. Orchard, Editors. World Wide Web Consortium, 27 June 2001. This version of the XML Linking Language 1.0 Recommendation is http://www.w3.org/TR/2001/REC-xlink-20010627. The latest version of XML Linking Language 1.0 is available at http://www.w3.org/TR/xlink. (See http://www.w3.org/TR/2001/REC-xlink-20010627/.)
[WSDL 1.1]
Web Services Description Language (WSDL) 1.1, E. Christensen, F. Curbera, G. Meredith, and S. Weerawarana, Authors. World Wide Web Consortium, 15 March 2002. This version of the Web Services Description Language 1.1 Note is http://www.w3.org/TR/2001/NOTE-wsdl-20010315. The latest version of Web Services Description Language 1.1 is available at http://www.w3.org/TR/wsdl. (See http://www.w3.org/TR/2001/NOTE-wsdl-20010315.)
[WSDL 1.2 Primer]
Web Services Description (WSDL) Version 1.2: Primer, K. Sankar, K. Liu, D. Booth, Editors. World Wide Web Consortium, @@ @@@@ @@@@. The editors' version of the Web Services Description Version 1.2: Primer document is available from http://www.w3.org/2002/ws/desc/. (See http://www.w3.org/2002/ws/desc/.)
[WSD Requirements]
Web Services Description Requirements, J. Schlimmer, Editor. World Wide Web Consortium, 28 October 2002. This version of the Web Services Description Requirements document is http://www.w3.org/TR/2002/WD-ws-desc-reqs-20021028. The latest version of Web Services Description Requirements is available at http://www.w3.org/TR/ws-desc-reqs. (See http://www.w3.org/TR/2002/WD-ws-desc-reqs-20021028.)
[XPointer Framework]
XPointer Framework,Paul Grosso, Eve Maler, Jonathan Marsh, Norman Walsh, Editors. World Wide Web Consortium, 22 November 2002. This version of the XPointer Framework Proposed Recommendation is http://www.w3.org/TR/2003/REC-xptr-framework-20030325/ The latest version of XPointer Framework is available at http://www.w3.org/TR/xptr-framework/. (See http://www.w3.org/TR/2003/REC-xptr-framework-20030325/.)

A. The "application/wsdl+xml" Media Type

Editorial note: JJM20021107
This was lifted from the SOAP 1.2 specification, and needs to be edited to reflect WSDL's own requirements. For example, the WG has not reached consensus on whether to use "text/xml", "text/wsdl+xml" or "application/wsdl+xml".

This appendix defines the "application/wsdl+xml" media type which can be used to describe WSDL 1.2 documents serialized as XML. It is referenced by the corresponding IANA registration document [WSDL MediaType].

A.1 Registration

MIME media type name:

application

MIME subtype name:

wsdl+xml

Required parameters:

none

Optional parameters:
charset

This parameter has identical semantics to the charset parameter of the "application/xml" media type as specified in [RFC 3023].

Encoding considerations:

Identical to those of "application/xml" as described in [RFC 3023], section 3.2, as applied to the WSDL document infoset.

Security considerations:

See section A.2 Security considerations.

Interoperability considerations:

There are no known interoperability issues.

Published specification:

This document and [WSDL 1.2 Bindings].

Applications which use this media type:

No known applications currently use this media type.

Additional information:
File extension:

WSDL documents are not required or expected to be stored as files.

Fragment identifiers:

Either a syntax identical to that of "application/xml" as described in [RFC 3023], section 5 or the syntax defined in C.2 Fragment Identifiers.

Base URI:

As specified in [RFC 3023], section 6.

Macintosh File Type code:

TEXT

Person and email address to contact for further information:

@@@ <@@@@>

Intended usage:

COMMON

Author/Change controller:

The WSDL 1.2 specification set is a work product of the World Wide Web Consortium's Web Service Description Working Group. The W3C has change control over these specifications.

A.2 Security considerations

Editorial note: JJM20021107
Are there any security considerations other than the standard ones.

This media type uses the "+xml" convention, it shares the same security considerations as described in [RFC 3023], section 10.

B. Acknowledgements (Non-Normative)

This document is the work of the W3C Web Service Description Working Group.

Members of the Working Group are (at the time of writing, and by alphabetical order): Adi Sakala (IONA Technologies), Alan Davies (SeeBeyond), Allen Brookes (Rogue Wave Softwave), Amelia Lewis (TIBCO/Extensibility), Arthur Ryman (IBM), Bijan Parsia (University of Maryland), Dale Moberg (Cyclone Commerce), Dan Kulp (IONA Technologies), David Booth (W3C), Dietmar Gaertner (Software AG), Don Mullen (TIBCO Software), Erik Ackerman (Lexmark), Glen Daniels (Macromedia), Igor Sedukhin (Computer Associates), Ingo Melzer (DaimlerChrysler Research and Technology), Jacek Kopecky (Systinet), Jean-Jacques Moreau (Canon), Jeff Mischkinsky (Oracle Corporation), Jeffrey Schlimmer (Microsoft Corporation), Jerry Thrasher (Lexmark), Jim Hendler (University of Maryland), Johan Pauhlsson (L'Échangeur), Jonathan Marsh (Chair, Microsoft Corporation), Kevin Canyang Liu (SAP), Laurent De Teneuille (L'Échangeur), Lily Liu (webMethods, Inc.), Martin Gudgin (Microsoft Corporation), Michael Champion (Software AG), Michael Mahan (Nokia), Michael Mealling (Verisign), Mike Ballantyne (Electronic Data Systems), Mike Davoren (W. W. Grainger), Mike McHugh (W. W. Grainger), Philippe Le Hégaret (W3C), Prasad Yendluri (webMethods, Inc.), Roberto Chinnici (Sun Microsystems), Sandeep Kumar (Cisco Systems), Sandra Swearingen (U.S. Department of Defense, U.S. Air Force), Sanjiva Weerawarana (IBM), Steve Graham (Global Grid Forum), Steve Lind (AT&T), Steve Tuecke (Global Grid Forum), Tom Jordahl (Macromedia), Umit Yalcinalp (Oracle Corporation), Waqar Sadiq (Electronic Data Systems), William Vambenepe (Hewlett-Packard Company), Youenn Fablet (Canon)

Previous members were: Aaron Skonnard (DevelopMentor), Don Wright (Lexmark), Barbara Zengler (DaimlerChrysler Research and Technology), Jochen Ruetschlin (DaimlerChrysler Research and Technology), Joyce Yang (Oracle Corporation), Keith Ballinger (Microsoft), Krishna Sankar (Cisco Systems), Mario Jeckle (DaimlerChrysler Research and Technology), Pallavi Malu (Intel Corporation), William Stumbo (Xerox), Daniel Schutzer (Citigroup), Dave Solo (Citigroup), Stefano Pogliani (Sun Microsystems), Stephen White (SeeBeyond), Tim Finin (University of Maryland)

The people who have contributed to discussions on www-ws-desc@w3.org are also gratefully acknowledged.

C. URI References for WSDL constructs (Non-Normative)

This appendix provides a syntax for URI references for constructs found in a WSDL document. This includes first class constructs such as message, interface, binding and service and subordinate constructs such as message parts and interface operations. The URI references are easy to understand and compare, while imposing no burden on the WSDL author.

This appendix provides a syntax for URI references for constructs found in a WSDL document. This includes first class constructs such as interface, binding, and service and subordinate constructs such as interface operations. The URI references are easy to understand and compare, while imposing no burden on the WSDL author.

C.1 WSDL URIs

There are two main cases for WSDL URIs:

  • the URI of a WSDL document

  • the URI of a WSDL namespace

The URI of a WSDL document can be dereferenced to give a resource representation that contributes component definitions to a single WSDL namespace. If the media type is set to the WSDL media type, then the fragment identifiers can be used to identify the main components that are defined in the document.

However, this appendix specifies the use of the namespace URI with the WSDL fragment identifiers to form a URI-reference.

Editorial note: MJG20030203
The URI of a WSDL namespace may not be dereferencable, or if it is dereferencable, then it may not resolve to a resource representation that has the WSDL media type. For example, a namespace URI may resolve to an HTML document that describes the namespace. Since the namespace URI does not necessarily reference a resource with the WSDL media type, the use of WSDL fragment identifiers with it is not strictly in compliance with the definition of URI-reference. Comment from the W3C Technical Architecture Group on this point is invited.

C.2 Fragment Identifiers

The following fragment identifier syntax is compliant with the [XPointer Framework].

The URI reference for a WSDL construct is the {target namespace} property of either the construct itself, in the case of messages, interfaces, bindings, services or operations, or the {target namespace} property of an ancestor construct.

The URI reference for a WSDL construct is the {target namespace} property of either the construct itself, in the case of interfaces, bindings, services or operations, or the {target namespace} property of an ancestor construct.

The URI provided by the {target namespace} property is combined with a fragment identifier, where the fragment identifier is constructed from the {name} property of the construct and the {name} properties of its ancestors as a path according to Table C-1. In that table the first column gives the name of the WSDL construct as the [local name] of the element information item that represents that construct in a WSDL document. Columns two, three and four populate the variables x, y and z respectively. These variables are then used to construct the fragment in column five.


Table C-1. Rules for determining fragments for WSDL constructs
Construct x y z Fragment
message {name} property of message n/a n/a message(x)
part {name} property of part {name} property of message n/a part(y/x)
interface {name} property of interface n/a n/a interface(x)
operation {name} property of operation {name} property of parent interface n/a operation(y/x)
input {name} property of message reference {name} property of parent operation {name} property of grandparent interface input(z/y/x)
output {name} property of message reference {name} property of parent operation {name} property of grandparent interface output(z/y/x)
fault {name} property of message reference {name} property of parent operation {name} property of grandparent interface fault(z/y/x)
infault {name} property of message reference {name} property of parent operation {name} property of grandparent interface infault(z/y/x)
outfault {name} property of message reference {name} property of parent operation {name} property of grandparent interface outfault(z/y/x)
binding {name} property of binding n/a n/a binding(x)
service {name} property of service n/a n/a service(x)
endpoint {name} property of endpoint {name} property of parent service n/a endpoint(y/x)

Note that the above rules are defined in terms of component properties rather than transfer syntax. Because of the mappings defined for these properties, values are always available, even if certain optional attribute information items are missing from the WSDL document. This allows meaningful URI-references to be formed for constructs like Message Reference components (see 2.8 Message Reference) whose element information items <input> and <output> may not actually carry a name attribute information item.

C.3 Extension Elements

WSDL has an open content model. It is therefore possible for an extension to define new components. The XPointer Framework scheme for components added by extensions is:

extension(extension-namespace, extension-specific-syntax)

where extension-namespace is the namespace that identifies the extension, e.g. for SOAP the namespace is http://www.w3.org/@@@@/@@/wsdl/soap12, and extension-specific-syntax is defined by the extension. The owner of the extension must define any components contributed by the extension and a syntax for identifying them.

C.4 Example

Consider the following WSDL located at http://schemas.airlines.org/TicketAgent.wsdl:

Example C-1. URI References - Example WSDL


<?xml version="1.0" encoding="UTF-8"?> 
<definitions name="TicketAgent" 
    targetNamespace="http://airline.wsdl/ticketagent/" 
    xmlns="http://schemas.xmlsoap.org/wsdl/" 
    xmlns:tns="http://airline.wsdl/ticketagent/" 
    xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsd1="http://airline/"> 
    <import location="TicketAgent.xsd" namespace="http://airline/"/> 
    <message name="listFlightsRequest"> 
        <part name="depart" type="xs:dateTime"/> 
        <part name="origin" type="xs:string"/> 
        <part name="destination" type="xs:string"/> 
    </message> 
    <message name="listFlightsResponse"> 
        <part name="result" type="xsd1:ArrayOfString"/> 
    </message> 
    <message name="reserveFlightRequest"> 
        <part name="depart" type="xs:dateTime"/> 
        <part name="origin" type="xs:string"/> 
        <part name="destination" type="xs:string"/> 
        <part name="flight" type="xs:string"/> 
    </message> 
    <message name="reserveFlightResponse"> 
        <part name="result" type="xs:string"/> 
    </message> 
    <interface name="TicketAgent"> 
        <operation name="listFlights" parameterOrder="depart origin destination"> 
            <input message="tns:listFlightsRequest" name="listFlightsRequest"/> 
            <output message="tns:listFlightsResponse" name="listFlightsResponse"/> 
        </operation> 
        <operation name="reserveFlight" parameterOrder="depart origin destination flight"> 
            <input message="tns:reserveFlightRequest" name="reserveFlightRequest"/> 
            <output message="tns:reserveFlightResponse" name="reserveFlightResponse"/> 
        </operation> 
    </interface> 
</definitions> 



<?xml version="1.0" encoding="UTF-8"?> 
<definitions
    name="TicketAgent" 
    xmlns="http://schemas.xmlsoap.org/wsdl/"
    targetNamespace="http://airline.wsdl/ticketagent/"
    xmlns:tns="http://airline.wsdl/ticketagent/"
    xmlns:xsd1="http://airline/" >

  <import location="TicketAgent.xsd"
          namespace="http://airline/" />

  <interface name="TicketAgent">
    <operation name="listFlights" >
      <input name="listFlightsRequest"
             body="xsd1:listFlightsRequest" />
      <output name="listFlightsResponse"
              body="xsd1:listFlightsResponse" />
    </operation> 
    <operation name="reserveFlight" >
      <input name="reserveFlightRequest"
             body="xsd1:reserveFlightRequest" />
      <output name="reserveFlightResponse"
              body="xsd1:reserveFlightResponse" />
    </operation> 
  </interface> 

</definitions>

Its conceptual elements have the following URI-references:

Example C-2. URI References - Example URIs


http://airline.wsdl/ticketagent/#message(listFlightsRequest) 
http://airline.wsdl/ticketagent/#part(listFlightsRequest/depart) 
http://airline.wsdl/ticketagent/#part(listFlightsRequest/origin) 
http://airline.wsdl/ticketagent/#part(listFlightsRequest/destination) 
http://airline.wsdl/ticketagent/#message(listFlightsResponse) 
http://airline.wsdl/ticketagent/#part(listFlightsResponse/result) 
http://airline.wsdl/ticketagent/#message(reserveFlightRequest) 
http://airline.wsdl/ticketagent/#part(reserveFlightRequest/depart) 
http://airline.wsdl/ticketagent/#part(reserveFlightRequest/origin) 
http://airline.wsdl/ticketagent/#part(reserveFlightRequest/destination) 
http://airline.wsdl/ticketagent/#part(reserveFlightRequest/flight) 
http://airline.wsdl/ticketagent/#message(reserveFlightResponse) 
http://airline.wsdl/ticketagent/#part(reserveFlightResponse/result) 



http://airline.wsdl/ticketagent/#interface(TicketAgent) 
http://airline.wsdl/ticketagent/#operation(TicketAgent/listFlights) 
http://airline.wsdl/ticketagent/#input(TicketAgent/listFlights/listFlightsRequest) 
http://airline.wsdl/ticketagent/#output(TicketAgent/listFlights/listFlightsResponse) 
http://airline.wsdl/ticketagent/#operation(TicketAgent/lreserveFlight) 
http://airline.wsdl/ticketagent/#input(TicketAgent/lreserveFlight/lreserveFlightRequest) 
http://airline.wsdl/ticketagent/#output(TicketAgent/lreserveFlight/lreserveFlightResponse)

C.5 Relation to WSDL 1.1

This appendix applies to WSDL 1.2. It is does not apply to WSDL 1.1. For example, the proposed syntax does not disambiguate overloaded operation names, which are permissible in WSDL 1.1, but not in WSDL 1.2.

D. Migrating from WSDL 1.1 to WSDL 1.2 (Non-Normative)

This section will attempt to document some of the migration concerns of going from WSDL 1.1 to WSDL 1.2. We do not claim that all migration problems will be addressed here.

D.1 Operation Overloading

WSDL 1.1 supported operation overloading and WSDL 1.2 removes it. This section will provide some rationale for it and provide hints on how to work around some scenarios.

D.2 PortTypes

Port types have been renamed to interfaces. We now have interface inheritance.

D.3 Ports

Ports have been renamed to endpoints.

E. Examples of Specifications of Extension Elements for Alternative Schema Language Support. (Non-Normative)

E.1 DTD

A DTD may be used as the schema language for WSDL. It may not be embedded; it must be imported. A namespace must be assigned. DTD types appear in the {element declarations} property of 2.1.1 The Definitions Component and may be referenced from wsdl:part only by the element attribute information item; DTDs do not have a construct corresponding to the contents of the {type definitions} property of the 2.1.1 The Definitions Component.

The prefix, dtd, used throughout the following is mapped to the namespace URI "http://www.example.org/dtd/".

The dtd:import element information item references an external Document Type Definition, and has the following infoset properties:

  • A [local name] of import.

  • A [namespace name] of "http://www.example.org/dtd".

  • One or two attribute information items, as follows:

    • A namespace attribute information item as described below.

    • An optional location attribute information item as described below.

E.1.1 namespace attribute information item

The namespace attribute information item sets the namespace to be used with all imported element definitions described in the DTD. It has the following infoset properties:

  • A [local name] of namespace.

  • A [namespace name] that has no value.

The type of the namespace attribute information item is xs:anyURI.

The WSDL author should ensure that a prefix is associated with the namespace at the proper scope (probably document scope).

E.1.2 location attribute information item

The location attribute information item, if present, provides a hint to the processor as to where the DTD may be located. Caching and cataloging technologies may provide better information than this hint. The location attribute information item has the following infoset properties:

  • A [local name] of location.

  • A [namespace name] that has no value.

The type of the location attribute information item is xs:anyURI.

E.1.3 References to Element Definitions

In referring to an element definition (<!ELEMENT>) from a message part, the type attribute information item may not be used. The element attribute information item must be used. Its value must correspond to the content of the namespace attribute information item of the dtd:import element information item. The local name part must correspond to an element defined in the DTD.

The body and/or headers attribute information items MUST be used when referring to an element definition (<!ELEMENT>) from a Message Reference; referring to an element definition from a Fault Reference component is similar. The value of the element definition MUST correspond to the content of the namespace attribute information item of the dtd:import element information item. The local name part must correspond to an element defined in the DTD.

Note that this pattern does not attempt to make DTDs namespace-aware. It applies namespaces externally, in the import phase.

E.2 RELAX NG

A RELAX NG schema may be used as the schema language for WSDL. It may be embedded or imported; import is preferred. A namespace must be specified; if an imported schema specifies one, then the [actual value] of the namespace attribute information item in the import element information item must match the specified namespace. RELAX NG provides both type and element definitions which appear in the {type definitions} and {element declarations} properties of 2.1.1 The Definitions Component respectively. The following discussion supplies the prefix rng which is mapped to the URI "http://www.relaxng.org/ns/structure/1.0".

E.2.1 Importing RELAX NG

Importing a RELAX NG schema uses the rng:include mechanism defined by RNG, with restrictions on its syntax and semantics. A child element information item of the types element information item is defined with the Infoset properties as follows:

  • A [local name] of include.

  • A [namespace name] of "http://www.relaxng.org/ns/structure/1.0".

  • Two attribute information items as follows:

    • A ns attribute information item as described below.

    • A href attribute information item as described below.

    • Additional attribute information items as defined by the RNG specification.

Note that WSDL restricts the rng:include element information item to be empty. That is, it cannot redefine rng:start and rng:define element information items; it may be used solely to import a schema.

E.2.1.1 ns attribute information item

The ns attribute information item defines the namespace of the type and element definitions imported from the referenced schema. If the referenced schema contains an ns attribute information item on its grammar element information item, then the values of these two attribute information items must be identical. If the imported grammar does not have an ns attribute information item then the namespace specified here is applied to all components of the schema as if it did contain such an attribute information item. The ns attribute information item contains the following Infoset properties:

  • A [local name] of ns.

  • A [namespace name] which has no value.

The type of the ns attribute information item is xs:anyURI.

E.2.1.2 href attribute information item

The href attribute information item must be present, according to the rules of the RNG specification. However, WSDL allows it to be empty, and considers it only a hint. Caching and cataloging technologies may provide better information that this hint. The href attribute information item has the following Infoset properties:

  • A [local name] of href.

  • A [namespace name] that has no value.

The type of the href attribute information item is xs:anyURI.

E.2.2 Embedding RELAX NG

Embedding an RNG schema uses the existing top-level rng:grammar element information item. It may be viewed as simply cutting and pasting an existing, stand-alone schema to a location inside the wsdl:types element information item. The rng:grammar element information item has the following Infoset properties:

  • A [local name] of grammar.

  • A [namespace name] of "http://www.relaxng.org/ns/structure/1.0".

  • An ns attribute information items as described below.

  • Additional attribute information items as specified for the rng:grammar element information item in the RNG specification.

  • Child element information items as specified for the rng:grammar element information item in the RNG specification.

E.2.2.1 ns attribute information item

The ns attribute information item defines the namespace of the type and element definitions embedded in this schema. WSDL modifies the RNG definition of the rng:grammar element information item to make this attribute information item required. The ns attribute information item has the following infoset properties:

  • A [local name] of ns.

  • A [namespace name] that has no value.

The type of the ns attribute information item is xs:anyURI.

E.2.3 References to Type and Element Definitions

Whether embedded or imported, the type and element definitions present in a schema may be referenced from a message part.

Whether embedded or imported, the element definitions present in a schema may be referenced from a Message Reference or Fault Reference component.

A named rng:define definition may be referenced from the part element information item using the type attribute information item. The QName is constructed from the namespace (ns attribute information item) of the schema and the content of the name attribute information item of the define attribute information item. A type attribute information item may not be used to refer to an rng:element element information item.

A named rng:define definition MUST NOT be referenced from the Message Reference or Fault Reference components.

A named Relax NG element definition may be referenced from the part element information item using the element attribute information item. The QName is constructed from the namespace (ns attribute information item) of the schema and the content of the name attribute information item of the element element information item An element attribute information item may not be used to refer to an rng:define element information item.

A named Relax NG element definition MAY be referenced from a Message Reference or Fault Reference component. The QName is constructed from the namespace (ns attribute information item) of the schema and the content of the name attribute information item of the element element information item An element attribute information item MUST NOT be used to refer to an rng:define element information item.

F. Part 1 Change Log (Non-Normative)

F.1 WSDL Specification Changes


Date Author Description
20030808 JCS Fixed errors found by IBM\Arthur.
20030804 JCS Removed Message component per 30 July-1 Aug meeting.
20030803 JCS Replaced substitution groups with xs:any namespace='##other' per 3 July, 17 July, and 24 July telecons.
20030801 JCS Made binding/@interface optional per 31 July meeting.
20030724 JCS Remove @targetResource per 17 July 2003 telecon.
20030612 JJM Incorporate revised targetResource definition, as per 12 June 2003 telcon.
20030606 JJM Refer to the two graphics by ID. Indicate pseudo-schemas are not normative.
20030604 JJM Fixed figures so they don't appear as tables. Fixed markup so it validates.
20030603 JCS Plugged in jmarsh auto-generated schema outlines
20030529 MJG Fixed various issues with the XmlRep portions of the spec
20030527 MJG Added text to 2.4.1 The Interface Component and 2.4.3 Mapping Interface's XML Representation to Component Properties indicating that recursive interface extension is not allowed.
20030523 JJM Added pseudo-syntax to all but Type and Modularizing sections.
20030523 JJM Added the "interface" and "targetResource" attribute on <service>.
20030523 JJM Fixed miscellaneous typos (semi-colon instead of colon, space after parenthesis, etc.).
20030523 JJM Rewrote the service-resource text and merge it with the introduction.
20030522 JCS s/set of parts/list of parts/.
20030514 JJM Updated the service-resource figure, and split the diagram into two.
20030512 JJM Added service-resource drawing and description.
20030512 JJM Added syntax summary for the Interface component.
20030428 MJG Various edits to 3. Types, E. Examples of Specifications of Extension Elements for Alternative Schema Language Support. to accomadate other type systems and spell out how extensibility elements/attributes play out in such scenarios.
20030428 MJG Added text to 1.2 Notational Conventions regarding normative nature of schema and validity of WSDL documents
20030411 JJM Allowed features and properties at the interface, interface operation, binding and binding operation levels, as agreed at the Boston f2f http://lists.w3.org/Archives/Public/www-ws-desc/2003Mar/0019.html.
20030411 JJM Incorporate features and properties' text from separate document and merged change logs
20030313 MJG Changed title to include 'part 1'
20030313 MJG Changed port to endpoint
20030313 MJG Changed type to interface in binding
20030313 MJG Changed mep to pattern and message exchange pattern to message pattern
20030313 MJG Added text to D.2 PortTypes
20030313 MJG Changed portType to interface
20030407 JJM Refined and corrected the definitions for features and properties.
20030304 JJM Filled in blank description of Feature and Property component.
20030303 MJG Skeleton Feature and Property components
20030305 MJG Merged ComponentModelForMEPs branch (1.46.2.5) into main branch (1.54). Below is change log from the branch:
Date Author Description
20030220 MJG Minor wording change at suggestion of JJM
20030212 MJG Updated component model to include Fault Reference component. Associated changes to Port Type Operation component
20030211 MJG Changes to component model to support MEPs

20030228 MJG Updated 4.2 Importing Descriptions to be consistent in layout with other XML rep sections. Detailed that documentation and extensibility attributes are allowed, per schema
20030228 MJG Updated 4.1 Including Descriptions to be consistent in layout with other XML rep sections. Detailed that documentation and extensibility attributes are allowed, per schema
20030228 MJG Updated 2.10.2 XML Representation of Binding Component to list type attribute
20030217 MJG Minor edits to wording in 2.7.1 The Interface Operation Component
20030213 MJG Added xlink nsdecl to spec element
20030213 MJG Incorporated text from dbooths proposal on semantics, per decision 20021031
20030213 MJG Merged operationnames branch (1.37.2.3) into main branch (1.46). Below is the change log from the branch.
Date Author Description
20030130 MJG Updated binding section to match changes to port type section WRT operation names
20030130 MJG Added best practice note on operation names and target namespaces to 2.7.1 The Interface Operation Component
20030122 MJG Started work on making operations have unique names

20030213 MJG Change name of {message exchange pattern} back to {variety} to consolidate changes due to MEP proposal
20030206 MJG Updated Appendix A to refer to Appendix C
20030204 MJG Tidied up appendix C
20030203 MJG Incorporated resolution to R120
20030124 MJG Fixed error in 2.8.2 XML Representation of Message Reference Component which had name attribute information item on input, output and fault element information item being mandatory. Made it optional.
20030123 JJM Change name of {variety} property to {message exchange pattern}
20030130 MJG Updated binding section to match changes to port type section WRT operation names
20030130 MJG Added best practice note on operation names and target namespaces to 2.7.1 The Interface Operation Component
20030122 MJG Started work on making operations have unique names
20030122 MJG Added some <emph>, <el>, <att>, &AII;, &EII;, <el> markup
20030120 MJG Incorporated Relax NG section from Amy's types proposal
20030120 MJG Incorporated DTD section from Amy's types proposal
2003020 MJG Incorporated Amy's types proposal except annexes
20030118 MJG Made some changes related to extensibility
20030118 MJG Amended content model for operation to disallow fault element children in the input-only and output-only cases
20030118 MJG Removed {extension} properties from Binding components and Port components. Added text relating to how extension elements are expected to annotate the component model.
20030117 MJG Made further edits related to extensibility model now using substitution groups
20030117 MJG Added initial draft of section on QName resolution
20030117 MJG Reworked section on extensibility
20030116 MJG Added text regarding multiple operations with the same {name} in a single port type
20030116 MJG Added section on symbol spaces
20030116 MJG Removed various ednotes
20030116 MJG Added section on component equivalence
20030116 MJG More work on include and import
20021201 MJG Did some work on wsdl:include
20021127 MJG Added placeholder for wsdl:include
20021127 MJG Cleaned up language concerning targetNamespace attribute information item 2.1.2.1 targetNamespace attribute information item
20021127 MJG changed the language regarding extensibility elements in 2.1.2 XML Representation of Definitions Component.
20021127 MJG Moved all issues into issues document ( ../issues/wsd-issues.xml )
20021127 MJG Removed name attribute from definitions element
20021127 MJG Removed 'pseudo-schema'
20021121 JJM Updated media type draft appendix ednote to match minutes.
20021111 SW Added appendix to record migration issues.
20021107 JJM Incorporated and started adapting SOAP's media type draft appendix.
20021010 MJG Added port type extensions, removed service type.
20020910 MJG Removed parameterOrder from spec, as decided at September 2002 FTF
20020908 MJG Updated parameterOrder description, fixed some spelling errors and other types. Added ednote to discussion of message parts
20020715 MJG AM Rewrite
20020627 JJM Changed a few remaining <emph> to either <att> or <el>, depending on context.
20020627 SW Converted portType stuff to be infoset based and improved doc structure more.
20020627 SW Converted message stuff to be infoset based and improved doc structure more.
20020625 SW Mods to take into account JJM comments.
20020624 JJM Fixed spec so markup validates.
20020624 JJM Upgraded the stylesheet and DTD
20020624 JJM Added sections for references and change log.
20020624 JJM Removed Jeffrey from authors :-( Added Gudge :-)
20020620 SW Started adding abstract model
20020406 SW Created document from WSDL 1.1