This document is also available in these non-normative formats: XHTML with Z-notation, postscript, PDF, XML, and plain text.
Copyright © 2005 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark and document use rules apply.
This document describes the Web Services Description Language Version 2.0 (WSDL 2.0), 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. It also defines criteria for a conformant processor of this language.
This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at http://www.w3.org/TR/.
This is a W3C Working Draft of the Web Services Description Language (WSDL) 2.0 document. This document has been produced as part of the W3C Web Services Activity. The authors of this document are the Web Services Description Working Group members.
The Working Group is in the process of addressing the comments it has received on WSDL 2.0 Part 1, 2 and 3 during its Last Call period. This document reflects the current state of this work. The latest status of the last call issues received by the Working Group can be found in the last call issues list. The Working Group is planning to publish a new Last Call Working Draft once it has closed all these issues.
Comments on this document are to be sent to the public public-ws-desc-comments@w3.org mailing list (public archive).
A diff-marked version against the previous version of this document is available. For a detailed list of changes since the last publication of this document, please refer to appendix F. Part 1 Change Log.
Publication as a Working Draft does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.
This document has been produced under the 24 January 2002 Current Patent Practice as amended by the W3C Patent Policy Transition Procedure. Patent disclosures relevant to this specification may be found on the Working Group's patent disclosure page. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) with respect to this specification should disclose the information in accordance with section 6 of the W3C Patent Policy.
1. Introduction
2. Component Model
3. Types
4. Modularizing WSDL 2.0
descriptions
5. Documentation
6. Language
Extensibility
7. Locating WSDL 2.0 Documents
8. Conformance
9. XML Syntax Summary
(Non-Normative)
10. References
A. The application/wsdl+xml Media
Type
B. Acknowledgements
(Non-Normative)
C. URI References for WSDL 2.0
Components (Non-Normative)
D. Migrating from WSDL 1.1 to WSDL 2.0
(Non-Normative)
E. Examples of Specifications of
Extension Elements for Alternative Schema Language Support.
(Non-Normative)
F. Part 1 Change Log
(Non-Normative)
1. Introduction
1.1 Web
Service
1.2 Document
Conformance
1.3 The Meaning of a
Service Description
1.4 Notational
Conventions
1.4.1 RFC 2119 Keywords
1.4.2 RFC 3986 Namespaces
1.4.3 Prefixes and Namespaces Used in This
Specification
1.4.4 Terms Used in This Specification
1.4.5 XML Information Set Properties
1.4.6 WSDL 2.0 Component Model
Properties
1.4.7 Z Notation
1.4.8 BNF Pseudo-Schemas
2. Component Model
2.1 Description
2.1.1 The Description Component
2.1.2 XML Representation of Description
Component
2.1.2.1
targetNamespace
attribute information item
2.1.3 Mapping Description's XML Representation to
Component Properties
2.2 Interface
2.2.1 The Interface Component
2.2.2 XML Representation of Interface
Component
2.2.2.1
name attribute information item
with interface [owner element]
2.2.2.2
extends attribute
information item
2.2.2.3
styleDefault attribute
information item
2.2.3 Mapping Interface's XML Representation to
Component Properties
2.3 Interface
Fault
2.3.1 The Interface Fault Component
2.3.2 XML Representation of Interface Fault
Component
2.3.2.1
name attribute information
item with fault [owner element]
2.3.2.2
element attribute
information item with fault [owner element]
2.3.3 Mapping Interface Fault's XML
Representation to Component Properties
2.4 Interface
Operation
2.4.1 The Interface Operation
Component
2.4.1.1
Operation Style
2.4.2 XML Representation of Interface
Operation Component
2.4.2.1
name attribute
information item with operation [owner element]
2.4.2.2
pattern attribute
information item with operation [owner element]
2.4.2.3
style attribute
information item with operation [owner element]
2.4.2.4
safe attribute
information item with operation [owner element]
2.4.3 Mapping Interface Operation's XML
Representation to Component Properties
2.5 Interface Message Reference
2.5.1 The Interface Message
Reference Component
2.5.2 XML Representation of Interface
Message Reference Component
2.5.2.1
messageLabel
attribute information item with input or output [owner
element]
2.5.2.2
element
attribute information item with input or output [owner
element]
2.5.3 Mapping Interface Message
Reference's XML Representation to Component Properties
2.6 Interface Fault Reference
2.6.1 The Interface Fault Reference
Component
2.6.2 XML Representation of Interface
Fault Reference
2.6.2.1
ref attribute
information item with infault, or outfault [owner
element]
2.6.2.2
messageLabel
attribute information item with infault, or outfault [owner
element]
2.6.3 Mapping Interface Fault
Reference's XML Representation to Component Properties
2.7 Feature
2.7.1 The Feature Component
2.7.1.1
Feature Composition
Model
2.7.1.1.1
Example of Feature
Composition Model
2.7.2 XML Representation of Feature Component
2.7.2.1
uri attribute information item
with feature [owner element]
2.7.2.2
required attribute
information item with feature [owner element]
2.7.3 Mapping Feature's XML Representation to
Component Properties
2.8 Property
2.8.1 The Property Component
2.8.1.1
Property Composition
Model
2.8.2 XML Representation of Property
Component
2.8.2.1
uri attribute information item
with property [owner element]
2.8.2.2
value element information item
with property [parent]
2.8.2.3
constraint element
information item with property [parent]
2.8.3 Mapping Property's XML Representation to
Component Properties
2.9 Binding
2.9.1 The Binding Component
2.9.2 XML Representation of Binding Component
2.9.2.1
name attribute information item
with binding [owner element]
2.9.2.2
interface attribute
information item with binding [owner element]
2.9.2.3
type attribute information item
with binding [owner element]
2.9.2.4
Binding extension
elements
2.9.3 Mapping Binding's XML Representation to
Component Properties
2.10 Binding
Fault
2.10.1 The Binding Fault Component
2.10.2 XML Representation of Binding Fault
Component
2.10.2.1
ref attribute information
item with fault [owner element]
2.10.2.2
Binding Fault extension
elements
2.10.3 Mapping Binding Fault'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
ref attribute
information item with operation [owner element]
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
messageLabel
attribute information item with input or output [owner
element]
2.12.2.2
Binding
Message Reference extension elements
2.12.3 Mapping Binding Message
Reference's XML Representation to Component Properties
2.13 Binding Fault Reference
2.13.1 The Binding Fault Reference
Component
2.13.2 XML Representation of Binding
Fault Reference Component
2.13.2.1
ref attribute
information item with infault or outfault [owner element]
2.13.2.2
messageLabel
attribute information item with infault or outfault [owner
element]
2.13.2.3
Binding Fault
Reference extension elements
2.13.3 Mapping Binding Fault
Reference's XML Representation to Component Properties
2.14 Service
2.14.1 The Service Component
2.14.1.1
Operation Name Mapping
(non-normative)
2.14.2 XML Representation of Service Component
2.14.2.1
Service References
2.14.2.2
name attribute information item
with service [owner element]
2.14.2.3
interface attribute
information item with service [owner element]
2.14.3 Mapping Service's XML Representation to
Component Properties
2.15 Endpoint
2.15.1 The Endpoint Component
2.15.2 XML Representation of Endpoint
Component
2.15.2.1
Endpoint References
2.15.2.2
name attribute information item
with endpoint [owner element]
2.15.2.3
binding attribute information
item with endpoint [owner element]
2.15.2.4
address attribute information
item with endpoint [owner element]
2.15.2.5
Endpoint extension
elements
2.15.3 Mapping Endpoint's XML Representation to
Component Properties
2.16 XML Schema 1.0
Simple Types Used in the Component Model
2.17 Equivalence of
Components
2.18 Symbol
Spaces
2.19 QName
resolution
2.20 Comparing
URIs
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 Inlining XML Schema
3.1.2.1
targetNamespace attribute
information item
3.1.3 References to Element Declarations and
Type Definitions
3.2 Using Other
Schema Languages
4. Modularizing WSDL 2.0
descriptions
4.1 Including
Descriptions
4.1.1 location attribute information item
with include [owner element]
4.2 Importing
Descriptions
4.2.1 namespace attribute information
item
4.2.2 location attribute information item
with import [owner element]
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
6.3 Extensibility Semantics
7. Locating WSDL 2.0 Documents
7.1 wsdli:wsdlLocation attribute information
item
8. Conformance
8.1 XML Information Set
Conformance
9. XML Syntax Summary
(Non-Normative)
10. References
10.1 Normative References
10.2 Informative References
A. The application/wsdl+xml
Media Type
A.1 Registration
A.2 Fragment
Identifiers
A.2.1 wsdl.interface(interface)
A.2.2 wsdl.interfaceFault(interface/fault)
A.2.3 wsdl.interfaceOperation(interface/operation)
A.2.4 wsdl.interfaceMessageReference(interface/operation/message)
A.2.5 wsdl.interfaceFaultReference(interface/operation/message/fault)
A.2.6 wsdl.binding(binding)
A.2.7 wsdl.bindingFault(binding/fault)
A.2.8 wsdl.bindingOperation(binding/operation)
A.2.9 wsdl.bindingMessageReference(binding/operation/message)
A.2.10 wsdl.bindingFaultReference(binding/operation/fault/message)
A.2.11 wsdl.service(service)
A.2.12 wsdl.endpoint(service/endpoint)
A.2.13 wsdl.feature(parent/feature)
A.2.14 wsdl.property(parent/property)
A.2.15 wsdl.extension(extension-namespace,
extension-specific-syntax)
A.3 Security
considerations
B. Acknowledgements
(Non-Normative)
C. URI References for WSDL 2.0
Components (Non-Normative)
C.1 WSDL 2.0
URIs
C.2 Example
D. Migrating from WSDL 1.1 to WSDL 2.0
(Non-Normative)
D.1 Operation
Overloading
D.2 PortTypes
D.3 Ports
D.4 Single Interface per
Service
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 Inlining RELAX NG
E.2.2.1
ns attribute information
item
E.2.3 References to Element Declarations
F. Part 1 Change Log (Non-Normative)
F.1 WSDL 2.0
Specification Changes
Web Services Description Language Version 2.0 (WSDL 2.0) provides a model and an XML format for describing Web services. WSDL 2.0 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. It also defines criteria for a conformant processor of this language. The WSDL Version 2.0 Part 2: Adjuncts specification [WSDL 2.0 Adjuncts] describes extensions for Message Exchange Patterns, features, SOAP modules and bindings of features, and a language for describing such concrete details for SOAP 1.2 [SOAP 1.2 Part 1: Messaging Framework] and HTTP [IETF RFC 2616].
WSDL 2.0 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 to separate independent design concerns.
At an abstract level, WSDL 2.0 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 exchange pattern with one or more messages. A message exchange 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.
An element information item (as defined in
[XML Information Set]) whose
namespace name is "http://www.w3.org/2005/05/wsdl" and whose local
part is description
conforms to this specification if
it is valid according to the XML Schema for that element as defined
by this specification (http://www.w3.org/2005/05/wsdl/wsdl20.xsd)
and additionally adheres to all the constraints contained in this
specification family and conforms to the specifications of any
extensions contained in it. Such a conformant element
information item constitutes a WSDL 2.0 document.
The definition of the WSDL 2.0 language is based on the XML Information Set [XML Information Set] but also imposes many semantic constraints over and above structural conformance to this XML Infoset. In order to precisely describe these constraints, and as an aid in precisely defining the meaning of each WSDL 2.0 document, the WSDL 2.0 specification defines a component model 2. Component Model as an additional layer of abstraction above the XML Infoset. Constraints and meaning are defined in terms of this component model, and the definition of each component includes a mapping that specifies how values in the component model are derived from corresponding items in the XML Infoset.
It is not a requirement to support any particular serialization of the normative XML Infoset mapping of the component model for a WSDL 2.0 document. For instance, a conformant processor MAY only support XML 1.0 and not XML 1.1 [XML 1.1].
An XML 1.0 document that is valid with respect to the WSDL 2.0 XML Schema and that maps to a valid WSDL 2.0 Component Model is conformant to the WSDL 2.0 specification.
A WSDL 2.0 service description indicates how potential clients are intended to interact with the described service. It represents an assertion that the described service fully implements and conforms to what the WSDL 2.0 document describes. For example, as further explained in section 6.1.1 Mandatory extensions, if the WSDL 2.0 document specifies a particular optional extension, the functionality implied by that extension is only optional to the client. But it needs to be supported by the Web service.
A WSDL 2.0 interface describes potential interaction with a service--not required interaction. The declaration of an operation in a WSDL 2.0 interface is not an assertion that the interaction described by the operation must occur. Rather it is an assertion that if such an interaction is (somehow) initiated, then the declared operation describes how that interaction is intended to occur.
All parts of this specification are normative, with the EXCEPTION of notes, pseudo-schemas, examples, and sections explicitly marked as “Non-Normative”.
The keywords “MUST”, “MUST NOT”, “EQUIRED”, “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].
Namespace names of the general form:
"http://example.org/..." and
"http://example.com/..."
represent application or context-dependent URIs [IETF RFC 3986].
This specification uses predefined namespace prefixes throughout; they are given in the following list. Note that the choice of any namespace prefix is arbitrary and not semantically significant (see [XML Namespaces]).
"http://www.w3.org/2005/05/wsdl"
Defined by this specification.
"http://www.w3.org/2005/05/wsdl-instance"
Defined by this specification 7.1 wsdli:wsdlLocation attribute information item.
"http://www.w3.org/2005/05/wsdl/rpc"
Defined by WSDL 2.0: Adjuncts [WSDL 2.0 Adjuncts].
"http://www.w3.org/2005/05/wsdl/soap"
Defined by WSDL 2.0: Adjuncts [WSDL 2.0 Adjuncts].
"http://www.w3.org/2005/05/wsdl/http"
Defined by WSDL 2.0: Adjuncts [WSDL 2.0 Adjuncts].
"http://www.w3.org/2001/XMLSchema"
Defined in the W3C XML Schema specification [XML Schema: Structures], [XML Schema: Datatypes].
"http://www.w3.org/2001/XMLSchema-instance"
Defined in the W3C XML Schema specification [XML Schema: Structures], [XML Schema: Datatypes].
This section describes the terms and concepts introduced in Part 1 of the WSDL Version 2.0 specification (this document).
As in [XML Schema: Structures], the phrase actual value is used to refer to the member of the value space of the simple type definition associated with an attribute information item which corresponds to its normalized value. This will often be a string, but may also be an integer, a boolean, a URI reference, etc.
An XML schema that is defined in a the xs:types
element information item of a WSDL 2.0 description. For
example, an XML 1.0 Schema defined in an xs:schema
element information item 3.1.2
Inlining XML Schema.
This specification refers to properties in the XML Information Set [XML Information Set]. Such properties are denoted by square brackets, e.g. [children], [attributes].
This specification defines and refers to properties in the WSDL 2.0 Component Model 2. Component Model. Such properties are denoted by curly brackets, e.g. {name}, {interfaces}.
This specification uses a consistent naming convention for component model properties that refer to components. If a property refers to a required or optional component, then the property name is the same as the component name. If a property refers to a set of components, then the property name is the pluralized form of the component name.
Z Notation [Z Notation Reference Manual] was used in the development of this specification. Z Notation is a formal specification language that is based on standard mathematical notation. The Z Notation for this specification has been verified using the Fuzz 2000 type-checker [Fuzz 2000].
Since Z Notation is not widely known, it is not included the normative version of this specification. However, it is included in a non-normative version which allows to dynamically hide and show the Z Notation. Browsers correctly display the mathematical Unicode characters, provided that the required fonts are installed. Mathematical fonts for Mozilla Firefox can be downloaded from the Mozilla Web site.
The Z Notation was used to improve the quality of the normative text that defines the Component Model, and to help ensure that the test suite covered all important rules implied by the Component Model. However, the Z Notation is non-normative, so any conflict between it and the normative text is an error in the Z Notation. Readers and implementors may nevertheless find the Z Notation useful in cases where the normative text is unclear.
There are two elements of Z Notation syntax that conflict with the notational conventions described in the preceeding sections. In Z Notation, square brackets are used to introduce basic sets, e.g. [ID], which conflicts with the use of square brackets to denote XML Information Set properties 1.4.5 XML Information Set Properties. Also, in Z Notation, curly brackets are used to denote set display and set comprehension, e.g. {1, 2, 3}, which conflicts with the use of curly brackets to denote WSDL 2.0 Component Model properties 1.4.6 WSDL 2.0 Component Model Properties. However, the intended meaning of square and curly brackets should be clear from their context and this minor notational conflict should not cause any confusion.
Pseudo-schemas are provided for each component, before the description of the component. They use BNF-style conventions for attributes and elements: "?" denotes optionality (i.e. zero or one occurrences), "*" denotes zero or more occurrences, "+" one or more occurrences, "[" and "]" are used to form groups, and "|" represents choice. Attributes are conventionally assigned a value which corresponds to their type, as defined in the normative schema.
<!-- sample pseudo-schema --> <defined_element required_attribute_of_type_string="xs:string" optional_attribute_of_type_int="xs:int"? > <required_element /> <optional_element />? <one_or_more_of_these_elements />+ [ <choice_1 /> | <choice_2 /> ]* </defined_element>
This section describes the conceptual model of WSDL 2.0 as a set of components with attached properties, which collectively describe a Web service. This model is called the Component Model of WSDL 2.0.
Components are typed collections of properties that correspond to different aspects of Web services.
Editorial note | |
Change property to avoid confusion with other meaning in spec. |
Properties are unordered and unique with respect to the component they are associated with. Individual properties' definitions may constrain their content (e.g., to a typed value, another component, or a set of typed values or components), and components may require the presence of a property to be considered conformant. Such properties are marked as REQUIRED, whereas those that are not required to be present are marked as OPTIONAL. By convention, when specifying the mapping rules from the XML Infoset representation of a component to the component itself, an optional property that is absent in the component in question is described as being “empty”. Unless otherwise specified, when a property is identified as being a collection (a set or a list), its value may be a 0-element (empty) collection. In order to simplify the presentation of the rules that deal with sets of components, for all OPTIONAL properties whose type is a set, the absence of such a property from a component MUST be treated as semantically equivalent to the presence of a property with the same name and whose value is the empty set. In other words, every OPTIONAL set-valued property MUST be assumed to have the empty set as its default value, to be used in case the property is absent.
Component definitions are serializable in XML 1.0 format but are independent of any particular serialization of the component model. Component definitions use a subset (see 2.16 XML Schema 1.0 Simple Types Used in the Component Model) of the simple types defined by the XML Schema 1.0 specification [XML Schema: Datatypes].
In addition to the direct XML Infoset representation described here, the component model allows components external to the Infoset through the mechanisms described in 4. Modularizing WSDL 2.0 descriptions.
A component model can be extracted from a given XML Infoset
which conforms to the XML Schema for WSDL 2.0 by recursively
mapping Information Items to their identified components, starting
with the wsdl:description
element information
item. This includes the application of the mechanisms
described in 4. Modularizing WSDL 2.0
descriptions.
This document does not specify a means of producing an XML Infoset representation from a component model instance. In particular, there are in general many valid ways to modularize a given component model instance into one or more XML Infosets.
At the abstract level, the Description component is just a container for two categories of components: WSDL 2.0 components and type system components.
WSDL 2.0 components are interfaces, bindings and services. Type system components are element declarations and type definitions.
Interface, Binding, Service, Element Declaration, and Type Definition components are directly contained in the Description component and are referred to as top-level components. The top-level WSDL 2.0 components contain other components, e.g. Interface Operation and Endpoint, which are referred to as nested components. Nested components may contain other nested components. The component that contains a nested component is referred to as the parent of the nested components. Nested components have a {parent} property that is a reference to their parent component.
Type system components describe the constraints on a message's content. By default, these constraints are expressed in terms of the [XML Information Set], i.e. they define the [local name], [namespace name], [children] and [attributes] properties of an element information item. Type systems based upon other data models are generally accommodated by extensions to WSDL 2.0; see 6. Language Extensibility. In the case where they define information equivalent to that of a XML Schema global element declaration, they can be treated as if they were such a declaration.
This specification does not define the behavior of a WSDL 2.0 document that uses multiple schema languages for describing type system components simultaneously.
The properties of the Description component are as follows:
{interfaces} OPTIONAL. A set of Interface components.
{bindings} OPTIONAL. A set of Binding components.
{services} OPTIONAL. A set of Service components.
{element declarations} OPTIONAL. A set of named element declarations, each one isomorphic to a global element declaration as defined by XML Schema.
{type definitions} OPTIONAL. A set of named type definitions, each one isomorphic to a global type definition as defined by XML Schema.
The set of top-level components contained in the Description
component associated with an initial WSDL 2.0 document consists of
the components defined in the initial document and the components
associated with the documents that the initial document includes or
imports. The component model makes no distinction between the
components that are defined in the initial document versus those
that are defined in the included or imported documents. However,
any WSDL 2.0 document that contains component definitions that
refer by QName to WSDL 2.0 components that belong to a different
namespace MUST contain a ws:import
element
information item for that namespace (see 4.2 Importing Descriptions). Furthermore, all
QName references, whether to the same or to different namespaces
MUST resolve to components (see 2.19 QName
resolution).
In addition to WSDL 2.0 components and type system components, additional extension components MAY be added via extensibility 6. Language Extensibility. Further, additional properties to WSDL 2.0 and type system components MAY also be added via extensibility.
<description targetNamespace="xs:anyURI" > <documentation />? [ <import /> | <include /> ]* <types />? [ <interface /> | <binding /> | <service /> ]* </description>
WSDL 2.0 definitions are represented in XML by one or more WSDL
2.0 Information Sets (Infosets), that is one or more
description
element information items. A WSDL
2.0 Infoset contains representations for a collection of WSDL 2.0
components which share a common target namespace. A WSDL 2.0
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 components directly defined or included within a Description
component are said to belong to the same target namespace.
The target namespace therefore groups a set of related component
definitions and represents an unambiguous name for the intended
semantics of the collection of components. The value of the
targetNamespace
attribute information item
SHOULD be a dereferenceable URI. It SHOULD resolve to a human or
machine processable document that directly or indirectly defines
the intended semantics of those components. It MAY resolve to a
WSDL 2.0 document which provides service description information
for that namespace.
If a service description is split into multiple documents (which
may be combined as needed via 4.1 Including
Descriptions), then the targetNamespace
attribute information item SHOULD resolve to a master
document which includes all the WSDL 2.0 documents needed for that
service description. This approach enables the WSDL 2.0 component
designators' fragment identifiers to be properly resolvable.
Imported components have different target namespace values from the Description component that is importing them. Thus importing is the mechanism to use components from one namespace in another set of definitions.
Each WSDL 2.0 or type system component MUST be uniquely identified by its qualified name. That is, if two distinct components of the same kind (Interface, Binding etc.) are in the same target namespace, then their QNames MUST be unique. However, different kinds of components (e.g., an Interface component and a Binding component) MAY have the same QName. Thus, QNames of components must be unique within the space of those components in a given target namespace.
The description
element information item
has the following Infoset properties:
A [local name] of description
.
A [namespace name] of "http://www.w3.org/2005/05/wsdl".
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED targetNamespace
attribute
information item as described below in 2.1.2.1 targetNamespace
attribute information item.
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information items amongst its [children], in order as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
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 whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
An OPTIONAL types
element information item
(see 3. Types).
Zero or more element information items from among the following, in any order:
interface
element information items (see
2.2.2 XML Representation of
Interface Component).
binding
element information items (see
2.9.2 XML Representation of Binding
Component).
service
element information items (see
2.14.2 XML Representation of Service
Component).
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
targetNamespace
attribute information
itemThe targetNamespace
attribute information
item defines the namespace affiliation of top-level components
defined in this description
element information
item. 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. The value of the
targetNamespace
attribute information item
MUST be an absolute URI (see [IETF RFC
3986]).
The mapping from the XML Representation of the
description
element information item (see
2.1.2 XML Representation of
Description Component) to the properties of the Description
component (see 2.1.1 The
Description Component) is described in Table 2-1.
Property | Value |
---|---|
{interfaces} | The set of Interface components
corresponding to all the interface element
information items in the [children] of the
description element information item, if any,
plus any included or imported Interface components (see 4. Modularizing WSDL 2.0
descriptions). |
{bindings} | The set of Binding components
corresponding to all the binding element
information items in the [children] of the
description element information item, if any,
plus any included or imported Binding components (see 4. Modularizing WSDL 2.0
descriptions). |
{services} | The set of Service components
corresponding to all the service element
information items in the [children] of the
description element information item, if any,
plus any included or imported Service components (see 4. Modularizing WSDL 2.0
descriptions). |
{element declarations} | The set of element declarations
corresponding to all the element declarations defined as
descendants of the types element information
item, if any, plus any included or imported element
declarations. At a minimum this will include all the global element
declarations defined by XML Schema element element
information items. It MAY also include any declarations from
some other type system which describes the [local name], [namespace
name], [attributes] and [children] properties of an element
information item. |
{type definitions} | The set of type definitions
corresponding to all the type definitions defined as descendants of
the types element information item, if any,
plus any included or imported type definitions. At a minimum this
will include all the global type definitions defined by XML Schema
simpleType and complexType element
information items. It MAY also include any definitions from
some other type system which describes the [attributes] and
[children] properties of an element information item. |
An Interface component describes sequences of messages that a service sends and/or receives. It does this by grouping related messages into operations. An operation is a sequence of input and output messages, and an interface is a set of operations.
An interface can optionally extend one or more other interfaces. To avoid circular definitions, an interface MUST NOT appear as an element of the set of interfaces it extends, either directly or indirectly. The set of operations available in an interface includes all the operations defined by the interfaces it extends, along with any operations it directly defines. The operations directly defined on an interface are referred to as the declared operations of the interface. In the process, operation components that are equivalent per 2.17 Equivalence of Components are treated as one. The interface extension mechanism behaves in a similar way for all other components that can be defined inside an interface, namely Interface Fault, Feature and Property components.
Interfaces are named constructs and can be referred to by QName (see 2.19 QName resolution). For instance, Binding components refer to interfaces in this way.
The properties of the Interface component are as follows:
{name} REQUIRED. An xs:QName.
{extended interfaces} OPTIONAL. A set of declared Interface components which this interface extends.
{interface faults} OPTIONAL. The set of declared Interface Fault components. The namespace name of the {name} property of each Interface Fault in this set MUST be the same as the namespace name of the {name} property of this Interface component.
{interface operations} OPTIONAL. A set of declared Interface Operation components. The namespace name of the {name} property of each Interface Operation in this set MUST be the same as the namespace name of the {name} property of this Interface component.
{features} OPTIONAL. A set of declared Feature components.
{properties} OPTIONAL. A set of declared Property components.
For each Interface component in the {interfaces} property of a description container, the {name} property MUST be unique.
<description> <interface name="xs:NCName" extends="list of xs:QName"? styleDefault="list of xs:anyURI"? > <documentation />? [ <fault /> | <operation /> | <feature /> | <property /> ]* </interface> </description>
The XML representation for an Interface component is an element information item with the following Infoset properties:
A [local name] of interface
A [namespace name] of "http://www.w3.org/2005/05/wsdl"
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED name
attribute information item
as described below in 2.2.2.1 name attribute information
item with interface [owner element].
An OPTIONAL extends
attribute information
item as described below in 2.2.2.2 extends attribute
information item.
An OPTIONAL styleDefault
attribute information
item as described below in 2.2.2.3 styleDefault
attribute information item.
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information items amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more element information items from among the following, in any order:
Zero or more fault
element information
items 2.3.2 XML
Representation of Interface Fault Component.
Zero or more operation
element information
items 2.4.2 XML
Representation of Interface Operation Component.
Zero or more feature
element information
items 2.7.2 XML Representation of
Feature Component.
Zero or more property
element information
items 2.8.2 XML Representation
of Property Component.
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
name
attribute information item with interface
[owner element]The name
attribute information item
together with the targetNamespace
attribute
information item of the [parent] description
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.
extends
attribute information itemThe 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.
styleDefault
attribute information itemThe styleDefault
attribute information
item indicates the default style (see 2.4.1.1 Operation Style) used
to construct the {element} properties of {interface message
references} of all operations contained within the [owner element]
interface
.
The styleDefault
attribute information
item has the following Infoset properties:
A [local name] of styleDefault.
A [namespace name] which has no value.
The type of the styleDefault
attribute
information item is list of xs:anyURI. Moreover, the
value of the styleDefault
attribute information
item, if present, MUST contain absolute URIs (see
[IETF RFC 3986]).
The mapping from the XML Representation of the
interface
element information item (see
2.2.2 XML Representation of
Interface Component) to the properties of the Interface
component (see 2.2.1 The Interface
Component) is as described in Table 2-2.
Property | Value |
---|---|
{name} | The QName whose local name is actual
value of the name attribute information item
and whose namespace name is the actual value of the
targetNamespace attribute information item of
the [parent] description element information
item |
{extended interfaces} | The set of Interface components
resolved to by the values in the extends attribute
information item if any (see 2.19 QName
resolution). |
{interface faults} | The set of Interface Fault components
corresponding to the fault element information
items in [children], if any. |
{interface operations} | The set of Interface 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. |
Note that, per 2.2.1 The Interface Component, the Interface components in the {extended interfaces} property of a given Interface component MUST NOT contain that Interface component in any of their {extended interfaces} properties, that is to say, recursive extension of interfaces is disallowed.
A fault is an event that occurs during the execution of a message exchange that disrupts the normal flow of messages.
A fault is typically raised when a party is unable to communicate an error condition inside the normal message flow, or a party wishes to terminate a message exchange. A fault message may be used to communicate out of band information such as the reason for the error, the origin of the fault, as well as other informal diagnostics such as a program stack trace.
An Interface Fault component describes a fault that MAY occur during invocation of an operation of the interface. The Interface Fault component declares an abstract fault by naming it and indicating the contents of the fault message. When and how the fault message flows is indicated by the Interface Operation component 2.4 Interface Operation.
The Interface Fault component provides a clear mechanism to name and describe the set of faults an interface may generate. This allows operations to easily identify the individual faults they may generate by name. This mechanism allows the ready identification of the same fault occurring across multiple operations and referenced in multiple bindings as well as reducing duplication of description for an individual fault.
Note that faults other than the ones described in the Interface component can also be generated at run-time, i.e. faults are an open set.
The properties of the Interface Fault component are as follows:
{name} REQUIRED. An xs:QName.
{element declaration} OPTIONAL. A reference to an XML element declaration in the {element declarations} property of 2.1.1 The Description Component. This element represents the content or “payload” of the fault.
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
{parent} REQUIRED. The Interface component that contains this component in its {interface faults} property.
If a type system NOT based on the XML Infoset [XML Information Set] is in use (as considered in 3.2 Using Other Schema Languages) then additional properties would need to be added to the Interface Fault Component (along with extensibility attributes to its XML representation) to allow associating such message types with the message reference.
For each Interface Fault component in the {interface faults} property of an Interface component, the {name} property must be unique.
Interface Fault components are uniquely identified by the the QName of the enclosing Interface component and QName of the Interface Fault component itself.
Note:
Despite having a {name} property, Interface Fault components cannot be identified solely by their QName. Indeed, two Interface components whose {name} property value has the same namespace name, but different local names, can contain Interface Fault components with the same {name} property value. Thus, the {name} property of Interface Fault components is not sufficient to form the unique identity of an Interface Fault component.
In cases where, due to an interface extending one or more other interfaces, two or more Interface Faults components have the same value for their {name} property, then the component models of those Interface Fault components MUST be equivalent (see 2.17 Equivalence of Components). If the Interface Fault components are equivalent then they are considered to collapse into a single component. It is an error if two Interface Fault components have the same value for their {name} properties but are not equivalent.
Note that, due to the above rules, if two interfaces that have the same value for the namespace name of their {name} property also have one or more faults that have the same value for their {name} property then those two interfaces cannot both form part of the derivation chain of a derived interface unless those faults are the same fault.
Note:
For the above reason, it is considered good practice to ensure, where necessary, that the local name of the {name} property of Interface Fault components within a namespace are unique, thus allowing such derivation to occur without inadvertent error.
<description> <interface> <fault name="xs:NCName" element="xs:QName"? > <documentation />? [ <feature /> | <property /> ]* </fault> </interface> </description>
The XML representation for an Interface Fault component is an element information item with the following Infoset properties:
A [local name] of fault
A [namespace name] of "http://www.w3.org/2005/05/wsdl"
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED name
attribute information item
as described below in 2.3.2.1 name attribute
information item with fault [owner element].
An OPTIONAL element
attribute information
item as described below in 2.3.2.2 element attribute
information item with fault [owner element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information item amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more element information items from among the following, in any order:
Zero or more feature
element information
items 2.7.2 XML Representation of
Feature Component
Zero or more property
element information
items 2.8.2 XML Representation
of Property Component
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
name
attribute information item with fault
[owner
element]The name
attribute information item
identifies a given fault
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.
element
attribute information item with fault
[owner
element]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.
The mapping from the XML Representation of the
fault
element information item (see 2.3.2 XML Representation of Interface
Fault Component) to the properties of the Interface Fault
component (see 2.3.1 The
Interface Fault Component) is as described in Table 2-3.
Property | Value |
---|---|
{name} | The QName whose local name is the
actual value of the name attribute information
item. and whose namespace name is the actual value of the
targetNamespace attribute information item of
the [parent] description element information
item of the [parent] interface element
information item. |
{element declaration} | The element declaration from the
{element declarations} property of 2.1.1 The Description Component
resolved to by the value of the element attribute
information item if present (see 2.19
QName resolution), otherwise empty. It is an error for the
element attribute information item to have a
value and for it to not resolve to a global element declaration
from the {element declarations} property of 2.1.1 The Description
Component. |
{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. |
{parent} | The Interface component corresponding
to the interface element information item in
[parent]. |
An Interface Operation component describes an operation that a given interface supports. An operation is an interaction with the service consisting of a set of (ordinary and fault) messages exchanged between the service and the other parties involved in the interaction. The sequencing and cardinality of the messages involved in a particular interaction is governed by the message exchange pattern used by the operation (see {message exchange pattern} property).
A message exchange pattern defines placeholders for messages, the participants in the pattern (i.e., the sources and sinks of the messages), and the cardinality and sequencing of messages exchanged by the participants. The message placeholders are associated with specific message types by the operation that uses the pattern by means of message and fault references (see {inteface message references} and {interface fault references} properties). The service whose operation is using the pattern becomes one of the participants of the pattern. This specification does not define a machine understandable language for defining message exchange patterns, nor does it define any specific patterns. The companion specification, [WSDL 2.0 Adjuncts] defines a set of such patterns and defines identifying URIs any of which MAY be used as the value of the {message exchange pattern} property.
The properties of the Interface Operation component are as follows:
{name} REQUIRED. An xs:QName.
{message exchange pattern} REQUIRED. An xs:anyURI identifying the message exchange pattern used by the operation. This URI MUST be an absolute URI (see [IETF RFC 3986]).
{interface message references} OPTIONAL. A set of Interface Message Reference components for the ordinary messages the operation accepts or sends. (See 2.5 Interface Message Reference.)
{interface fault references} OPTIONAL. A set of Interface Fault Reference components for the fault messages the operation accepts or sends. (See 2.6 Interface Fault Reference.)
{style} OPTIONAL. A set of xs:anyURIs identifying the rules that were used to construct the {element} properties of {interface message references}. (See 2.4.1.1 Operation Style.) These URIs MUST be absolute URIs (see [IETF RFC 3986]).
{safety} REQUIRED. An xs:boolean indicating whether the operation is asserted to be safe (as defined in Section 3.5 of [Web Architecture]) for users of the described service to invoke. If this property is false, then no assertion has been made about the safety of the operation, thus the operation MAY or MAY NOT be safe. However, an operation SHOULD be marked safe if it meets the criteria for a safe interaction defined in Section 3.5 of [Web Architecture].
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
{parent} REQUIRED. The Interface component that contains this component in its {interface operations} property.
For each Interface Operation component in the {interface operations} property of an Interface component, the {name} property MUST be unique.
Interface Operation components are uniquely identified by the the QName of the enclosing Interface component and QName of the Interface Operation component itself.
Note:
Despite having a {name} property, Interface Operation components cannot be identified solely by their QName. Indeed, two Interface components whose {name} property value has the same namespace name, but different local names, can contain Interface Operation components with the same {name} property value. Thus, the {name} property of Interface Operation components is not sufficient to form the unique identity of an Interface Operation component.
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} property, then the component models of those Interface Operation components MUST be equivalent (see 2.17 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} property but are not equivalent.
Note that, due to the above rules, if two interfaces that have the same value for the namespace name of their {name} 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.
Note:
For the above reason, it is considered good practice to ensure, where necessary, that the {name} property of Interface Operation components within a namespace are unique, thus allowing such derivation to occur without inadvertent error.
More than one Interface Fault Reference component in the {interface fault references} property of an Interface Operation component may refer to the same message label. In that case, the listed fault types define alternative fault messages. This allows one to indicate that there is more than one type of fault that is related to that message.
If the {style} property of an Interface Operation component has a value then that value (a set of URIs) implies the rules that were used to define the {element} properties (or other property which defines the content of the message properties; see 3.2 Using Other Schema Languages) of all the Interface Message Reference components which are members of the {message references} property of that component. Although a given operation style has the ability to constrain all input and output messages for an operation, it MAY choose to contrain only the former or the latter or any combination thereof.
Note that the property MAY not have any value. If this property has a value (a set of URIs), then for each individual URI that is an element of that set, the rules implied by that URI (such as rules that govern the schemas) MUST be followed or it is an error. So, if the set of URIs has more than one item in it, then the rules implied by ALL the URIs must be adhered to by the content definitions.
The WSDL Version 2.0 Part 2: Adjuncts specification [WSDL 2.0 Adjuncts] defines the following operation style:
RPC Style
<description> <interface> <operation name="xs:NCName" pattern="xs:anyURI" style="list of xs:anyURI"? safe="xs:boolean"? > <documentation />? [ <feature /> | <property /> | [ <input /> | <output /> | <infault /> | <outfault /> ]+ ]* </operation> </interface> </description>
The XML representation for an Interface Operation component is an element information item with the following Infoset properties:
A [local name] of operation
A [namespace name] of "http://www.w3.org/2005/05/wsdl"
Two or more attribute information items amongst its [attributes] as follows:
A REQUIRED name
attribute information item
as described below in 2.4.2.1 name attribute
information item with operation [owner element].
A REQUIRED pattern
attribute information
item as described below in 2.4.2.2 pattern
attribute information item with operation [owner
element].
An OPTIONAL style
attribute information
item as described below in 2.4.2.3 style attribute
information item with operation [owner element].
An OPTIONAL safe
attribute information
item as described below in 2.4.2.4 safe attribute
information item with operation [owner element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
One or more element information item amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
One or more element information items from among the following, in any order:
One or more element information items from among the following, in any order:
Zero or more input
element information
items (see 2.5.2 XML Representation of
Interface Message Reference Component).
Zero or more output
element information
items (see 2.5.2 XML Representation of
Interface Message Reference Component).
Zero or more infault
element information
items (see 2.6.2
XML Representation of Interface Fault Reference).
Zero or more outfault
element information
items (see 2.6.2
XML Representation of Interface Fault Reference).
Zero or more element information items from among the following, in any order:
A feature
element information item (see
2.7.2 XML Representation of Feature
Component).
A property
element information item (see
2.8.2 XML Representation of Property
Component).
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
name
attribute information item with operation
[owner element]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.
pattern
attribute information item with
operation
[owner element]The pattern
attribute information item
identifies the message exchange 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. Its value MUST be an absolute
URI.
style
attribute information item with operation
[owner element]The style
attribute information item
indicates the rules that were used to construct the {element}
properties of the Interface Message Reference components which are
members of the {interface message references} property of the
[owner element] operation.
The style
attribute information item has
the following Infoset properties:
A [local name] of style
A [namespace name] which has no value
The type of the style
attribute information
item is list of xs:anyURI. Its value MUST be an
absolute URI.
safe
attribute information item with operation
[owner element]The safe
attribute information item
indicates whether the operation is declared to be safe or
not.
The safe
attribute information item has
the following Infoset properties:
A [local name] of safe
A [namespace name] which has no value
The type of the safe
attribute information
item is xs:boolean and does not have a default
value.
The mapping from the XML Representation of the
operation
element information item (see
2.4.2 XML Representation of
Interface Operation Component) to the properties of the
Interface Operation component (see 2.4.1 The Interface Operation
Component) is as described in Table 2-4.
Property | Value |
---|---|
{name} | The QName whose local name is the
actual value of the name attribute information
item and whose namespace name is the actual value of the
targetNamespace attribute information item of
the [parent] description element information
item of the [parent] interface element
information item. |
{message exchange pattern} | The actual value of the
pattern attribute information item |
{interface message references} | The set of message references
corresponding to the input and output
element information items in [children], if any. |
{interface fault references} | The set of interface fault references
corresponding to the infault and outfault
element information items in [children], if any. |
{style} | The set containing the URIs in the
actual value of the style attribute information
item if present, otherwise the set containing the URIs in the
actual value of the styleDefault attribute
information item of the [parent] interface
element information item if present, otherwise empty. |
{safety} | The actual value of the
safe attribute information item if present,
otherwise the value false. |
{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. |
{parent} | The Interface component corresponding
to the interface element information item in
[parent]. |
A Interface Message Reference component associates a defined element with a message exchanged in an operation. By default, the element is defined in the XML Infoset [XML Information Set].
A message exchange pattern defines a set of placeholder messages that participate in the pattern and assigns them unique message labels within the pattern (e.g. 'In', 'Out'). The purpose of an Interface Message Reference component is to associate an actual message element (XML element declaration or some other declaration (see 3.2 Using Other Schema Languages)) with a message in the pattern, as identified by its message label. Later, when the message exchange pattern is instantiated, messages corresponding to that particular label will follow the element assignment made by the Interface Message Reference component.
The properties of the Interface Message Reference component are as follows:
{message label} REQUIRED. An xs:NCName. This property identifies the role this message plays in the {message exchange pattern} of the Interface Operation component this message is contained within. The value of this property MUST match the name of a placeholder message defined by the message exchange pattern.
{direction} REQUIRED. An xs:token with one of the values in or out, indicating whether the message is coming to the service or going from the service, respectively. The direction MUST be the same as the direction of the message identified by the {message label} property in the {message exchange pattern} of the Interface Operation component this is contained within.
{message content model} REQUIRED. An xs:token with one of the values #any, #none, #other, or #element. A value of #any indicates that the message content is any single element. A value of #none indicates there is no message content. A value of #other indicates that the message content is described by some other extension property that references a declaration in a non-XML extension type system. A value of #element indicates that the message consists of a single element described by the global element declaration referenced by the {element} property. This property is used only when the message is described using an XML based data model.
{element declaration} OPTIONAL. A reference to an XML element declaration in the {element declarations} property of 2.1.1 The Description Component. This element represents the content or “payload” of the message. When the {message content model} property has the value #any or #none the {element declaration} property MUST be empty.
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
{parent} REQUIRED. The Interface Operation component that contains this component in its {interface message references} property.
If a type system not based upon the XML Infoset is in use (as considered in 3.2 Using Other Schema Languages) then additional properties would need to be added to the Interface Message Reference Component (along with extensibility attributes to its XML representation) to allow associating such message types with the message reference.
For each Interface Message Reference component in the {message references} property of an Interface Operation component, its {message label} property MUST be unique.
<description> <interface> <operation> <input messageLabel="xs:NCName"? element="union of xs:QName, xs:token"? > <documentation />? [ <feature /> | <property /> ]* </input> <output messageLabel="xs:NCName"? element="union of xs:QName, xs:token"? > <documentation />? [ <feature /> | <property /> ]* </output> </operation> </interface> </description>
The XML representation for an Interface Message Reference component is an element information item with the following Infoset properties:
A [local name] of input
or output
A [namespace name] of "http://www.w3.org/2005/05/wsdl"
Zero or more attribute information items amongst its [attributes] as follows:
An OPTIONAL messageLabel
attribute information
item as described below in 2.5.2.1
messageLabel attribute information item with input or output [owner
element].
If the {message exchange pattern} of the Interface Operation
component has only one message with a given value for {direction},
then the messageLabel
attribute information
item is optional for the XML representation of the Message
Reference component with that {direction}.
An OPTIONAL element
attribute information
item as described below in 2.5.2.2 element
attribute information item with input or output [owner
element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information item amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more element information items from among the following, in any order:
Zero or more feature
element information
items 2.7.2 XML Representation of
Feature Component
Zero or more property
element information
items 2.8.2 XML Representation
of Property Component
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
messageLabel
attribute information item with
input
or output
[owner element]The messageLabel
attribute information
item identifies the role of this message in the message
exchange pattern of the given operation
element
information item.
The messageLabel
attribute information
item has the following Infoset properties:
A [local name] of messageLabel
A [namespace name] which has no value
The type of the messageLabel
attribute
information item is xs:NCName.
element
attribute information item with
input
or output
[owner element]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 a union of xs:QName and xs:token
where the allowed token values are #any, #none,
or #other.
The mapping from the XML Representation of the message reference element information item (see 2.5.2 XML Representation of Interface Message Reference Component) to the properties of the Interface Message Reference component (see 2.5.1 The Interface Message Reference Component) is as described in Table 2-5.
Property | Value |
---|---|
{message label} | The actual value of the
messageLabel attribute information item if
any; otherwise the {message label} property of the message with
same {direction} from the {message exchange pattern} of the
Interface Operation component, provided there is exactly one such
message; otherwise it is an error. |
{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 content model} | If the element
attribute information item is present and its value is a
QName, then #element. Otherwise the actual value of the
element attribute information item, if any,
otherwise #other. |
{element declaration} | If the element
attribute information item is present and its value is a
QName, then the element declaration from the {element declarations}
property of 2.1.1 The Description
Component resolved to by the value of the
element attribute information item (see
2.19 QName resolution), otherwise
empty. It is an error for the element attribute
information item to have a value and for it to not resolve to
a global element declaration from the {element declarations}
property of 2.1.1 The Description
Component. |
{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. |
{parent} | The Interface Operation component
corresponding to the interface element information
item in [parent]. |
An Interface Fault Reference component associates a defined type, specified by an Interface Fault component, to a fault message exchanged in an operation.
A message exchange pattern defines a set of placeholder messages that participate in the pattern and assigns them unique message labels within the pattern (e.g. 'In', 'Out'). The purpose of an Interface Fault Reference component is to associate an actual message type (XML element declaration or some other declaration (see 3.2 Using Other Schema Languages) for message content, as specified by an Interface Fault component) with a fault message occurring in the pattern. In order to identify the fault message it describes, the Fault Reference component uses the message label of the message the fault is associated with as a key.
The companion specification [WSDL 2.0 Adjuncts] defines two fault patterns that a given message exchange pattern may use. For the pattern fault-replaces-message, the message that the fault relates to identifies the message in place of which the declared fault message will occur. Thus, the fault message will travel in the same direction as the message it replaces in the pattern. For the pattern message-triggers-fault, the message that the fault relates to identifies the message after which the indicated fault may occur, in the opposite direction of the referred to message. That is, the fault message will travel in the opposite direction of the message it comes after in the pattern.
The properties of the Interface Fault Reference component are as follows:
{interface fault} REQUIRED. An Interface Fault component in the {interface faults} property of the [parent] Interface Operation component's [parent] Interface component, or an Interface component that it directly or indirectly extends. Identifying the Interface Fault component therefore indirectly defines the actual content or payload of the fault message.
{message label} REQUIRED. An xs:NCName. This property identifies the message this fault relates to among those defined in the {message exchange pattern} property of the Interface Operation component it is contained within. The value of this property MUST match the name of a placeholder message defined by the message exchange pattern.
{direction} REQUIRED. A xs:token with one of the values in or out, indicating whether the fault is coming to the service or going from the service, respectively. The direction MUST be consistent with the direction implied by the fault rule used in the message exchange pattern of the operation. For example, if the fault rule fault-replaces-message is used, then a fault which refers to an outgoing message would have a {direction} property value of out. On the other hand, if the fault rule message-triggers-fault is used, then a fault which refers to an outgoing message would have a {direction} property value of in as the fault travels in the opposite direction of the message.
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
{parent} REQUIRED. The Interface Operation component that contains this component in its {interface fault references} property.
<description> <interface> <operation> <infault ref="xs:QName" messageLabel="xs:NCName"? > <documentation />? [ <feature /> | <property /> ]* </infault>* <outfault ref="xs:QName" messageLabel="xs:NCName"? > <documentation />? [ <feature /> | <property /> ]* </outfault>* </operation> </interface> </description>
The XML representation for a Interface 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/2005/05/wsdl"
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED ref
attribute information item
as described below in 2.6.2.1 ref attribute
information item with infault, or outfault [owner
element].
An OPTIONAL messageLabel
attribute information
item as described below in 2.6.2.2
messageLabel attribute information item with infault, or outfault
[owner element].
If the {message exchange pattern} of the Interface Operation
component has only one message with a given value for {direction},
the messageLabel
attribute information item
is optional for the XML representation of any Interface Fault
Reference component with the same value for {direction} (if the
fault pattern of the {message exchange pattern} is
fault-replaces-message) or of any Fault Reference
component with the opposite value for {direction} (if the fault
pattern is message-triggers-fault).
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information item amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more element information items from among the following, in any order:
Zero or more feature
element information
items 2.7.2 XML Representation of
Feature Component
Zero or more property
element information
items 2.8.2 XML Representation
of Property Component
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
ref
attribute information item with
infault
, or outfault
[owner
element]The ref
attribute information item refers
to a fault component.
The ref
attribute information item has the
following Infoset properties:
A [local name] of ref
A [namespace name] which has no value
The type of the ref
attribute information
item is xs:QName.
messageLabel
attribute information item with
infault
, or outfault
[owner
element]The messageLabel
attribute information
item identifies the message in the message exchange pattern of
the given operation
element information item
to which this fault is related to.
The messageLabel
attribute information
item has the following Infoset properties:
A [local name] of messageLabel
A [namespace name] which has no value
The type of the messageLabel
attribute
information item is xs:NCName.
The mapping from the XML Representation of the message reference element information item (see 2.6.2 XML Representation of Interface Fault Reference) to the properties of the Interface Fault Reference component (see 2.6.1 The Interface Fault Reference Component) is as described in Table 2-6.
Property | Value |
---|---|
{interface fault} | The Interface Fault component from
{interface faults} property of the parent Interface component, or
an Interface component that it directly or indirectly extends,
whose {name} property is the actual value of the ref
attribute information item. |
{message label} | The actual value of the
messageLabel attribute information item if
any; otherwise the {message label} property of the message with the
same {direction} from the {message exchange pattern} of the
Interface Operation component, provided there is exactly one such
message and the fault pattern of the {message exchange
pattern} is fault-replaces-message; otherwise the
{interface message reference} property of the message with the
opposite {direction}, provided there is exactly one such message
and the fault pattern is message-triggers-fault;
otherwise it is an error. |
{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". |
{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. |
{parent} | The Interface Operation component
corresponding to the interface element information
item in [parent]. |
A feature component describes an abstract piece of functionality typically associated with the exchange of messages between communicating parties. Although WSDL 2.0 imposes no constraints on the potential scope of such features, examples might include “reliability”, “security”, “correlation”, and “routing”. The presence of a feature component in a WSDL 2.0 description indicates that the service supports the feature and may require a client that interacts with the service to use that feature. Each Feature is identified by its URI.
WSDL 2.0's feature concept is derived from SOAP 1.2's abstract feature concept ([SOAP 1.2 Part 1: Messaging Framework]). Thus, by definition, every SOAP 1.2 abstract feature is also a WSDL 2.0 feature and does not have to be declared as such.
The properties of the Feature component are as follows:
{uri} REQUIRED. An xs:anyURI. This URI MUST be absolute as defined by [IETF RFC 3986]. This URI SHOULD be dereferenceable to a document that directly or indirectly defines the meaning and use of the Feature that it identifies.
{required} REQUIRED. An xs:boolean. If the value of this property is true, then the client MUST use the Feature that is identified by the {uri} URI. Otherwise, the client MAY use the Feature that is identified by the {uri} URI. In either case, if the client does use the Feature that is identified by the {uri} URI, then the client MUST obey all semantics implied by the definition of that Feature.
{parent} REQUIRED. The component that contains this component in its {features} property.
The {uri} property of a Feature component MUST be unique within the {features} property of an Interface, Interface Fault, Interface Operation, Interface Message Reference, Fault Reference, Binding, Binding Fault, Binding Operation, Binding Message Reference, Binding Fault Reference, Service, or Endpoint component.
The set of features which are required or available for a given component consists of the combined set of ALL feature declarations applicable to that component. A feature is applicable to a component if:
it is asserted directly within that component, or
it is asserted in a containing component, or
it is asserted in a component referred to by the current component.
Following these rules, the set of features applicable at each component are as follows:
Interface component: all features asserted within the interface component.
Interface Fault component: all features asserted within the interface fault component and those within the [parent] interface component.
Interface Operation component: all features asserted within the interface operation component and those within the [parent] interface component.
Interface Message Reference component: all features asserted within the interface message reference component, those within the [parent] interface operation component and those within its [parent] interface component.
Interface Fault Reference component: all features asserted within the fault reference component, those within the [parent] interface operation component and those within its [parent] interface component.
Binding component: all features asserted within the binding component and those within the interface component referred to by the binding component (if any).
Binding Fault component: all features asserted within the binding fault component, those within the [parent] binding component, those within the corresponding interface fault component, and those within the interface component referred to by the binding component (if any).
Binding Operation component: all features asserted within the binding operation component, those within the [parent] binding component, those within the corresponding interface operation component, and those within the interface component referred to by the binding component.
Binding Message Reference component: all features asserted within the binding message reference component, those within the [parent] binding operation component, those within its [parent] binding component, those within the corresponding message reference component, and those within the interface component referred to by the binding component.
Binding Fault Reference component: all features asserted within the binding fault reference component, those within the [parent] binding operation component, those within its [parent] binding component, those within the corresponding fault reference component, and those within the interface component referred to by the binding component.
If a given feature is asserted at multiple locations, then the value of that feature at a particular component is determined by the conjunction of all the constraints implied by its asserted values. If a feature is not required then it may or may not be engaged, but if a feature is required then it must be engaged. Therefore, the conjunction of a required value and a non-required value is a required value. A composed feature is required if and only if at least one of its asserted values is required. This rule may be summarized as "true trumps".
In the following example, the depositFunds
operation on the BankService
has to be used with the
ISO9001
, the notarization
and the
secure-channel
features; they are all in scope. The
fact that the notarization
feature is declared both in
the operation and in the binding has no effect.
<description targetNamespace="http://example.com/bank" xmlns=http://www.w3.org/2005/05/wsdl xmlns:ns1="http://example.com/bank"> <interface name="ns1:Bank"> <!-- All implementations of this interface must be secure --> <feature uri="http://example.com/secure-channel" required="true"/> <operation name="withdrawFunds"> <!-- This operation must have ACID properties --> <feature uri="http://example.com/transaction" required="true"/> ... </operation> <operation name="depositFunds"> <!-- This operation requires notarization --> <feature uri="http://example.com/notarization" required="true"/> ... </operation> </interface> <binding name="ns1:BankSOAPBinding"> <!-- This particular binding requires ISO9001 compliance to be verifiable --> <feature uri="http://example.com/ISO9001" required="true"/> <!-- This binding also requires notarization --> <feature uri="http://example.com/notarization" required="true"/> </binding> <service name="ns1:BankService" interface="tns:Bank"> <endpoint binding="ns1:BankSOAPBinding"> ... </endpoint> </service> </description>
<feature uri="xs:anyURI" required="xs:boolean"? > <documentation />? </feature>
The XML representation for a Feature component is an element information item with the following Infoset properties:
A [local name] of feature
A [namespace name] of "http://www.w3.org/2005/05/wsdl"
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED uri
attribute information item
as described below in 2.7.2.1
uri attribute information item with feature [owner
element].
An OPTIONAL required
attribute information
item as described below in 2.7.2.2 required attribute
information item with feature [owner element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information items amongst its [children], in order as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
uri
attribute
information item with feature
[owner
element]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
.
required
attribute information item with feature
[owner element]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
.
The mapping from the XML Representation of the
feature
element information item (see
2.7.2 XML Representation of Feature
Component) to the properties of the Feature component (see
2.7.1 The Feature Component)
is as described in Table
2-7.
Property | Value |
---|---|
{uri} | The actual value of the
uri attribute information item |
{required} | The actual value of the
required attribute information item if
present, otherwise "false". |
{parent} | The component corresponding to the element information item in [parent]. |
A “property” in the Features and Properties architecture represents a named runtime value which affects the behavior of some aspect of a Web service interaction, much like an environment variable. For example, a reliable messaging SOAP module may specify a property to control the number of retries in the case of network failure. WSDL 2.0 documents may specify the value constraints for these properties by referring to a Schema type, or by specifying a particular value. Properties, and hence property values, can be shared amongst features/bindings/modules, and are named with URIs precisely to allow this type of sharing.
The properties of the Property component are as follows:
{uri} REQUIRED. An xs:anyURI. This URI MUST be absolute as defined by [IETF RFC 3986]. This URI SHOULD be dereferenceable to a document that directly or indirectly defines the meaning and use of the Property that it identifies.
{value constraint} OPTIONAL. A reference to a type definition in the {type definitions} property of 2.1.1 The Description Component constraining the value of the property, or the token #value if the {value} property is not empty.
{value} OPTIONAL. The value of the property, an ordered list of child information items, as specified by the [children] property of element information items in [XML Information Set].
{parent} REQUIRED. The component that contains this component in its {properties} property.
The {uri} property of a Property component MUST be unique within the {properties} property of an Interface, Interface Fault, Interface Operation, Interface Message Reference, Fault Reference, Binding, Binding Fault, Binding Operation, Binding Message Reference, Binding Fault Reference, Service, or Endpoint component.
If a type system not based upon the XML Infoset is in use (as considered in 3.2 Using Other Schema Languages) then additional properties would need to be added to the Property Component (along with extensibility attributes to its XML representation) to allow using such a type system to describe values and constraints for properties.
At runtime, the behavior of features, (SOAP) modules and bindings may be affected by the values of in-scope properties. Properties combine into a virtual “execution context” which maps property names (URIs) to constraints. Each property URI MAY therefore be associated with AT MOST one property constraint for a given interaction.
The set of properties which are required or available for a given component consists of the combined set of ALL property declarations applicable to that component. A property is applicable to a component if:
it is asserted directly within that component, or
it is asserted in a containing component, or
it is asserted in a component referred to by the current component.
Following these rules, the set of properties applicable at each component are as follows:
Interface component: all properties asserted within the interface component.
Interface Fault component: all properties asserted within the interface fault component and those within the [parent] interface component.
Interface Operation component: all properties asserted within the interface operation component and those within the [parent] interface component.
Interface Message Reference component: all properties asserted within the message reference component, those within the [parent] interface operation component and those within its [parent] interface component.
Binding component: all properties asserted within the binding component and those within the interface component referred to by the binding component (if any).
Binding Fault component: all properties asserted within the binding fault component, those within the [parent] binding component, those within the corresponding interface fault component, and those within the interface component referred to by the binding component (if any).
Binding Operation component: all properties asserted within the binding operation component, those within the [parent] binding component, those within the corresponding interface operation component, and those within the interface component referred to by the binding component.
Binding Message Reference component: all properties asserted within the binding message reference component, those within the [parent] binding operation component, those within its [parent] binding component, those within the corresponding interface message reference component, and those within the interface component referred to by the binding component.
Binding Fault Reference component: all properties asserted within the binding fault reference component, those within the [parent] binding operation component, those within its [parent] binding component, those within the corresponding fault reference component, and those within the interface component referred to by the binding component.
Note that, in the text above, “property constraint” (or, simply,
“constraint”) is used to mean EITHER a constraint
inside a property component OR a value
, since
value
may be considered a special case of
constraint
.
If a given property is asserted at multiple locations, then the value of that property at a particular component is determined by the conjunction of all the constraints of its in-scope property components. A property constraint asserts that, for a given interaction, the value of a property is either a specified value or belongs to a specified set of values. A specified value may be regarded as a singleton set, so in both cases a property constraint corresponds to an assertion that the property value belongs to some set. The conjunction of all the constraints associated with the in-scope properties is an assertion that the property value belongs to each of the associated sets, or equivalently, that the value belongs to the intersection of all the associated sets. If the intersection of the associated sets is empty, then the property constraints are mutually incompatible, and the composition is invalid. Therefore, the intersection of the associated sets SHOULD NOT be empty.
Note:
The reason that we phrase the requirement for a non-empty intersection as SHOULD rather than MUST, is that in general, it may be computationally difficult to determine by inspection of the type definitions that the intersection of two or more value sets is empty. Therefore, it is not a strict validity requirement that the intersection of the value sets be non-empty. An empty intersection will always result in failure of the service at run-time.
However, it is in general feasible to test specified values for either equality or membership in value sets. All specified values MUST be equal and belong to each specified value set.
<property uri="xs:anyURI" > <documentation />? [ <value /> | <constraint /> ]? </property>
The XML representation for a Property component is an element information item with the following Infoset properties:
A [local name] of property
A [namespace name] of "http://www.w3.org/2005/05/wsdl"
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED uri
attribute information item
as described below in 2.8.2.1
uri attribute information item with property [owner
element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information items amongst its [children], in order as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
One OPTIONAL element information item from among the following:
A value
element information item as
described in 2.8.2.2 value
element information item with property [parent]
A constraint
element information item as
described in 2.8.2.3
constraint element information item with property
[parent]
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
uri
attribute
information item with property
[owner
element]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
.
value
element
information item with property
[parent]<property> <value> xs:anyType </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/2005/05/wsdl"
The type of the value
element information
item is xs:anyType
.
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/2005/05/wsdl"
The type of the constraint
attribute
information item is xs:QName
.
The mapping from the XML Representation of the
property
element information item (see
2.8.2 XML Representation of Property
Component) to the properties of the Property component (see
2.8.1 The Property
Component) is as described in Table 2-8.
Property | Value |
---|---|
{uri} | The actual value of the
uri attribute information item. |
{value constraint} | If the constraint
element information item is present, the type definition
from the {type definitions} property of 2.1.1 The Description Component
resolved to by the value of the constraint element
information item (see 2.19 QName
resolution). Otherwise, if the value
element information item is present, the token
#value, otherwise empty. |
{value} | The value of the [children] property of
the value element information item, if that
element is present, otherwise empty. |
{parent} | The component corresponding to the element information item in [parent]. |
A Binding component describes a concrete message format and transmission protocol which may be used to define an endpoint (see 2.15 Endpoint). That is, a Binding component defines the implementation details necessary to access the service.
Binding components can be used to describe such information in a re-usable manner for any interface or specifically for a given interface. Furthermore, binding information MAY be specified on a per-operation basis (see 2.11.1 The Binding Operation Component) within an interface in addition to across all operations of an interface.
If a Binding component specifies any operation-specific binding details (by including Binding Operation components) or any fault binding details (by including Binding Fault components) then it MUST specify an interface the Binding component applies to, so as to indicate which interface the operations come from.
Conversely, a Binding component which omits any operation-specific binding details and any fault binding details MAY omit specifying an interface. Binding components that do not specify an interface MAY be used to specify operation-independent binding details for Service components with different interfaces. That is, such Binding components are reusable across one or more interfaces.
No concrete binding details are given in this specification. The companion specification, WSDL (Version 2.0): Adjuncts [WSDL 2.0 Adjuncts] defines such bindings for SOAP 1.2 [SOAP 1.2 Part 1: Messaging Framework] and HTTP [IETF RFC 2616]. Other specifications MAY define additional binding details. Such specifications are expected to annotate the Binding component (and its sub-components) with additional properties and specify the mapping from the XML representation to those properties.
A Binding component which defines bindings for an Interface component MUST define bindings for all the operations of that Interface component. The bindings may occur via defaulting rules which allow one to specify default bindings for all operations (see, for example [WSDL 2.0 Adjuncts]) or by directly listing each Operation component of the Interface component and defining bindings for them. Thus, it is an error for a Binding component to not define bindings for all the Operation components of the Interface component for which the Binding component purportedly defines bindings for.
Bindings are named constructs and can be referred to by QName (see 2.19 QName resolution). For instance, Endpoint components refer to bindings in this way.
The properties of the Binding component are as follows:
{name} REQUIRED. An xs:QName.
{interface} OPTIONAL. An Interface component indicating the interface for which binding information is being specified.
{type} REQUIRED. An xs:anyURI. This URI MUST be absolute as defined by [IETF RFC 3986]. The value of this URI indicates what kind of concrete binding details are contained within this Binding component. Specifications (such as [WSDL 2.0 Adjuncts] ) that define such concrete binding details MUST specify appropriate values for this property. The value of this property MAY be the namespace name of the extension elements or attributes which define those concrete binding details.
{binding faults} OPTIONAL. A set of Binding Fault components.
{binding operations} OPTIONAL. A set of Binding Operation components.
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
For each Binding component in the {bindings} property of a description container, the {name} property MUST be unique.
<description> <binding name="xs:NCName" interface="xs:QName"? type="xs:anyURI" > <documentation />? [ <fault /> | <operation /> | <feature /> | <property /> ]* </binding> </description>
The XML representation for a Binding component is an element information item with the following Infoset properties:
A [local name] of binding
A [namespace name] of "http://www.w3.org/2005/05/wsdl"
Two or more attribute information items amongst its [attributes] as follows:
A REQUIRED name
attribute information item
as described below in 2.9.2.1
name attribute information item with binding [owner
element].
An OPTIONAL interface
attribute information
item as described below in 2.9.2.2 interface attribute
information item with binding [owner element].
An REQUIRED type
attribute information
item as described below in 2.9.2.3 type attribute information
item with binding [owner element].
Zero or more namespace qualified attribute information items whgse [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information items amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more element information items from among the following, in any order:
Zero or more fault
element information
items (see 2.10.2 XML
Representation of Binding Fault Component).
Zero or more operation
element information
items (see 2.11.2 XML
Representation of Binding Operation Component).
Zero or more feature
element information
items (see 2.7.2 XML
Representation of Feature Component).
Zero or more property
element information
items (see 2.8.2 XML
Representation of Property Component).
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl". Such element information items are considered to be binding extension elements(see 2.9.2.4 Binding extension elements).
name
attribute information item with binding
[owner element]The name
attribute information item
together with the targetNamespace
attribute
information item of the description
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.
interface
attribute information item with binding
[owner element]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.
type
attribute information item with binding
[owner element]The type
attribute information item
identifies the kind of binding details contained in the Binding
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:anyURI.
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 from the XML representation to those properties.
The mapping from the XML Representation of the
binding
element information item (see
2.9.2 XML Representation of Binding
Component) to the properties of the Binding component (see
2.9.1 The Binding Component)
is as described in Table
2-9.
Property | Value |
---|---|
{name} | The QName whose local name is the
actual value of the name attribute information
item and whose namespace name is the actual value of the
targetNamespace attribute information item of
the [parent] description element information
item. |
{interface} | The Interface component resolved to by
the actual value of the interface attribute
information item (see 2.19 QName
resolution), if any. |
{type} | The actual value of the
type attribute information item. |
{binding faults} | The set of Binding Fault components
corresponding to the fault element information
items in [children], if any. |
{binding 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. |
A Binding Fault component describes a concrete binding of a particular fault within an interface to a particular concrete message format. A particular fault of an interface is uniquely identified by its {name} property.
Note that the fault does not occur by itself - it occurs as part of a message exchange as defined by an Interface Operation component (and its binding counterpart the Binding Operation component). Thus, the fault binding information specified in a Binding Fault component describes how faults that occur within a message exchange of an operation will be formatted and carried in the transport.
The properties of the Binding Fault component are as follows:
{interface fault} REQUIRED. An Interface Fault component in the {interface faults} property of the Interface component identified by the {interface} property of the [parent] Binding component, or an Interface component that that Interface component directly or indirectly extends. This is the Interface Fault component for which binding information is being specified.
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
{parent} REQUIRED. The Binding component that contains this component in its {binding faults} property.
For each Binding Fault component in the {binding faults} property of a Binding component, the {interace fault} property MUST be unique. That is, one cannot define multiple bindings for the same fault within a given Binding component.
<description> <binding> <fault ref="xs:QName" > <documentation />? [ <feature /> | <property /> ]* </fault> </binding> </description>
The XML representation for a Binding Fault component is an element information item with the following Infoset properties:
A [local name] of fault
A [namespace name] of "http://www.w3.org/2005/05/wsdl"
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED ref
attribute information item
as described below in 2.10.2.1 ref attribute
information item with fault [owner element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information item amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more element information items from among the following, in any order:
Zero or more feature
element information
items 2.7.2 XML Representation of
Feature Component
Zero or more property
element information
items 2.8.2 XML Representation
of Property Component
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl". Such element information items are considered to be binding fault extension elements as described below (see 2.10.2.2 Binding Fault extension elements).
ref
attribute information item with fault
[owner
element]The ref
attribute information item has the
following Infoset properties:
A [local name] of ref
A [namespace name] which has no value
The type of the ref
attribute information
item is xs:QName.
Binding Fault extension elements are used to provide information specific to a particular fault 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 Fault component with additional properties and specify the mapping from the XML representation to those properties.
The mapping from the XML Representation of the
fault
element information item (see 2.10.2 XML Representation of Binding
Fault Component) to the properties of the Binding Fault
component (see 2.10.1 The
Binding Fault Component) is as described in Table 2-10.
Property | Value |
---|---|
{interface fault} | The Interface Component corresponding
to the actual value of the ref attribute
information item. |
{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. |
{parent} | The Binding component corresponding to
the binding element information item in
[parent]. |
The Binding Operation component describes the concrete message format(s) and protocol interaction(s) associated with a particular interface operation for a given endpoint. A particular operation of an interface is uniquely identified by its {name} property.
The properties of the Binding Operation component are as follows:
{interface operation} REQUIRED. An Interface Operation component in the {interface operations} property of the Interface component identified by the {interface} property of the [parent] Binding component, or an Interface component that that Interface component directly or indirectly extends. This is the Interface Operation component for which binding information is being specified.
{binding message references} OPTIONAL. A set of Binding Message Reference components.
Editorial note: TODO - Editorial fix ME28 | 20050503 |
This will be so counter-intuitive for WSDL 1.1 readers that it bears repeating the motivation for this in 2.9.1. |
{binding fault references} OPTIONAL. A set of Binding Fault Reference components.
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
{parent} REQUIRED. The Binding component that contains this component in its {binding operations} property.
For each Binding Operation component in the {binding operations} property of a Binding component, the {interface operation} property MUST be unique. That is, one cannot define multiple bindings for the same operation within a given Binding component.
<description> <binding> <operation ref="xs:QName" > <documentation />? [ <input /> | <output /> | <infault /> | <outfault /> | <feature /> | <property /> ]* </operation> </binding> </description>
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/2005/05/wsdl"
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED ref
attribute information item
as described below in 2.11.2.1 ref attribute
information item with operation [owner element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information items amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more element information items from among the following, in any order:
Zero or more input
element information
items (see 2.12
Binding Message Reference)
Zero or more output
element information
items (see 2.12
Binding Message Reference)
Zero or more infault
element information
items (see 2.13 Binding
Fault Reference)
Zero or more outfault
element information
items (see 2.13 Binding
Fault Reference)
Zero or more feature
element information
item s (see 2.7.2 XML
Representation of Feature Component)
Zero or more property
element information
item s (see 2.7.2 XML
Representation of Feature Component)
Zero or more namespace-qualified element information item whose [namespace name] is NOT " http://www.w3.org/2005/05/wsdl ". Such element information items are considered to be binding operation extension elements as described below (see 2.11.2.2 Binding Operation extension elements).
ref
attribute information item with operation
[owner element]The ref
attribute information item has the
following Infoset properties:
A [local name] of ref
A [namespace name] which has no value
The type of the ref
attribute information
item is xs:QName.
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 from the XML representation to those properties.
The mapping from the XML Representation of the
operation
element information item (see
2.11.2 XML Representation of
Binding Operation Component) to the properties of the
Binding Operation component (see 2.11.1 The Binding Operation
Component) is as described in Table 2-11.
Property | Value |
---|---|
{interface operation} | The Interface Operation component
corresponding to the actual value of the ref
attribute information item. |
{binding messages references} | The set of Binding Message Reference
components corresponding to the input and
output element information items in
[children], if any. |
{binding fault references} | The set of Binding Fault Reference
components corresponding to the infault and
outfault 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. |
{parent} | The Binding component corresponding to
the binding element information item in
[parent]. |
A Binding Message Reference component describes a concrete binding of a particular message participating in an operation to a particular concrete message format.
The properties of the Binding Message Reference component are as follows:
{interface message reference} REQUIRED. An Interface Message Reference component among those in the {interface message references} property of the Interface Operation component being bound by the containing Binding Operation component.
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
{parent} REQUIRED. The Binding Operation component that contains this component in its {binding message references} property.
For each Binding Message Reference component in the {binding message references} property of a Binding Operation component, the {interface message reference} property MUST be unique. That is, the same message cannot be bound twice within the same operation.
<description> <binding> <operation> <input messageLabel="xs:NCName"? > <documentation />? [ <feature /> | <property /> ]* </input> <output messageLabel="xs:NCName"? > <documentation />? [ <feature /> | <property /> ]* </output> </operation> </binding> </description>
The XML representation for a Binding Message Reference component is an element information item with the following Infoset properties:
A [local name] of input
or output
.
A [namespace name] of "http://www.w3.org/2005/05/wsdl".
Zero or more attribute information items amongst its [attributes] as follows:
An OPTIONAL messageLabel
attribute information
item as described below in 2.12.2.1
messageLabel attribute information item with input or output [owner
element].
If the {message exchange pattern} of the Interface Operation
component being bound has only one message with a given value for
{direction}, then the messageLabel
attribute
information item is optional for the XML representation of the
Binding Message Reference component with that {direction}.
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information item amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more element information items from among the following, in any order:
Zero or more feature
element information
items 2.7.2 XML Representation of
Feature Component
Zero or more property
element information
items 2.8.2 XML Representation
of Property Component
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/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).
messageLabel
attribute information item with
input
or output
[owner element]The messageLabel
attribute information
item has the following Infoset properties:
A [local name] of messageLabel
.
A [namespace name] which has no value.
The type of the messageLabel
attribute
information item is xs:NCName.
Binding Message Reference extension elements 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 from the XML representation to those properties..
The mapping from the XML Representation of the
binding
element information item (see
2.12.2 XML
Representation of Binding Message Reference Component) to
the properties of the Binding Message Reference component (see
2.12.1 The Binding
Message Reference Component) is as described in Table 2-12.
Property | Value |
---|---|
{interface message reference} | Define the set of eligible message
reference components as the set of Interface Message Reference
components listed under the {interface message references} property
of the Interface operation component being bound such that their
{direction} property matches the one denoted by the [local name] of
the element information item, i.e. whose {direction} is
in if the [local name] of the element information
item is input , resp. out if it is
output . If the messageLabel
attribute information item has a value, then the Interface
Message Reference component among the eligible message reference
components with the same {messageLabel} property; otherwise, the
Interface Message Reference component among the eligible message
reference components, provided there is exactly one such component;
otherwise error. |
{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. |
{parent} | The Binding Operation component
corresponding to the operation element information
item in [parent]. |
A Binding Fault Reference component describes a concrete binding of a particular fault participating in an operation to a particular concrete message format.
The properties of the Binding Fault Reference component are as follows:
{interface fault reference} REQUIRED. A Interface Fault Reference component among those in the {interface fault references} property of the Interface Operation component being bound by the containing Binding Operation component.
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
{parent} REQUIRED. The Binding Operation component that contains this component in its {binding fault references} property.
For each Binding Fault Reference component in the {binding fault references} property of a Binding Operation component, the {interface fault reference} property MUST be unique. That is, the same fault cannot be bound twice within the same operation.
<description> <binding> <operation> <infault ref="xs:QName" messageLabel="xs:NCName"?> <documentation />? [ <feature /> | <property /> ]* </infault> <outfault ref="xs:QName" messageLabel="xs:NCName"?> <documentation />? [ <feature /> | <property /> ]* </outfault> </operation> </binding> </description>
The XML representation for a Binding 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/2005/05/wsdl".
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED ref
attribute information item
as described below in 2.13.2.1 ref attribute
information item with infault or outfault [owner
element].
An OPTIONAL messageLabel
attribute information
item as described below in 2.13.2.2
messageLabel attribute information item with infault or outfault
[owner element].
If the {message exchange pattern} of the Interface Operation
component being bound has only one message with a given value for
{direction}, then the messageLabel
attribute
information item is optional for the XML representation of the
Binding Fault Reference component with that {direction}.
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information item amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more element information items from among the following, in any order:
Zero or more feature
element information
items 2.7.2 XML Representation of
Feature Component
Zero or more property
element information
items 2.8.2 XML Representation
of Property Component
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl". Such element information items are considered to be binding fault reference extension elements as described below (see 2.13.2.3 Binding Fault Reference extension elements).
ref
attribute information item with
infault
or outfault
[owner element]The ref
attribute information item has the
following Infoset properties:
A [local name] of ref
.
A [namespace name] which has no value.
The type of the ref
attribute information
item is xs:QName.
messageLabel
attribute information item with
infault
or outfault
[owner element]The messageLabel
attribute information
item has the following Infoset properties:
A [local name] of messageLabel
.
A [namespace name] which has no value.
The type of the messageLabel
attribute
information item is xs:NCName.
Binding Fault Reference extension elements are used to provide information specific to a particular fault 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 Fault Reference component with additional properties and specify the mapping from the XML representation to those properties..
The mapping from the XML Representation of the
binding
element information item (see
2.13.2 XML
Representation of Binding Fault Reference Component) to the
properties of the Binding Fault Reference component (see 2.13.1 The Binding Fault
Reference Component) is as described in Table 2-13.
Property | Value |
---|---|
{interface fault reference} | Define the set of eligible interface
fault reference components as the set of Interface Fault Reference
components listed under the {interface fault references} property
of the Interface operation component being bound such that (1)
their {direction} property matches the one denoted by the [local
name] of the element information item, i.e. whose
{direction} is in if the [local name] of the
element information item is infault , resp.
out if it is outfault , and (2) the
Interface Fault components referred to by their {interface fault
reference} property have a {name} property whose value is equal to
the value of the ref attribute information
item of the element information item. If the
messageLabel attribute information item has a
value, then the Interface Fault Reference component among the
eligible fault reference components with the same {messageLabel}
property; otherwise, the Interface Fault Reference component among
the eligible fault reference components, provided there is exactly
one such component; otherwise error. |
{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. |
{parent} | The Binding Operation component
corresponding to the operation element information
item in [parent]. |
A Service component describes a set of endpoints (see 2.15 Endpoint) at which a particular deployed implementation of the service is provided. The endpoints thus are in effect alternate places at which the service is provided.
Services are named constructs and can be referred to by QName (see 2.19 QName resolution).
The properties of the Service component are as follows:
{name} REQUIRED. An xs:QName.
{interface} REQUIRED. An Interface component.
{endpoints} REQUIRED. A non-empty set of Endpoint components.
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
For each Service component in the {services} property of a description container, the {name} property MUST be unique.
Note:
This section is best-practice and hence non-normative.
It is generally desirable that, when a message recipient receives a message, it knows how to handle the message. In WSDL 2.0 terms, this means being able to map back the message to a single Interface Operation. However, this is NOT always possible. There are cases when multiple Interface Operations could correspond to the same received message. This happens either when:
the {message content model} property of any of these Interface Message Reference components (see below) has a value of “#any”; or
more than one of these Interface Message Reference components (see below) has a value of “#none”; or
the qualified names of the global element declarations specified by the values of the {element declaration} properties of these Interface Message Reference components (see below) are NOT unique when considered together.
The Interface Message Reference components above are defined as follows. First, consider the Interface component specified in the {interface} property of a Service component. Second, consider all Interface Operation components specified in the {interface operations} property of that Interface component and the Interface component it directly or indirectly extends. Third, consider all Interface Message Reference components specified in the {interface message references} properties of said Interface Operation components. Fourth, consider the Interface Message Reference components that have the same value for their {direction} property (i.e., either the token in or the token out). These are the Interface Message Reference components considered above.
If any of the three cases above arise, then one of the following two alternatives can be used. Note these alternatives are in no way mandated by this specification and are considered best practice only.
Feature. The {features} property of the Service or Interface components contains a Feature component, having a {required} property with a value of true. The feature unambiguously identifies the mechanism that a message sender is required to support in order to enable the message recipient to unambiguously determine the name of the Interface Operation component that is intended to be associated with the received message.
Extension. The element information item for the Interface component contains an extension element (i.e., an element that is not in the http://www.w3.org/2005/05/wsdl namespace), having a wsdl:required attribute information item with a value of "true". The extension element unambiguously identifies the mechanism that a message sender is required to support in order to enable the message recipient to unambiguously determine the name of the Interface Operation component that is intended to be associated with the received message.
The WS-Addressing [WS-Addressing] speficiation allready provides a disambiguation mechanism. It defines an [action] property whose value is embedded in each message, and that can be used to associate the message with a particular operation.
<description> <service name="xs:NCName" interface="xs:QName" > <documentation />? <endpoint />+ [ <feature /> | <property /> ]* </service> </description>
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/2005/05/wsdl"
Two or more attribute information items amongst its [attributes] as follows:
A REQUIRED name
attribute information item
as described below in 2.14.2.2
name attribute information item with service [owner
element].
A REQUIRED interface
attribute information
item as described below in 2.14.2.3 interface attribute
information item with service [owner element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
One or more element information item amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
One or more element information items from among the following, in any order:
One or more endpoint
element information
items (see 2.15.2 XML
Representation of Endpoint Component
Zero or more feature
and/or property
element information items (see 2.7.2 XML Representation of Feature
Component and 2.8.2 XML
Representation of Property Component, respectively).
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Note that ServiceType
, which is the XML Schema
[XML Schema: Structures]
complex type of the element information item
service
as defined in the WSDL 2.0 schema, MAY be used
as the basis for defining new elements which can be used as service
references in message exchanges. In the case that the message
contains a reference to a service that implements a known
interface, an element whose type restricts the complex type
ServiceType
to have a fixed value for the
attribute information item interface
MAY be
used. To enable such reuse, the WSDL 2.0 schema defines the
attribute information item name
as optional
in complex type ServiceType
, while it is REQUIRED for
the element information item service
as
indicated above.
Note:
See the primer [WSDL 2.0 Primer] for more information and examples.
name
attribute information item with service
[owner element]The name
attribute information item
together with the targetNamespace
attribute
information item of the description
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.
interface
attribute information item with service
[owner element]The interface
attribute information item
identifies the interface that the service is an instance 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:QName..
The mapping from the XML Representation of the
service
element information item (see
2.14.2 XML Representation of Service
Component) to the properties of the Service component (see
2.14.1 The Service Component)
is as described in Table
2-14.
Property | Value |
---|---|
{name} | The QName whose local name is the
actual value of the name attribute information
item and whose namespace name is the actual value of the
targetNamespace attribute information item of
the [parent] description element information
item |
{interface} | The Interface component resolved to by
the actual value of the interface attribute
information item (see 2.19 QName
resolution). |
{endpoints} | The Endpoint components corresponding
to the endpoint 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. |
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 (see A.2 Fragment Identifiers).
The properties of the Endpoint component are as follows:
{name} REQUIRED. An xs:NCName.
{binding} REQUIRED. A named Binding component.
{address} OPTIONAL. An xs:anyURI. This URI MUST be absolute as defined by [IETF RFC 3986]. If present, the value of this attribute represents the network address at which the service indicated by the [parent] Service component's {interface} property is offered via the binding referred to by the {binding} property.
{features} OPTIONAL. A set of Feature components.
{properties} OPTIONAL. A set of Property components.
{parent} REQUIRED. The Service component that contains this component in its {endpoints} property.
For each Endpoint component in the {endpoints} property of a Service component, the {binding} property (see 2.15.1 The Endpoint Component) MUST either be a Binding component with an unspecified {interface} property (see 2.9.1 The Binding Component or a Binding component with an {interface} property equal to the {interface} property of the Service component.
For each Endpoint component in the {endpoints} property of a Service component, the {name} property MUST be unique.
<description> <service> <endpoint name="xs:NCName" binding="xs:QName" address="xs:anyURI"? > <documentation />? [ <feature /> | <property /> ]* </endpoint>+ </service> </description>
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/2005/05/wsdl".
Two or more attribute information items amongst its [attributes] as follows:
A REQUIRED name
attribute information item
as described below in 2.15.2.2 name attribute information
item with endpoint [owner element].
A REQUIRED binding
attribute information
item as described below in 2.15.2.3 binding attribute
information item with endpoint [owner element].
An OPTIONAL address
attribute information
item as described below in 2.15.2.4 address attribute
information item with endpoint [owner element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information item amongst its [children], in order, as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation).
Zero or more element information items from among the following, in any order:
Zero or more feature
element information
items 2.7.2 XML Representation of
Feature Component
Zero or more property
element information
items 2.8.2 XML Representation
of Property Component
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl". Such element information items are considered to be endpoint extension elements as described below (see 2.15.2.5 Endpoint extension elements).
Note that EndpointType
, which is the XML Schema
[XML Schema: Structures]
complex type of the element information item
endpoint
as defined in the WSDL 2.0 schema, MAY be
used as the basis for defining new elements which can be used as
endpoint references in message exchanges. In the case that the
message contains a reference to an endpoint that implements a known
binding, an element whose type restricts the complex type
EndpointType
to have a fixed value for the
attribute information item binding
MAY be
used. To enable such reuse, the WSDL 2.0 schema defines the
attribute information item name
as optional
in complex type EndpointType
, while it is REQUIRED
for the element information item endpoint
as
indicated above.
Note:
See the primer [WSDL 2.0 Primer] for more information and examples.
name
attribute information item with endpoint
[owner element]The name
attribute information item
together with the targetNamespace
attribute
information item of the description
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.
binding
attribute information item with endpoint
[owner element]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.
address
attribute information item with endpoint
[owner element]The address
attribute information item
specifies the address of the endpoint.
The address
attribute information item has
the following Infoset properties:
A [local name] of address
A [namespace name] which has no value
The type of the address
attribute information
item is xs:anyURI.
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 from the XML representation to those properties.
The mapping from the XML Representation of the
endpoint
element information item (see
2.15.2 XML Representation of Endpoint
Component) to the properties of the Endpoint component (see
2.15.1 The Endpoint
Component) is as described in Table 2-15.
Property | Value |
---|---|
{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 (see 2.19 QName
resolution). |
{address} | The actual value of the
address attribute information item if
present, otherwise empty. |
{features} | The set of Features 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. |
{parent} | The Service component corresponding to
the service element information item in
[parent]. |
The XML Schema 1.0 simple types [XML Schema: Datatypes] used in this specification are:
xs:token
xs:NCName
xs:anyURI
xs:QName
xs:boolean
Two component instances of the same type are considered equivalent if, for each property of the first component, there is a corresponding property with an equivalent value on the second component, and the second component has no additional properties.
Instances of properties of the same type are considered equivalent if their values are equivalent.
For values of a simple type (see 2.16 XML Schema 1.0 Simple Types Used in the Component Model) this means that they contain the same values. For instance, two string values are equivalent if they contain the same sequence of Unicode characters, as described in [Character Model for the WWW]
Values which are references to other components are considered equivalent when they refer to equivalent components (as determined above).
List-based values are considered equivalent if they have the same length and their elements at corresponding positions are equivalent.
Finally, set-based values are considered equivalent if they contain corresponding equivalent values, without regard to order.
Extension properties which are not string values, sets of strings or references MUST describe their values' equivalence rules.
Because different top-level components (e.g., Interface, Binding and Service) are required to have different names, it is possible to determine whether two top-level components of a given type are equivalent by examining their {name} property.
This specification defines three symbol spaces, one for each top-level component type (Interface, Binding and Service).
Within a symbol space, all qualified names (that is, the {name} property) are unique. Between symbol spaces, the names 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 2.0 description, then six 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.
In its serialized form WSDL 2.0 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. The namespace name for a component is represented by
the value of the targetNamespace
attribute
information item of the [parent] description
element information item and the local name is represented
by the {name} property of the component.
QName references are resolved by looking in the appropriate
property of the Description 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 Description component would be inspected.
If the appropriate property of the Description component does not contain a component with the required QName then the reference is a broken reference. It is an error for a Description component to have such broken references.
This specification uses absolute URIs to identify several components (for example, features and properties) and components characteristics (for example, operation message exchange patterns and styles). When such absolute URIs are being compared to determine equivalence (see 2.17 Equivalence of Components) the URIs MUST be compared character-by-character as indicated in [TAG URI FINDING].
<description> <types> <documentation />? [extension elements]* </types> </description>
The content of messages and faults may be constrained using type system components. These constraints are based upon a specific data model, and expressed using a particular schema language.
Although a variety of data models can be accommodated (through WSDL 2.0 extensions), this specification only defines a means of expressing constraints based upon the XML Infoset [XML Information Set]. Furthermore, although a number of alternate schema languages can be used to constrain the XML Infoset (as long as they support the semantics of either inlining or importing schema), this specification only defines the use of XML Schema [XML Schema: Structures], [XML Schema: Datatypes].
Specifically, the {element declarations} and {type definitions} properties of the Description component are collections of imported and inlined schema components that describe Infoset element information items.
When extensions are used to enable the use of a non-Infoset data model, or a non-Schema constraint language, the wsdl:required attribute information item MAY be used to require support for that extension.
Note:
Support for the W3C XML Schema [XML Schema: Structures],[XML Schema: Datatypes] is required of all WSDL 2.0 processors (see 3.1 Using W3C XML Schema Description Language).
The schema components contained in the {element declarations}
property of 2.1.1 The Description
Component provide the type system used for Interface
Message Reference and Interface Fault components. Interface Message
Reference components indicate their structure and content by using
the standard attribute information items
element
, or for alternate schema languages in which
these concepts do not map well, by using alternative attribute
information item extensions. Interface Fault 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 Description
Component.
The schema components contained in the {type definitions} property of 2.1.1 The Description Component provide the type system used for constraining the values of properties described by Property components. Extensions in the form of attribute information items can be used to refer to constraints (type definitions or analogous constructs) described using other schema languages or type systems. Such components MAY appear in additional collection properties on 2.1.1 The Description Component.
The types
element information item
encloses data type definitions, based upon the XML Infoset, used to
define messages and has the following Infoset properties:
A [local name] of types
.
A [namespace name] of "http://www.w3.org/2005/05/wsdl".
Zero or more namespace qualified attribute information items whose [namespace name] is NOT http://www.w3.org/2005/05/wsdl
Zero or more element information items amongst its [children] as follows:
An OPTIONAL documentation
element information
item (see 5.
Documentation) in its [children] property.
Zero or more element information items from among the following, in any order:
xs:import
element information items
xs:schema
element information items
Other namespace qualified element information items whose namespace is NOT http://www.w3.org/2005/05/wsdl
XML Schema MAY be used as the schema language via import or inlining. All WSDL 2.0 processors MUST support XML Schema type definitions.
A WSDL 2.0 description MUST NOT refer to XML Schema components
in a given namespace unless an xs:import
and/or
xs:schema
statement for that namespace is present.
That is, using the xs:import
and/or
xs:schema
constructs is a necessary condition for
making XML Schema components available to a WSDL 2.0
description.
Table 3-1 summarize the visibility of schema components.
XML Representation | Visibility of XML Schema Components | |
---|---|---|
Including description | description/include | XML Schema components in the included Description component's {element declarations} and {type definitions} properties are visible. |
Importing description | description/import | None of the XML Schema Components in the imported Description component are visible. |
Importing XML Schema | description/xs:import | Element Declaration and Type Definition components in the imported namespace are visible. |
Inlined XML Schema | description/types/xs:schema | Element Declaration and Type Definition components in the inlined XML Schema are visible. |
Importing an XML Schema uses the syntax and semantics of the
xs:import
mechanism defined by XML Schema
[XML Schema:
Structures],[XML Schema:
Datatypes], with some additional restrictions. The
schema components defined in the imported namespace are available
for reference by QName (see 2.19 QName
resolution). Note that only components in the imported
namespace are available for reference in the WSDL 2.0 document.
A child element information item of the
types
element information item is defined
with the Infoset properties as follows:
A [local name] of "import".
A [namespace name] of "http://www.w3.org/2001/XMLSchema".
One or two attribute information items as follows:
A REQUIRED namespace
attribute information
item as described below.
An OPTIONAL schemaLocation
attribute
information item as described below.
namespace
attribute information itemThe namespace
attribute information item
defines the namespace of the element declarations and type
definitions imported from the referenced schema. The referenced
schema MUST contain a targetNamespace
attribute
information item on its xs:schema
element
information item and the values of these two attribute
information items MUST be identical. It is an error to import
a schema that does not have a targetNamespace
attribute information item on its xs:schema
element information item. Such schemas must first be
included (using xs:include
) in a schema that contains
a targetNamespace
attribute information item
on its xs:schema
element information item,
which can then be either imported or inlined in the WSDL 2.0
document.
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.
schemaLocation
attribute information itemThe 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] which has no value.
The type of the schemaLocation
attribute
information item is xs:anyURI.
It is an error if a QName is not resolved (see 2.19 QName resolution). When resolving
QNames references for schema definitions, the namespace MUST be
imported by the referring WSDL 2.0 document. If the namespace so
referenced is contained in an inline schema, it MAY be imported
without a schemaLocation
attribute, so long as the
inline schema has been resolved in the current component model.
Inlining an XML schema uses the existing top-level
xs:schema
element information item defined by
XML Schema [XML Schema:
Structures]. It may be viewed as simply cutting and
pasting an existing schema document to a location inside the types
element information item.
The schema components defined and declared in the inlined schema document are available to WSDL 2.0 for reference by QName (see 2.19 QName resolution). Note that only components defined and declared in the schema itself and components included by it via xs:include are available to WSDL 2.0. Specifically components that the schema imports via xs:import are NOT available to WSDL 2.0.
Similarly, components defined in an inlined XML schema are NOT
automatically made available to a WSDL 2.0 description that
imported (using wsdl:import
) the description that
inlines the schema (see 4.2 Importing
Descriptions for more details). For this reason, it is
recommended that XML schema documents intended to be shared across
several WSDL 2.0 descriptions be placed in separate documents and
imported using xs:import
, rather than inlined inside
a WSDL 2.0 document.
Inside an inlined XML schema, the xs:import
and
xs:include
element information items MAY be
used to refer to other XML schemas inlined in the same or other
WSDL 2.0 document, provided that an appropriate value, such as a
fragment identifier (see [XML Schema:
Structures] 4.3.1) is specified for their
schemaLocation
attribute information items.
For xs:import
, the schemaLocation
attribute is not required so long as the namespace has been
resolved in the current component model. The semantics of such
element information items are governed solely by the XML
Schema specification [XML Schema:
Structures].
Note: It is NOT an error to import two or more schemas from the
same targetNamespace
. It is the responsibility of the
underlying schema processor to sort out a coherent set of schema
components.
The xs:schema
element information item has
the following Infoset properties:
A [local name] of schema.
A [namespace name] of "http://www.w3.org/2001/XMLSchema".
A REQUIRED targetNamespace
attribute
information item, amongst its [attributes] as described
below.
Additional OPTIONAL attribute information items as
specified for the xs:schema
element information
item by the XML Schema specification.
Zero or more child element information items as
specified for the xs:schema
element information
item by the XML Schema specification.
targetNamespace
attribute information
itemThe targetNamespace
attribute information
item defines the namespace of the element declarations and
type definitions inlined in its [owner element]
xs:schema
element information item. WSDL 2.0
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] which has no value.
The type of the targetNamespace
attribute
information item is xs:anyURI.
Whether inlined or imported, the element declarations present in a schema may be referenced from an Interface Message Reference or Interface Fault component. Similarly, regardless of whether they are inlined or imported, the type definitions present in a schema may be referenced from a Property component.
A named, global xs:element
declaration may be
referenced from the element
attribute information
item of an input
, output
or
fault
element information item. The QName is
constructed from the targetNamespace
of the schema and
the value of the name
attribute information
item of the xs:element
element information
item. An element
attribute information
item MUST NOT refer to a global xs:simpleType
or
xs:complexType
definition.
A named, global xs:simpleType
or
xs:complexType
declaration may be referenced from the
constraint
attribute information item of
property
element information item. The QName
is constructed from the targetNamespace
of the schema
and the value of the name
attribute information
item of the xs:simpleType
or
xs:complexType
element information item. A
constraint
attribute information item MUST
NOT refer to a global xs:element
definition.
Since it is unreasonable to expect that a single schema language
can be used to describe all possible Interface Message Reference,
Fault and Property component contents and their constraints, WSDL
2.0 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 Interface
Message Reference and Interface Fault components or the constraint
for Property components. Depending upon the schema language used,
an element information item MAY be defined to allow
inlining, if and only if the schema language can be expressed in
XML.
A specification of extension syntax for an alternative schema
language MUST include the declaration of an element information
item, 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 Description Component
(and extensibility attributes) to hold the components of the
referenced type system. It is expected that additional
extensibility attributes for Message Reference, Interface Fault and
Property 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 examples reuse the {element declarations} property of
2.1.1 The Description
Component and the element
attribute
information items of the wsdl:input
,
wsdl:output
and wsdl:fault
element
information items.
This specification provides two mechanisms, described in this section, for modularizing WSDL 2.0 descriptions. These mechanisms help to make WSDL 2.0 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 2.0 components and NOT at the level of XML Information Sets or XML 1.0 serializations.
<description> <include location="xs:anyURI" > <documentation />? </include> </description>
The WSDL 2.0 include
element information
item allows for the separation of different components of a
service definition, belonging to the same target namespace, into
independent WSDL 2.0 documents which can be merged as needed.
The WSDL 2.0 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 2.0
descriptions that share a target namespace with the including
description. Components in the transitive closure of the included
WSDL 2.0 documents become part of the Description
component of the including WSDL 2.0 document. The included
components can be referenced by QName. Note that because all WSDL
2.0 descriptions have a target namespace, no-namespace includes
(sometimes known as “chameleon includes”) never occur in WSDL
2.0.
A mutual include is direct inclusion by one WSDL 2.0 document of another WSDL 2.0 document which includes the first. A circular include achieves the same effect with greater indirection (A includes B includes C includes A, for instance). Multiple inclusion of a single WSDL 2.0 document resolves to a single set of components. Mutual, multiple, and circular includes are explicitly permitted, and do not represent multiple redefinitions of the same components. Multiple inclusion of a single WSDL 2.0 document has the same meaning as including it only once. Processors are encouraged to keep track of the source of component definitions, so that multiple, mutual, and circular includes do not require establishing identity on a component-by-component basis.
The include
element information item
has:
A [local name] of include
.
A [namespace name] of "http://www.w3.org/2005/05/wsdl".
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED location
attribute information
item as described below in 4.1.1 location attribute
information item with include [owner element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information item amongst its [children], as follows:
An optional documentation
element information
item (see 5.
Documentation).
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
location
attribute information item with include
[owner element]The location
attribute information item
has the following Infoset properties:
A [local name] of location
.
A [namespace name] which has no value.
A location
attribute information item is
of type xs:anyURI
. Its actual value is the location
of some information about the namespace identified by the
targetNamespace
attribute information item of
the containing description
element information
item.
It is an error if the URI indicated by location
does not resolve to a WSDL 2.0 document.
The actual value of the targetNamespace
attribute information item of the included WSDL 2.0
document MUST match the actual value of the
targetNamespace
attribute information item of
the description
element information item
which is the [parent] of the include
element
information item.
<description> <import namespace="xs:anyURI" location="xs:anyURI"? > <documentation />? </import> </description>
Every top-level WSDL 2.0 component is associated with a target
namespace. On its ws:description
element
information item, WSDL 2.0 documents carries a
targetNamespace
attribute information item
that associates the document with a target namespace. This section
describes the syntax and mechanisms by which references may be made
from within a WSDL 2.0 document to components not within the
document's target namespace. In addition to this syntax, there is
an optional facility for suggesting the URI of a WSDL 2.0 document
containing definition components from that foreign target
namespace.
The WSDL 2.0 import
element information
item is modeled after the XML Schema xs:import
element information item (see [XML Schema: Structures], section 4.2.3
"References to schema components across namespaces"). The WSDL 2.0
ws:import
element information item identifies
namespaces used in foreign references. The existence of the WSDL
2.0 ws:import
element information item
signals that the WSDL 2.0 document may contain references to
foreign components. The ws:import
element
information item is therefore like a forward declaration for
other namespaces.
Using the import
element information item
is a necessary condition for making components from another
namespace available to a WSDL 2.0 document. That is, a WSDL 2.0
document can only refer to components in a namespace other than its
own target namespace if the WSDL 2.0 document contains an
import
element information item for that
foreign namespace.
This specification does not preclude repeating the
import
element information item for the same
value of the namespace
attribute information
item as long as they provide different values for the
location
attribute information item.
Repeating the import
element information item
for the same namespace
value MAY be used as a way to
provide alternate locations to find information about a given
namespace.
Furthermore, this specification DOES NOT require the
location
attribute information item to be
dereferenceable. If it is not dereferenceable then no information
about the imported namespace is provided by that
import
element information item. It is
possible that such lack of information can cause QNames in other
parts of a WSDL 2.0 Description component to become broken
references (see 2.19 QName
resolution). Such broken references are not errors of the
import
element information item but rather
QName resolution errors which must be detected as described in
2.19 QName resolution.
The import
element information item has
the following Infoset properties:
A [local name] of import
.
A [namespace name] of "http://www.w3.org/2005/05/wsdl".
One or more attribute information items amongst its [attributes] as follows:
A REQUIRED namespace
attribute information
item as described below in 4.2.1 namespace attribute
information item.
An OPTIONAL location
attribute information
item as described below in 4.2.2 location attribute
information item with import [owner element].
Zero or more namespace qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
Zero or more element information items amongst its [children], as follows:
An optional documentation
element information
item (see 5.
Documentation).
Zero or more namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl".
namespace
attribute information itemThe 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 2.0 document MAY contain qualified references
to WSDL 2.0 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 targetNamespace
attribute information item in the enclosing WSDL 2.0
document. If the location attribute in the import
element information item references a WSDL 2.0 document,
then the actual value of the namespace
attribute
information item MUST be identical to the actual value of the
targetNamespace
attribute information item in
the referenced WSDL 2.0 document.
location
attribute information item with import
[owner
element]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
. The actual value of the
location
attribute information item, if
present on a WSDL 2.0 import
element information
item, gives a hint as to where a serialization of a WSDL 2.0
document with definitions for the imported namespace may be
found.
The location
attribute information item is
optional. This allows WSDL 2.0 components to be constructed from
information other than serialized XML 1.0 or a WSDL 2.0 document.
It also allows the development of WSDL 2.0 processors that have
a prior (i.e., built-in) knowledge of certain
namespaces.
<documentation> [extension elements]* </documentation>
WSDL 2.0 uses the optional documentation
element information item as a container for human readable
and/or machine processable documentation. The content of the
element information item is arbitrary character
information items and element information items
("mixed" content in XML Schema[XML
Schema: Structures]). The documentation
element information item is allowed inside any WSDL 2.0
element information item.
The documentation
element information item
has:
A [local name] of documentation
.
A [namespace name] of "http://www.w3.org/2005/05/wsdl".
Zero or more attribute information items in its [attributes] property.
Zero or more child element information items in its [children] property.
Zero or more character information items in its [children] property.
In addition to extensibility implied by the Feature and Property components described above, the schema for WSDL 2.0 has a two-part extensibility model based on namespace-qualified elements and attributes. An extension is identified by the QName consisting of its namespace URI and its element name. The meaning of an extension SHOULD be defined (directly or indirectly) in a document that is available at its namespace URI.
WSDL 2.0 allows extensions to be defined in terms of element information items. Where indicated herein, WSDL 2.0 allows namespace-qualified element information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl" to appear among the [children] of specific element information items whose [namespace name] is "http://www.w3.org/2005/05/wsdl". Such element information items MAY be used to annotate WSDL 2.0 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 from the XML representation of the extension to the properties in the component model.
The WSDL 2.0 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".
Editorial note: TODO - Editorial comment ME29 | 20050503 |
Are you still using element substitution groups? |
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 2.0 specification. WSDL 2.0 recommends that specifications defining such protocols also define any necessary WSDL 2.0 extensions used to describe those protocols or formats.
Example 6-1. Base type for extensibility elements
<xs:complexType name='ExtensibilityElement' abstract='true' > <xs:attribute ref='wsdl:required' use='optional' /> </xs:complexType>
Extension elements can be marked as mandatory by annotating them
with a wsdl:required
attribute information
item (see 6.1.2 required attribute
information item) with a value of "true". A mandatory
extension is an extension that MAY change the meaning of the
element to which it is attached, such that the meaning of that
element is no longer governed by this specification. Instead, the
meaning of an element containing a mandatory extension is governed
by the meaning of that extension. Thus, the definition of the
element's meaning is delegated to the specification that
defines the extension.
An extension that is NOT marked as mandatory MUST NOT invalidate the meaning of any part of the WSDL 2.0 document. Thus, a NON-mandatory extension merely provides additional description of capabilities of the service. This specification does not provide a mechanism to mark extension attributes as being required. Therefore, all extension attributes are NON-mandatory.
Note:
A mandatory extension is considered mandatory because it has the ability to change the meaning of the element to which it is attached. Thus, the meaning of the element may not be fully understood without understanding the attached extension. A NON-mandatory extension, on the other hand, can be safely ignored without danger of misunderstanding the rest of the WSDL 2.0 document.
If a WSDL 2.0 document declares an extension, Feature or Property as optional (i.e., NON-mandatory), then the Web service MUST NOT assume that the client supports that extension, Feature or Property, unless the Web service knows (through some other means) that the client has in fact elected to engage and support that extension, Feature or Property.
Note:
A key purpose of an extension is to formally indicate (i.e., in a machine-processable way) that a particular feature or convention is supported or required. This enables toolkits that understand the extension to engage it automatically, while toolkits that do not yet understand a required extension may be able to flag it to an operator for manual support.
If a Web service requires the client to follow a particular convention that is likely to be automatable in WSDL 2.0 toolkits, then that convention SHOULD be indicated in the WSDL 2.0 document as a wsdl:required extension, rather than just being conveyed out of band, even if that convention is not currently implemented in WSDL 2.0 toolkits.
This practice will help prevent interoperability problems that could arise if one toolkit requires a particular convention that is not indicated in the WSDL 2.0 document, while another toolkit does not realize that that convention is required. It will also help facilitate future automatic processing by WSDL 2.0 toolkits.
On the other hand, a client MAY engage an extension, Feature or Property that is declared as optional in the WSDL 2.0 document. Therefore, the Web service MUST support every extension, Feature or Property that is declared as optional in the WSDL 2.0 document, in addition to supporting every extension, Feature or Property that is declared as mandatory.
Note:
If finer-grain, direction-sensitive control of extensions, Features or Properties is desired, then such extensions, Features or Properties may be designed in a direction-sensitive manner (from the client or from the Web service) so that either direction may be separately marked required or optional. For example, instead of defining a single extension that governs both directions, two extensions could be defined -- one for each direction.
required
attribute information itemWSDL 2.0 provides a global attribute information item with the following Infoset properties:
A [local name] of required
.
A [namespace name] of "http://www.w3.org/2005/05/wsdl".
A [specified] property with a value of "true".
The type of the required
attribute information
item is xs:boolean.
WSDL 2.0 allows qualified attribute information items whose [namespace name] is NOT "http://www.w3.org/2005/05/wsdl" to appear on any element information item whose namespace name IS "http://www.w3.org/2005/05/wsdl". Such attribute information items can be used to annotate WSDL 2.0 constructs such as interfaces, bindings, etc.
WSDL 2.0 does not provide a mechanism for marking extension attribute information items as mandatory.
As indicated above, it is expected that the presence of extensibility elements and attributes will result in additional properties appearing in the component model.
The presence of an optional extensibility element or attribute MAY therefore augment the semantics of a WSDL 2.0 document in ways that do not invalidate the existing semantics. However, the presence of a mandatory extensibility element MAY alter the semantics of a WSDL 2.0 document in ways that invalidate the existing semantics.
Extensibility elements SHOULD NOT alter the existing semantics in ways that are likely to confuse users.
Note:
However, once the client and service both know that an optional feature has been engaged (because the service has received a message explicitly engaging that feature, for example), then the semantics of that feature supercede what the WSDL 2.0 document indicated. For example, the WSDL 2.0 document may have specified an XML message schema to be used, but also indicated an optional security feature that encrypts the messages. If the security feature is engaged, then the encrypted messages will no longer conform to the specified message schema (until they are decrypted).
Note:
Authors of extensibility elements should make sure to include in the specification for such elements a clear statement of the requirements for document conformance (see 1.2 Document Conformance).
As an XML vocabulary, WSDL documents, WSDL fragments or
references to WSDL components -via QNames- MAY appear within other
XML documents. This specification defines a global attribute,
wsdlLocation
, to help with QName resolution (see
2.19 QName resolution). This
attribute allows an element that contains such references to be
annotated to indicate where the WSDL for a namespace (or set of
namespaces) can be found. In particular, this attribute is expected
to be useful when using service references in message
exchanges.
The wsdlLocation
global attribute is defined in the
namespace "http://www.w3.org/2005/05/wsdl-instance" (hereafter
referred to as "wsdli:wsdlLocation", for brevity). This attribute
MAY appear on any XML element which allows attributes from other
namespaces to occur. It MUST NOT appear on a
wsdl:description
element or any of its
children/descendants.
A normative XML Schema [XML Schema: Structures], [XML Schema: Datatypes] document for the "http://www.w3.org/2005/05/wsdl-instance" namespace can be found at http://www.w3.org/2005/05/wsdl-instance.
wsdli:wsdlLocation
attribute information
itemWSDL 2.0 provides a global attribute information item with the following Infoset properties:
A [local name] of wsdlLocation
.
A [namespace name] of "http://www.w3.org/2005/05/wsdl-instance".
The type of the wsdlLocation
attribute
information item is a list xs:anyURI. Its actual
value MUST be a list of pairs of URIs; where the first URI of a
pair, which MUST be an absolute URI as defined in [IETF RFC 3986], indicates a WSDL 2.0
namespace name, and, the second a hint as to the location of a WSDL
2.0 document defining WSDL 2.0 components for that namespace name.
The second URI of a pair MAY be absolute or relative.
This specification conforms to the [XML Information Set]. The following information items MUST be present in the input Infosets to enable correct processing of WSDL 2.0 documents:
Document Information Items with [children] and [base URI] properties.
Element Information Items with [namespace name], [local name], [children], [attributes], [base URI] and [parent] properties.
Attribute Information Items with [namespace name], [local name] and [normalized value] properties.
Character Information Items with [character code], [element content whitespace] and [parent] properties.
<description targetNamespace="xs:anyURI" > <documentation />? <import namespace="xs:anyURI" location="xs:anyURI"? > <documentation />? </import>* <include location="xs:anyURI" > <documentation />? </include>* <types> <documentation />? </types> <interface name="xs:NCName" extends="list of xs:QName"? styleDefault="list of xs:anyURI"? > <documentation />? <fault name="xs:NCName" element="xs:QName"? > <documentation />? <feature ... />* <property ... />* </fault>* <operation name="xs:NCName" pattern="xs:anyURI" style="list of xs:anyURI"? safe="xs:boolean"? > <documentation />? <input messageLabel="xs:NCName"? element="union of xs:QName, xs:token"? > <documentation />? <feature ... />* <property ... />* </input>* <output messageLabel="xs:NCName"? element="union of xs:QName, xs:token"? > <documentation />? <feature ... />* <property ... />* </output>* <infault ref="xs:QName" messageLabel="xs:NCName"? > <documentation />? <feature ... />* <property ... />* </infault>* <outfault ref="xs:QName" messageLabel="xs:NCName"? > <documentation />? <feature ... />* <property ... />* </outfault>* <feature ... />* <property ... />* </operation>* <feature uri="xs:anyURI" required="xs:boolean"? > <documentation />? </feature>* <property uri="xs:anyURI" > <documentation />? <value> xs:anyType </value>? <constraint> xs:QName </constraint>? </property>* </interface>* <binding name="xs:NCName" interface="xs:QName"? type="xs:anyURI" > <documentation />? <fault ref="xs:QName" > <documentation />? <feature ... />* <property ... />* </fault>* <operation ref="xs:QName" > <documentation />? <input messageLabel="xs:NCName"? > <documentation />? <feature ... />* <property ... />* </input>* <output messageLabel="xs:NCName"? > <documentation />? <feature ... />* <property ... />* </output>* <infault ref="xs:QName" messageLabel="xs:NCName"? > <documentation />? <feature ... />* <property ... />* </infault>* <outfault ref="xs:QName" messageLabel="xs:NCName"? > <documentation />? <feature ... />* <property ... />* </outfault>* <feature ... />* <property ... />* </operation>* <feature ... />* <property ... />* </binding>* <service name="xs:NCName" interface="xs:QName" > <documentation />? <endpoint name="xs:NCName" binding="xs:QName" address="xs:anyURI"? > <documentation />? <feature ... />* <property ... />* </endpoint>* <feature ... />* <property ... />* </service>* </description>
This appendix defines the "application/wsdl+xml" media type which can be used to describe WSDL 2.0 documents serialized as XML. It is referenced by the corresponding IANA registration document [WSDL MediaType], which is being submitted to the IESG for review, approval and registration with IANA.
application
wsdl+xml
none
This parameter has identical semantics to the charset parameter of the "application/xml" media type as specified in [RFC 3023].
Identical to those of "application/xml" as described in [RFC 3023], section 3.2, as applied to the WSDL document Infoset.
See section A.3 Security considerations.
There are no known interoperability issues.
This document and [WSDL 2.0 Adjuncts].
No known applications currently use this media type.
wsdl
Either a syntax identical to that of "application/xml" as described in [RFC 3023], section 5 or the syntax defined in A.2 Fragment Identifiers.
As specified in [RFC 3023], section 6.
WSDL
World Wide Web Consortium <web-human@w3.org>
COMMON
The WSDL 2.0 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.
This section defines a fragment identifier syntax for identifying components of a WSDL 2.0 document. This fragment identifier syntax is compliant with the [XPointer Framework].
A WSDL 2.0 fragment identifier consists of zero or more xmlns pointer parts followed by a pointer part as defined below. The pointer parts have a scheme name that corresponds to one of the standard WSDL 2.0 component types, and scheme data that is a path composed of names that identify the components. The scheme names all begin with the prefix "wsdl." to avoid name conflicts with other schemes. The names in the path are of type either QName, NCName, URI, or Pointer Part depending on the context.
For QNames, any prefix MUST be defined by a preceding xmlns pointer part. If a QName does not have a prefix then its namespace name is the target namespace of the WSDL 2.0 document.
The fragment identifier is typically constructed from the {name} property of the component and the {name} properties of its ancestors as a path according to Table A-1. The first column of this table gives the name of the WSDL 2.0 component. Columns labelled 1 through 4 specify the identifiers that uniquely identify the component within its context. Identifiers are typically formed from the {name} property, although in several cases references to other components are used. These identifiers are then used to construct the pointer part in the last column.
Component | 1 | 2 | 3 | 4 | Pointer Part |
---|---|---|---|---|---|
Interface | interface
NCName |
n/a | n/a | n/a | wsdl.interface(interface) |
Interface Fault | interface
NCName |
fault NCName |
n/a | n/a | wsdl.interfaceFault(interface/fault) |
Interface Operation | interface
NCName |
operation
NCName |
n/a | n/a | wsdl.interfaceOperation(interface/operation) |
Interface Message Reference | interface
NCName |
operation
NCName |
message
NCName |
n/a | wsdl.interfaceMessageReference(interface/operation/message) |
Interface Fault Reference | interface
NCName |
operation
NCName |
message
NCName |
fault QName |
wsdl.interfaceFaultReference(interface/operation/message/fault) |
Binding | binding
NCName |
n/a | n/a | n/a | wsdl.binding(binding) |
Binding Fault | binding
NCName |
fault QName |
n/a | n/a | wsdl.bindingFault(binding/fault) |
Binding Operation | binding
NCName |
operation
QName |
n/a | n/a | wsdl.bindingOperation(binding/operation) |
Binding Message Reference | binding
NCName |
operation
QName |
message
NCName |
n/a | wsdl.bindingMessageReference(binding/operation/message) |
Binding Fault Reference | binding
NCName |
operation
QName |
fault QName |
message
NCName |
wsdl.bindingFaultReference(binding/operation/fault/message) |
Service | service
NCName |
n/a | n/a | n/a | wsdl.service(service) |
Endpoint | service
NCName |
endpoint
NCName |
n/a | n/a | wsdl.endpoint(service/endpoint) |
Feature | parent Pointer
Part |
feature URI |
n/a | n/a | wsdl.feature(parent/feature) |
Property | parent Pointer
Part |
property URI |
n/a | n/a | wsdl.property(parent/property) |
WSDL 2.0 is extensible and it is possible for an extension to define new components types. The XPointer Framework scheme for extension components is:
wsdl.extension(extension-namespace,
extension-specific-syntax)
Note that the above rules are defined in terms of component properties rather than the XML Infoset representation of the component model. The following sections specify in detail how the pointer parts are constructed from the component model.
wsdl.interface(interface)
interface
is the local name of the {name}
property of the Interface component.
wsdl.interfaceFault(interface/fault)
interface
is the local name of the {name}
property of the parent Interface
component.
fault
is the local name of the {name}
property of the Interface Fault
component.
wsdl.interfaceOperation(interface/operation)
interface
is the local name of the {name}
property of the parent Interface
component.
operation
is the local name of the {name}
property of the Interface
Operation component.
wsdl.interfaceMessageReference(interface/operation/message)
interface
is the local name of the {name}
property of the grandparent Interface
component.
operation
is the local name of the {name}
property of the parent Interface
Operation component.
message
is the {message label} property of
the Interface Message Reference component.
wsdl.interfaceFaultReference(interface/operation/message/fault)
interface
is the local name of the {name}
property of the grandparent Interface
component.
operation
is the local name of the {name}
property of the parent Interface
Operation component.
message
is the {message label} property of
the Interface Fault
Reference component.
fault
is the {name} property of the
Interface Fault component referred to
by the {interface fault} property of the InterfaceFault Reference
component.
wsdl.binding(binding)
binding
is the local name of the {name}
property of the Binding component.
wsdl.bindingFault(binding/fault)
binding
is the local name of the {name}
property of the parent Binding
component.
fault
is the {name} property of the
Interface Fault component referred to
by the {interface fault} property of the Binding Fault component.
wsdl.bindingOperation(binding/operation)
binding
is the local name of the {name}
property of the parent Binding
component.
operation
is the {name} property of the
Interface Operation component
referred to by the {interface operation} property of the Binding Operation component.
wsdl.bindingMessageReference(binding/operation/message)
binding
is the local name of the {name}
property of the grandparent Binding
component.
operation
is the {name} property of the
Interface Operation component
referred to by the {interface operation} property of the parent
Binding Operation component.
message
is the {message label} property of
the Interface Message
Reference component referred to by the {interface message
reference} property of the Binding Message Reference
component.
wsdl.bindingFaultReference(binding/operation/fault/message)
binding
is the local name of the {name}
property of the grandparent Binding
component.
operation
is the {name} property of the
Interface Operation component
referred to by the {interface operation} property of the parent
Binding Operation component.
fault
is the {name} property of the
Interface Fault component referred to
by the {interface fault} property of the Interface Fault Reference component
referred to by the {interface fault reference} property of the
Binding Fault Reference
component.
message
is the {message label} property of
the Interface Fault Reference component referred to by the
{interface fault reference} property of the Binding Fault Reference
component.
wsdl.service(service)
service
is the local name of the {name}
property of the Service component.
wsdl.feature(parent/feature)
parent
is the pointer part of the parent
component.
feature
is the {uri} property of the
Feature component.
wsdl.property(parent/property)
parent
is the pointer part of the parent
component.
property
is the {uri} property of the
Property component.
wsdl.extension(extension-namespace,
extension-specific-syntax)
extension-namespace
is the namespace that
identifies the extension, e.g. for the WSDL 2.0 SOAP 1.2 Binding
the namespace is http://www.w3.org/2005/05/wsdl/soap.
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.
This media type uses the "+xml" convention, it shares the same security considerations as described in [RFC 3023], section 10.
This document is the work of the W3C Web Service Description Working Group.
Previous editors of this document were:
Martin Gudgin, Microsoft
Jeffrey Schlimmer, Microsoft
Members of the Working Group are (at the time of writing, and by alphabetical order): Rebecca Bergersen (IONA Technologies), Allen Brookes (Rogue Wave Softwave), Dave Chappell (Sonic Software), Helen Chen (Agfa-Gevaert N. V.), Roberto Chinnici (Sun Microsystems), Kendall Clark (University of Maryland), Ugo Corda (SeeBeyond), Glen Daniels (Sonic Software), Paul Downey (British Telecommunications), Youenn Fablet (Canon), Martin Gudgin (Microsoft Corporation), Hugo Haas (W3C), Tom Jordahl (Macromedia), Anish Karmarkar (Oracle Corporation), Jacek Kopecky (DERI Innsbruck at the Leopold-Franzens-Universität Innsbruck, Austria), Amelia Lewis (TIBCO Software, Inc.), Michael Liddy (Education.au Ltd.), Kevin Canyang Liu (SAP AG), Jonathan Marsh (Microsoft Corporation), Josephine Micallef (SAIC - Telcordia Technologies), Jeff Mischkinsky (Oracle Corporation), Dale Moberg (Cyclone Commerce), Jean-Jacques Moreau (Canon), Mark Nottingham (BEA Systems, Inc.), David Orchard (BEA Systems, Inc.), Bijan Parsia (University of Maryland), Tony Rogers (Computer Associates), Arthur Ryman (IBM), Adi Sakala (IONA Technologies), Igor Sedukhin (Computer Associates), Asir Vedamuthu (webMethods, Inc.), Sanjiva Weerawarana (Independent), Ümit Yalçınalp (SAP AG).
Previous members were: Lily Liu (webMethods, Inc.), Don Wright (Lexmark), Joyce Yang (Oracle Corporation), Daniel Schutzer (Citigroup), Dave Solo (Citigroup), Stefano Pogliani (Sun Microsystems), William Stumbo (Xerox), Stephen White (SeeBeyond), Barbara Zengler (DaimlerChrysler Research and Technology), Tim Finin (University of Maryland), Laurent De Teneuille (L'Echangeur), Johan Pauhlsson (L'Echangeur), Mark Jones (AT&T), Steve Lind (AT&T), Sandra Swearingen (U.S. Department of Defense, U.S. Air Force), Philippe Le Hégaret (W3C), Jim Hendler (University of Maryland), Dietmar Gaertner (Software AG), Michael Champion (Software AG), Don Mullen (TIBCO Software, Inc.), Steve Graham (Global Grid Forum), Steve Tuecke (Global Grid Forum), Michael Mahan (Nokia), Bryan Thompson (Hicks & Associates), Ingo Melzer (DaimlerChrysler Research and Technology), Sandeep Kumar (Cisco Systems), Alan Davies (SeeBeyond), Jacek Kopecky (Systinet), Mike Ballantyne (Electronic Data Systems), Mike Davoren (W. W. Grainger), Dan Kulp (IONA Technologies), Mike McHugh (W. W. Grainger), Michael Mealling (Verisign), Waqar Sadiq (Electronic Data Systems), Yaron Goland (BEA Systems, Inc.), Ümit Yalçınalp (Oracle Corporation), Peter Madziak (Agfa-Gevaert N. V.), Jeffrey Schlimmer (Microsoft Corporation), Hao He (The Thomson Corporation), Erik Ackerman (Lexmark), Jerry Thrasher (Lexmark), Prasad Yendluri (webMethods, Inc.), William Vambenepe (Hewlett-Packard Company), David Booth (W3C), Sanjiva Weerawarana (IBM).
The people who have contributed to discussions on www-ws-desc@w3.org are also gratefully acknowledged.
This appendix provides a syntax for URI references for all components found in a WSDL 2.0 document. The URI references are easy to understand and compare, while imposing no burden on the WSDL 2.0 author.
There are two main cases for WSDL 2.0 URIs:
the URI of a WSDL 2.0 document
the URI of a WSDL 2.0 namespace
The URI of a WSDL 2.0 document can be dereferenced to give a resource representation that contributes component definitions to a single WSDL 2.0 namespace. If the media type is set to the WSDL 2.0 media type, then the fragment identifiers can be used to identify the main components that are defined in the document.
However, in keeping with the recommendation in 2.1.1 The Description Component that the namespace URI be dereferencible to a WSDL 2.0 document, this appendix specifies the use of the namespace URI with the WSDL 2.0 fragment identifiers to form a URI-reference.
The URI in a URI-reference for a WSDL 2.0 component is the namespace name of the {name} property of either the component itself, in the case of Interface, Binding, and Service components, or the {name} property of the ancestor component. The URI provided by the namespace name of the {name} property is combined with a fragment identifier as defined in A.2 Fragment Identifiers.
Consider the following WSDL 2.0 document located at http://example.org/TicketAgent.wsdl:
Example C-1. URI References - Example WSDL 2.0 Document
<?xml version="1.0" encoding="UTF-8"?> <wsdl:description targetNamespace="http://example.org/TicketAgent.wsdl20" xmlns:xsTicketAgent="http://example.org/TicketAgent.xsd" xmlns:wsdl="http://www.w3.org/2005/05/wsdl" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.w3.org/2005/05/wsdl http://www.w3.org/2005/05/wsdl/wsdl20.xsd"> <wsdl:types> <xs:import schemaLocation="TicketAgent.xsd" namespace="http://example.org/TicketAgent.xsd" /> </wsdl:types> <wsdl:interface name="TicketAgent"> <feature uri="http://example.com/secure-channel" required="true"/> <wsdl:operation name="listFlights" pattern="http://www.w3.org/2005/05/wsdl/in-out"> <wsdl:input element="xsTicketAgent:listFlightsRequest"/> <wsdl:output element="xsTicketAgent:listFlightsResponse"/> </wsdl:operation> <wsdl:operation name="reserveFlight" pattern="http://www.w3.org/2005/05/wsdl/in-out"> <wsdl:input element="xsTicketAgent:reserveFlightRequest"/> <wsdl:output element="xsTicketAgent:reserveFlightResponse"/> </wsdl:operation> </wsdl:interface> </wsdl:description>
Its components have the following URI-references:
Example C-2. URI References - Example URIs
http://example.org/TicketAgent.wsdl20#wsdl.interface(TicketAgent) http://example.org/TicketAgent.wsdl20#wsdl.feature(wsdl.interface(TicketAgent)/http://example.com/secure-channel) http://example.org/TicketAgent.wsdl20#wsdl.operation(TicketAgent/listFlights) http://example.org/TicketAgent.wsdl20#wsdl.operation(TicketAgent/reserveFlight)
This section will attempt to document some of the migration concerns of going from WSDL 1.1 to WSDL 2.0. We do not claim that all migration problems will be addressed here.
WSDL 2.0 requires that within a service, all endpoints (called ports in WSDL 1.1) implement exactly the same interface (called portType in WSDL 1.1). WSDL 1.1 imposed no such restriction. WSDL 1.1 documents could contain ports, from the same service, that implemented differents portTypes. Such WSDL 1.1 documents must therefore be converted, before they are valid WSDL 2.0 documents. Note: other types of conversions may also be required, because of other differences between WSDL 2.0 and WSDL 1.1. These differences are not considered further in this section.
To convert a WSDL 1.1 document that contains ports from the same service that implement different portTypes, one must first move each portType implementing a different port to a new service. The new service is a replica of the original service, apart from the fact that it implements a different set of portTypes.
Is is then generally desirable to indicate that the new services are related to each other. This can be achieved by using one of the following alternatives:
Single document. Keep the new services under the same
definition
element information item.
Multiple documents, same targetNamespace. Split the new
services over multiple WSDL 2.0 documents, each with the same
targetNamespace
.
Multiple documents, same endpoint. Split the new services
in multiple WSDL 2.0 documents, each with the same
endpoint
. Note that this provides a looser coupling
that the targetNamespace
alternative above.
Extension. Use a WSDL 2.0 extension whose semantics would
be to link the new services together. This is somewhat analoguous
to the targetNamespace
approach above, although such
an extension may carry additional semantics. The definition of such
an extension is outside the scope of this specification.
A DTD may be used as the schema language for WSDL 2.0. It may
not be inlined; it must be imported. A namespace must be assigned.
DTD types appear in the {element declarations} property of 2.1.1 The Description Component
and may be referenced from the wsdl:input
,
wsdl:output
and wsdl:fault
elements using
the element
attribute information item.
The prefix, dtd, used throughout the following is mapped to the namespace URI "http://www.w3.org/2005/05/wsdl/dtd-import".
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.w3.org/2005/05/wsdl/dtd-import".
One or two attribute information items, as follows:
A REQUIRED namespace
attribute information
item as described below.
An OPTIONAL location
attribute information
item as described below.
namespace
attribute information itemThe 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] which has no value.
The type of the namespace
attribute information
item is xs:anyURI.
The WSDL 2.0 author should ensure that a prefix is associated with the namespace at the proper scope (probably document scope).
location
attribute information itemThe 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] which has no value.
The type of the location
attribute information
item is xs:anyURI.
The element
attribute information item
MUST be used when referring to an element definition
(<!ELEMENT>) from a Message Reference component; referring to
an element definition from an Interface Fault 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.
A RELAX NG schema may be used as the schema language for WSDL
2.0. It may be inlined 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 definitions and element declarations, the latter
appears in the {element declarations} property of 2.1.1 The Description Component
respectively. The following discussion supplies the prefix rng
which is mapped to the URI
"http://www.relaxng.org/ns/structure/1.0".
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 REQUIRED ns
attribute information item
as described below.
An OPTIONAL href
attribute information
item as described below.
Additional attribute information items as defined by the RNG specification.
Note that WSDL 2.0 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.
ns
attribute
information itemThe 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.
href
attribute
information itemThe href
attribute information item must
be present, according to the rules of the RNG specification.
However, WSDL 2.0 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] which has no value.
The type of the href
attribute information
item is xs:anyURI.
Inlining 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".
A REQUIRED 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.
ns
attribute
information itemThe ns
attribute information item defines
the namespace of the type and element definitions inlined in this
schema. WSDL 2.0 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] which has no value.
The type of the ns
attribute information
item is xs:anyURI.
Whether inlined or imported, the element definitions present in a schema may be referenced from an Interface Message Reference or Interface Fault component.
A named rng:define definition MUST NOT be referenced from the Message Reference or Interface Fault components.
A named Relax NG element declaration MAY be referenced from a
Message Reference or Interface Fault 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.
Date | Author | Description |
---|---|---|
20050504 | JJM | Rewrote the "Operation Name Mapping Requirement" section to make it best practice. |
20050504 | JJM | Removed empty subsections in "XML Schema 1.0 Simple..." |
20050504 | JJM | Rewrote the "Single Interface" section, as per editorial AI dated 2005-01-19. |
20050503 | JJM | Rewrote the ONMR as Best practice. |
20050503 | JJM | LC112: Implemented resolution for issue LC112. |
20050503 | JJM | Completed editorial action LC78. |
20050501 | AGR | LC120: Clarified description of include and import, removed contradictions, and added references to QName resolution. |
20050501 | AGR | LC116:
Clarified that schemaLocation is not required if the
namespace has been resolved in the component model. Replaced the
term "embedded schema" with "inlined schema" throughout. |
20050501 | AGR | LC89m: Made all top-level components behave the same under include and import. |
20050501 | AGR | LC89f: Added statement on XML document conformance. |
20050501 | AGR | LC74: Refer to WSDL 2.0 explicitly throughout. In particular, only imports and includes of WSDL 2.0 documents are allowed. |
20050501 | AGR | LC99: Added #other to {message content model} property of Interface Message Reference component, and to WSDL schema. |
20050501 | AGR | LC125: Renamed components Fault Reference -> Interface Fault Reference, Message Reference -> Interface Message Reference, and the corresponding properities. |
20050430 | AGR | LC117: Added use of EndpointType for endpoint references. |
20050429 | AV | LC96 and LC120: Modified section 4.2 to align wsdl:import with xs:import. |
20050429 | RRC | LC75w: Removed "is not dereferenceable or" from section 4.1.1 and removed references to a WSDL processor. |
20050429 | RRC | Added clarification that an operation style MAY affect only input or only output messages (or any other combination). |
20050421 | AGR | LC81 : Added constraints to ensure the component model can be serialized as a WSDL 2.0 XML Infoset. In the Interface component, the declared Interface Faults and Operations MUST have the same namespace as the Interface. |
20050418 | RRC | LC115: Moved document conformance section after 1.1. |
20050418 | RRC | LC89g: Replaced incorrect references to the [owner] Infoset property with the correct [owner element]. |
20050417 | AGR | LC107
: Use a consistent naming convention for properties that refer to
components. Make the property name match the component name as
follows:
|
20050417 | AGR | LC34b : Added the constraint that the {uri} property of a Feature or Property component within a {features} or {properties} property MUST be unique. |
20050416 | AGR | LC105 : Added {parent} property to nested components. |
20050416 | AGR | Moved the fragment identifer definition into the media registration appendix. |
20050414 | JJM | Fixed XML Schema P1/P2 version listed in the bibliograpy section. |
20050413 | AGR | LC87 : Improved clarity of the decription of Component Designators in Appendix C. |
20050407 | JJM | Reworded the introduction for wsdlLocation, as per LC26 resolution. |
20050407 | JJM | Moved paragraphs 6-9 of section 2.1.1 into 2.1.2. |
20050331 | AGR | LC113 : In the Feature and Property Composition sections, the in-scope components for Binding Operation, Binding Fault, Binding Message Reference, and Binding Fault Reference should include those of the corresponding Interface Operation, Interface Fault, Message Reference, and Fault Reference, respectively. Also updated specification references use Part 2: Adjuncts, and corrected validation errors. |
20050320 | AGR | LC104: The operations, faults, features, and properties of an Interface component are those defined directly on the component and do not include those from the extended interfaces. |
20050320 | AGR | Rename Z Notation versions as wsdl20-z.html and wsdl20-z-ie-html. |
20050315 | AGR | Hide Z Notation in the Normative version of the spec. |
20050314 | AGR | Removed section on RPC Style so it can be included in Adjuncts. |
20050310 | AGR | Fixed minor Binding Operation errors introduced by addition of Binding Message Reference. |
20050310 | JJM | Replaced schema visibility table with Asir's revised version. |
20050309 | AGR | Fixed minor Z typechecking errors introduced by addition of Binding Message Reference. Kudos to RRC for updating the Z Notation! |
20050301 | RRC | LC55: added Binding Fault Reference component and updated the definition of the Binding Message Reference component to be in sync with it, per issue resolution. |
20050301 | RRC | LC51: added Fault Reference component to the feature composition section; added mapping of {type definitions} property of the Description component from the XML representation. |
20050301 | RRC | LC48a, LC49: implemented resolutions. |
20050228 | JJM | X and Y: Added note clarifying extensibility semantics. |
20050228 | JJM | X: Added note clarifying extensibility semantics. |
20050228 | JJM | X: Added text on the meaning of a service description. |
20050218 | RRC | Replaced "provider agent" with "Web service" and "requester agent" with "client" (resolution of LC30). |
20050218 | RRC | Moved section on the operation name mapping requirement to section 2.13 (resolution of LC8). |
20050218 | RRC | Implemented resolution of LC5h. |
20050220 | AGR | Refactored Feature and Property Z Notation in preparation for formalization of composition model. |
20050220 | AGR | LC27: Partial Resolution from 2005-01-19: value sets intersect. Resolve Property Composition Edge Cases by requiring the conjunction of all constraints to apply. The composed value of a Property is intersection of the value set of each in-scope Property. |
20050220 | AGR | LC20: Partial Resolution from 2005-01-19: "true" trumps. Resolve Feature Composition Edge Cases by requiring the conjunction of all constraints to apply. The composed value of a Feature is "true" if and only if at least one in-scope value of the Feature is "true". |
20050220 | AGR | LC75i: At least one of the [children] of an Operation MUST be an "input" or "output". Agree to remove "infault" and "outfault" from the list since it does not make sense to have an Operation with only faults. |
20050220 | AGR | Completed Action Item - 2005-02-10: DBooth to mail Arthur change to wording on media type registration, Arthur to incorporate. |
20050217 | JJM | LC75s: Add table indicating the visibility of schema components. |
20050217 | JJM | LC52a: Indicate included components also belong to the same target namespace, as per Jacek original suggestion. |
20050216 | JJM | LC60: Indicate it is OK to embed 2 schemas from the same targetNS. |
20050216 | JJM | LC75t: Remove the restriction that wsdl:include cannot be transitive. |
20050216 | JJM | LC91: Fixed wording regarding importing schema and effect on WSDL components. |
20050211 | AGR | email: Added an informative reference to WS-Addressing and refered to it from the Operation Name Mapping Requirement. |
20050210 | AGR | email: Corrected WSDL Media Type Registration as per David Booth's email. |
20050209 | AGR | Editorial: Combine {name} NCName and {target namespace} URI properties into a single {name} QName property. |
20050121 | AGR | LC75l LC103: Make {message label} property of Binding Message Reference component REQUIRED and fix up XML mapping table. />. |
20050121 | AGR | LC75 LC89b LC89c: Drop support for XML 1.1, drop wsdls types, and use XSD 1.0 types. />. |
20050120 | AGR | LC73 LC75n: Added D.4 Single Interface per Service. |
20050119 | AGR | Editorial improvements to Z Notation. Added referential integrity constraints. |
20050118 | AGR | Edited Notational Conventions and References sections. Added character entity references for accented characters. |
20050117 | AGR | Edited table markup to simplify PDF generation. |
20041231 | AGR | Added reference to non-normative IE version of the specification. |
20041227 | AGR | Added reference to non-normative DHTML version of the specification. |
20041218 | AGR | LC34a: Refer to "Appendix C - URI References for WSDL Components" whenever a component cannot be referred to by QName . |
20041126 | AGR | LC43: Rename <definitions> to <description>. |
20041102 | HH | LC38: Using real URI for DTD import |
20041024 | AGR | Added initial Z Notation for component model. |
20040930 | AGR | LC6d: Revised Appendix C, URI References. |
20040929 | AGR | LC34b, LC34c, LC34d: Revised Appendix C, URI References. |
20040802 | RRC | Removed paragraph added per resolution of issue 211 (undone per action item 5 of the 2004-07-29 concall). |
20040802 | RRC | Added clarification on the meaning of required language extensions. |
20040802 | RRC | Added operation name requirement to the Interface component section. |
20040802 | RRC | Added introductory text for the Property Component (per action item 2 of the 2004-07-29 concall). |
20040727 | RRC | Made the Property component independent of XML Schema (issue 248). |
20040727 | SW | Issue 243 text |
20040727 | SW | Incorporated Paul's words for issue 235 |
20040727 | SW | Added MarkN's text for issue 211 |
20040727 | SW | Added note to processor conf rules for optional extensions and features about what optional means. |
20040727 | SW | Removed contentious area ed note thing per decision to do those via minority opinions. |
20040722 | HH | Defined wsdls:int for http:code. |
20040721 | RRC | Made almost all set-valued properties optional and added a rule to default them to the empty set, per agenda item 7 of 2004-07-15 concall. |
20040715 | RRC | Marked the {message label} property of the Message Reference and Fault Reference components as required. |
20040715 | RRC | Made the {style} property into a set of xs:anyURI. |
20040714 | RRC | Added definition of simple types used by the component model (issue 177). |
20040713 | RRC | Added clarification to interface extensions per issue 220. |
20040713 | RRC | Added clarification to Binding Operation section (issue 227). |
20040713 | RRC | Fixed references to Interface Fault components in the Fault Reference component section. |
20040713 | RRC | Added description of pseudo-schema syntax. |
20040714 | SW | Made f&p allowed in the remaining places and updated composition rules |
20040713 | SW | Added negative conformance criteria: not required to process XML1.1 etc. |
20040713 | SW | Corrected reference to frag ID syntax to for issue 209 |
20040713 | SW | Implemented Jonathan's proposal for issue 160. |
20040713 | SW | Put ednote in contentious areas asking for extra feedback. |
20040712 | RRC | Marked all component model properties as REQUIRED or OPTIONAL (issue 213). |
20040712 | RRC | Added definition for equivalence of list-typed values. |
20040712 | RRC | Clarified RPC style rules for one-way operations (issue 215). |
20040708 | JJM | Finished adding clarifications for non-XML type system extensibility. |
20040708 | JJM | Include the definition of "actual value" from XML Schema (Issue 219). |
20040708 | JJM | Added resolution to issue 218 (2004Jun/0276.html, including Mark's amendment). |
20040708 | JJM | Component equivalence (2004Jun/0195.html, 2004Jun/0199.html and ref to the charmod [Issue 210]). |
20040706 | RRC | Added clarifications for non-XML type system extensibility. |
20040706 | RRC | Expanded component model definition. |
20040706 | RRC | Added clarification to section 2.1.1 per resolution of issue 222. |
20040706 | RRC | Made it possible to use rpc style with schema languages other than XML Schema. |
20040702 | SW | Made operation/@style be a list of URIs. |
20040702 | SW | Had forgotten to map to the {type} property of binding. |
20040625 | SW | Allowed F&P *nearly* everywhere. Sigh. |
20040618 | SW | Changed F&P composition model to nearest enclosing scope. |
20040618 | SW | Incorporated Jacek's purpose of bindings text as appropriate. |
20040526 | SW | Added @address to /definitions/service/endpoint per F2F decision |
20040526 | SW | Added @type to /definitions/binding per F2F decision |
20040519 | SW | Renamed wsoap12: to wsoap:. |
20040323 | JJM | Commented out the (missing) property example. |
20040322 | RRC | Added definition of wsdli:wsdlLocation attribute. |
20040322 | JJM | Added faults to properties and features. |
20040319 | JJM | Use lowercase "should" in notes. |
20040319 | JJM | Comment out features at service level. Uniformize scope between features and properties. |
20040318 | JJM | Moved normative notes into the main body of the document. |
20040318 | JJM | Incorporated the property text from Glen. |
20040318 | JJM | Addressed comments from Yuxiao Zhao. |
20040318 | JJM | Updated the feature description, as per Glen and David Booth's suggestions. |
20040317 | RRC | Removed redundant {styleDefault} property of the interface component. |
20040317 | JJM | Include comments from Kevin. |
20040315 | RRC | Added clarification on embedded XML schemas that refer to siblings. |
20040315 | RRC | Updated RPC signature extension to use #in/#out/#inout/#return tokens. |
20040315 | RRC | Added explanatory text to types and modularization sections per resolution of issue #102. |
20040315 | SW | Change binding/{fault,operation}/@name to @ref |
20040312 | RRC | Fixed appendix D to take the removal of wsdl:message into account. |
20040312 | RRC | Added definition of wrpc:signature extension attribute. |
20040311 | SW | Change fault stuff per decision to make faults first class in interfaces. |
20040308 | SW | Renamed {message} property to {element} and @message to @element |
20040305 | SW | Added {safety} property |
20040227 | MJG | Merged in branch Issue143 containing resolution of issue 143 |
20040227 | SW | Dropped {type definitions} property from definitions; leftover from <message> days. |
20040226 | SW | Working thru various edtodo items. |
20040106 | JS | Per 18 Dec 2003 telecon decision, added text re: circular includes. |
20031204 | JS | Per 4 Dec 2003 telecon decision, removed redundant binding/operation/{infault, outfault}/@messageReference. |
20031105 | JS | Added point to attributes task force recommendation accepted by the working group. |
20031104 | JS | Mapping to component model for
{message} of Fault Reference component indicated that
message attribute information item was
optional, but the pseudo syntax and XML representation indicated it
was required. Made uniformly optional to allow other type systems
as was previously done for {message} of Message Reference
component. |
20031104 | JS | Renamed interface /operation /{input,output} /@body to ./@message and interface /operation /{infault,outfault} /@details to ./@message per 4 Nov face-to-face decision. |
20031104 | JS | Made interface /operation /{input,output,infault,outfault} /@messageReference optional per 4 Nov face-to-face decision. |
20031104 | JS | Removed interface/operation/{input,output}/@header per 4 Nov face-to-face decision. |
20031102 | SW | Updated fault reference components to indicate that if operation's MEP uses MTF then the fault is in the opposite direction as the referenced message and if it use FRM then its in the same direction. Per 10/30 telecon decision. |
20031102 | SW | Updated operation styles terminology per message #57 of Oct. and the RPC style rules per message #58 of Oct. per decision on 10/30 telecon to consider those status quo. |
20031102 | SW | Clarified wording in operation styles discussion to better explain the use of the {style} attribute. |
20031102 | SW | Clarified wording in XML <-> component model mapping section for message reference components to say that {body} and {headers} may not have a value. |
20031102 | SW | Made interface/operation/(input|output)/@messageReference REQUIRED per 10/30 telecon decision. |
20031028 | SW | Renamed to wsdl20.xml and updated contents. |
20031028 | SW | Updated bindings. |
20031025 | SW | Updated faults. |
20031013 | JJM | Moved appendix C to a separate document, as per 24 Sep 2003 meeting in Palo Alto, CA. |
20031003 | SW | Softened <documentation> wording to allow machine processable documentation. |
20031002 | SW | Changed binding/operation/@name to QName per edtodo. |
20030930 | SW | Added placeholders for set-attr/get-attr operation styles. |
20030929 | SW | Inserted Glen Daniels' feature text. |
20030919 | RRC | Removed import facility for chameleon schemas and added a description of a workaround. |
20030918 | JJM | Changed message pattern to message exchange pattern, as per WG resolution on 18 Sep. 2003 |
20030916 | RRC | Added editorial note for the missing RPC encoding style. |
20030915 | RRC | Yet more updates for REQUIRED, OPTIONAL; updated section 3 to reflect the removal of "wsdl:message". |
20030911 | RRC | More updates for REQUIRED, OPTIONAL; removed diff markup; fixed example C.4. |
20030911 | RRC | Renamed message reference "name" attribute and property to "messageReference"; fixed incorrect reference to "fault" element in the binding operation section. |
20030910 | SW | Fixed message references and added proper use of REQUIRED etc. for the part I've gone through so far. |
20030910 | SW | Updating spec; fixed up interface operation component more. |
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.2.1 The Interface Component and 2.2.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 accommodate other type systems and spell out how extensibility elements/attributes play out in such scenarios. |
20030428 | MJG | Added text to 1.4 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: |
20030220 | MJG | ComponentModelForMEPs: Minor wording change at suggestion of JJM |
20030212 | MJG | ComponentModelForMEPs: Updated component model to include Fault Reference component. Associated changes to Port Type Operation component |
20030211 | MJG | ComponentModelForMEPs: 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.9.2 XML Representation of Binding Component to list type attribute |
20030217 | MJG | Minor edits to wording in 2.4.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. |
20030130 | MJG | operationnames: Updated binding section to match changes to port type section WRT operation names |
20030130 | MJG | operationnames: Added best practice note on operation names and target namespaces to 2.4.1 The Interface Operation Component |
20030122 | MJG | operationnames: 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.5.2 XML Representation of Interface 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.4.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 Description 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 |