element
2280c2280
< SOAP fault code (see )
---
>
SOAP fault code (see )
2284a2285,2344
>
>
SOAP fault codes are intended for use by
> software to provide an algorithmic mechanism for
> identifying the fault. SOAP fault codes are organized as a
> linked list of XML qualified names allowing a SOAP node to
> identify the fault category at an increasing level of
> detail of the SOAP fault.
>
> The values of the Value child
> element information item of the Code
> element information item are restricted to
> those defined by the env:faultCodeEnum type (see
> ). Additional fault
> subcodes MAY be created for use by applications or
> features. Such subcodes are carried in the Value
> child element information item of the
> Subcode element information
> item.
>
> SOAP fault codes are to be interpreted as
> modifiers of the contents of the Detail
> element information item in the sense that
> they provide the context for the Detail
> element information item. A SOAP node MUST
> understand all SOAP fault codes in a SOAP fault message in
> order to be able to interpret the Detail
> element information item in a SOAP fault.
>
>
>
> Sample SOAP fault where the Detail
> element information item is to be
> interpreted in the context of the
> env:Sender and
> m:MessageTimeout fault codes.
> <env:Envelope xmlns:env="http://www.w3.org/2002/06/soap-envelope"
> xmlns:m="http://www.example.org/timeouts">
> <env:Body>
> <env:Fault>
> <env:Code>
> <env:Value>env:Sender</env:Value>
> <env:Subcode>
> <env:Value>m:MessageTimeout</env:Value>
> </env:Subcode>
> </env:Code>
> <env:Reason>Sender Timeout</env:Reason>
> <env:Detail>
> <m:MaxTime>P5M</m:MaxTime>
> </env:Detail>
> </env:Fault>
> </env:Body>
> </env:Envelope>
>
> This specification does not define a limit for
> how many Subcode element information
> items a SOAP fault might contain. However, while
> not a requirement of this specification, it is anticipated
> that most practical examples can be supported by
> relatively few Subcode element information
> items.