Stylus Studio XML Editor

Table of contents

Appendices

2.1 Definitions

Definitions

The Definitions Component[top]

The Definitions Component

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

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

The properties of the Definitions Component are as follows:

  • {messages} A set of named message definitions

  • {port types} A set of named port type definitions

  • {bindings} A set of named binding definitions

  • {services} A set of named service definitions

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

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

XML Representation of Definitions Component[top]

XML Representation of Definitions Component

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

The target namespace represents an unambiguous name for the intended semantics of the WSDL Infoset. The targetNamespace URI SHOULD point to a human or machine processable document that directly or indirectly defines the semantics of the WSDL Infoset.

The definitions element information item has the following Infoset properties:

  • A [local name] of definitions.

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

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

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

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

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

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

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

      1. Zero or more include element information items (see [Including Descriptions])

      2. Zero or more import element information items (see [Importing Descriptions])

    3. An optional types element information item (see [Types]).

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

      1. message element information items (see [XML Representation of Message Component]).

      2. portType element information items (see [XML Representation of Port Type Component]).

      3. binding element information items (see [XML Representation of Binding Component]).

      4. service element information items (see [XML Representation of Service Component]).

  • Zero or more namespace qualified element information items amongst its [children]. Such element information items MUST be a member of one of the element substitution groups allowed at the top-level of a WSDL document as described in [Language Extensibility].

targetNamespace attribute information item[top]

targetNamespace attribute information item

The targetNamespace attribute information item defines the namespace affiliation of top-level components defined in this definitions element information item. Messages, port types, 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.

Mapping Definitions' XML Representation to Component Properties[top]

Mapping Definitions' XML Representation to Component Properties

The mapping between the properties of the Definitions Component (see [The Definitions Component]) and the XML Representation of the definitions element information item (see [XML Representation of Definitions Component]) is described in [tab_Definitions_Mapping].

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