Stylus Studio XML Editor

Table of contents

Appendices

2.11 Port

Port

The Port Component[top]

The Port Component

A port component defines the particulars of a specific end-point at which a given service is available.

Port components are local to a given service component, they cannot be referred to by QName

The properties of the Port Component are as follows:

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

  • {binding} A named binding component

For each port component in the {ports} property of a service component the {name} property must be unique.

XML Representation of Port Component[top]

XML Representation of Port Component

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

  • A [local name] of port

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

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

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

    • A binding 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 item amongst its [children], as follows;

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

    • Zero or more namespace qualified element information items. Such element information items MUST be a member of one of the element substitution groups related to ports described in [Language Extensibility]. Such element information items are considered to be port extension elements (see [Port extension elements]).

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

name attribute information item with port [owner]

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

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 port [owner][top]

binding attribute information item with port [owner]

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

The binding attribute information item has the following Infoset properties;

  • A [local name] of binding

  • A [namespace name] which has no value

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

Port extension elements[top]

Port extension elements

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

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

Mapping Port's XML Representation to Component Properties

The mapping between the properties of the Port Component (see [The Port Component]) and the XML Representation of the port element information item (see [XML Representation of Port Component]) is as described in [tab_Port_Mapping].

1tab_Port_Mapping Mapping between Port Component Properties and XML Representation Property Mapping
11{name} 11The actual value of the name attribute information item
11{binding} 11 The binding component resolved to by the actual value of the binding attribute information item