Table of contents

Appendices

2.10 Binding Fault

The Binding Fault Component[top]

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 the target namespace of the interface and the name of the fault within that interface.

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.

The properties of the Binding Fault component are as follows:

• {fault reference} REQUIRED. An Interface Fault component in the {faults} property of the Interface component identified by the {interface} property of the parent Binding component. 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.

For each Binding Fault component in the {faults} property of a Binding component, the {fault reference} property MUST be unique. That is, one cannot define multiple bindings for the same fault within a given Binding component.

XML Representation of Binding Fault Component[top]

<definitions>
  <binding>
    <fault
          ref="xs:QName" >
      <documentation />?
      [ <feature /> | <property /> ]*
    </fault>
  </binding>
</definitions>

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/2004/08/wsdl

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

  • A REQUIRED ref 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 binding fault extension elements as described below (see [Binding Fault extension elements]).

ref attribute information item with fault [owner][top]

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

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 between those properties and the XML representation.

Mapping Binding Fault's XML Representation to Component Properties[top]

The mapping between the properties of the Binding Fault component (see [The Binding Fault Component]) and the XML Representation of the fault element information item (see [XML Representation of Binding Fault Component]) is as described in [tab_Binding_Fault_Mapping].