Table of contents

Appendices

2.14 Endpoint

The Endpoint Component[top]

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

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

The properties of the Endpoint component are as follows:

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

• {binding} REQUIRED. A named Binding component.

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

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

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

For each Endpoint component in the {endpoints} property of a Service component, the {binding} property (see [The Endpoint Component]) MUST either be a Binding component with an unspecified {interface} property (see [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.

XML Representation of Endpoint Component[top]

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

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

• A [local name] of endpoint.

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

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

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

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

  • An OPTIONAL address 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/2004/08/wsdl.

• Zero or more element information item 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:

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

     • Zero or more property element information items [XML Representation of Property Component]

     • Zero or more namespace-qualified element information items amongst its [children]. The [namespace name] of such element information items MUST NOT be http://www.w3.org/2004/08/wsdl. Such element information items are considered to be endpoint extension elements as described below (see [Endpoint extension elements]).

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

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

The name attribute information item has the following Infoset properties:

• A [local name] of name.

• A [namespace name] which has no value.

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

binding attribute information item with endpoint [owner][top]

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

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

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

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

The mapping between the properties of the Endpoint component (see [The Endpoint Component]) and the XML Representation of the endpoint element information item (see [XML Representation of Endpoint Component]) is as described in [tab_Endpoint_Mapping].