Fehlerbehandlung in Web Services

Festlegungen der SOAP-Spezifikation

Die für die Fehlermeldung zu verwendende Form ist in der SOAP-Spezifikation 1.1 (www.w3.org/TR/2000/NOTE-SOAP-20000508) im Abschnitt 4.4 SOAP Fault festgelegt. Dort wird das Element Fault definiert. Dieses Element übermittelt den Fehler innerhalb einer SOAP-Mitteilung. Wenn das Element Fault in einer SOAP-Nachricht enthalten ist, befindet es sich einmal innerhalb des Elements Body. Das Element Fault selbst kann vier Unterelemente enthalten: faultcode, faultstring, faultactor sowie detail. Dabei sind die Unterelemente faultcode und faultstring erforderlich, faultactor und detail sind optional. Tabelle 1 enthält eine Übersicht der Unterelemente des Elements Fault.

Tabelle 1: Die Elemente und ihre Bedeutung innerhalb von Fehlermeldungen

Element	Optional	Beschreibung
Faultcode	Nein	Für die Auswertung des Fehlers mittels Software muss das Element faultcode eine eindeutige Fehlerbeschreibung enthalten. Der Aufbau der Fehlerbeschreibung muss einem XML-Namespace entsprechen.
Faulstring	Nein	Das Element faultstring soll eine Beschreibung des aufgetretenen Fehlers im Klartext enthalten. Es ist für die Auswertung durch den Menschen bestimmt.
Faultactor	Ja	Das Element faultactor kann in Form eines URI die Quelle des Fehlers angeben.
Detail	Ja	Über das Element detail können anwendungsspezifische Fehlerinformationen übermittelt werden.

Die optionalen Elemente faultactor und detail können bei der Implementierung eines Web Service innerhalb einer Notes-Datenbank mittels LotusScript nicht verwendet werden. Dies ist nur bei der Programmierung mit Java möglich.