Die Struktur einer SOAP-Nachricht

Eine SOAP-Nachricht ist als XML-Dokument verschlüsselt und besteht aus einem <Envelope>-Element, welches ein optionales <Header>-Element sowie ein obligatorisches <Body>-Element enthält. Das im <Body>-Element enthaltene Element<Fault> wird zur Dokumentation von Fehlern verwendet.

Die SOAP-Rahmenanweisung
Das SOAP-Element <Envelope> ist das Stammelement jeder SOAP-Nachricht und enthält zwei untergeordnete Elemente, das optionale Element <Header> und das obligatorische Element <Body>.
Der SOAP-Header
Der SOAP <Header> ist ein optionales Unterelement der SOAP-Rahmenanweisung und wird dazu verwendet, anwendungsbezogene Informationen weiterzugeben, die von SOAP-Knoten auf dem Nachrichtenpfad verarbeitet werden sollen.
Der SOAP-Hauptteil
Das SOAP-Element <Body> ist ein obligatorisches Unterelement der SOAP-Rahmenanweisung, das für den letztendlichen Empfänger der Nachricht bestimmte Informationen enthält.
Der SOAP-Fehler
Das SOAP-Element <Fault> ist ein Unterelement des SOAP-Hauptteils, das zur Dokumentation von Fehlern verwendet wird.

XML-Elemente im <Header> und im <Body> werden durch die Anwendungen, die sie verwenden, definiert, obwohl die SOAP-Spezifikation deren Struktur betreffend einige Einschränkungen auferlegt. Die folgende Abbildung zeigt die Struktur einer SOAP-Nachricht.

Diagramm mit SOAP-Rahmenanweisung als Container für den SOAP-Header und den SOAP-Hauptteil. Der SOAP-Header ist ein Container für die Header-Blöcke, während der SOAP-Hauptteil ein Container für die Unterelemente des Hauptteils ist.

Nachfolgender Code ist ein Beispiel für eine SOAP-Nachricht, die Header-Blöcke (die Elemente <m:reservation> und <n:passenger>) sowie einen Hauptteil (mit dem Element <p:itinerary>) enthält.

<?xml version='1.0' Encoding='UTF-8' ?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> 
 <env:Header>
  <m:reservation xmlns:m="http://travelcompany.example.org/reservation" 
		env:role="http://www.w3.org/2003/05/soap-envelope/role/next" 
			env:mustUnderstand="true">
   <m:reference>uuid:093a2da1-q345-739r-ba5d-pqff98fe8j7d</m:reference>
   <m:dateAndTime>2007-11-29T13:20:00.000-05:00</m:dateAndTime>
  </m:reservation>
  <n:passenger xmlns:n="http://mycompany.example.com/employees" 
		env:role="http://www.w3.org/2003/05/soap-envelope/role/next" 
			env:mustUnderstand="true">
   <n:name>Fred Bloggs</n:name>
  </n:passenger>
 </env:Header>
 <env:Body>
  <p:itinerary 
		xmlns:p="http://travelcompany.example.org/reservation/travel">
   <p:departure>
     <p:departing>New York</p:departing>
     <p:arriving>Los Angeles</p:arriving>
     <p:departureDate>2007-12-14</p:departureDate>
     <p:departureTime>late afternoon</p:departureTime>
     <p:seatPreference>aisle</p:seatPreference>
   </p:departure>
   <p:return>
     <p:departing>Los Angeles</p:departing>
     <p:arriving>New York</p:arriving>
     <p:departureDate>2007-12-20</p:departureDate>
     <p:departureTime>mid-morning</p:departureTime>
     <p:seatPreference></p:seatPreference>
   </p:return>
  </p:itinerary>
   </env:Body>
</env:Envelope>
Zugehörige Konzepte
Der SOAP-Header
Der SOAP-Hauptteil
Der SOAP-Fehler
SOAP 1.1 und 1.2
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac55780_