XML Soap

• SOAP steht für Simple Object Access P rotokoll
• SOAP ist eine Anwendung, Kommunikationsprotokoll
• SOAP ist ein Format für das Senden und Empfangen von Nachrichten
• SOAP ist plattformunabhängig
• SOAP basiert auf XML
• SOAP ist eine W3C-Empfehlung

Warum SOAP?

Es ist wichtig für Web-Anwendungen in der Lage zu sein, das Internet zu kommunizieren.

Der beste Weg, zwischen Anwendungen zu kommunizieren ist über HTTP, weil HTTP von allen Internet-Browsern und Servern unterstützt wird. SOAP wurde geschaffen, um dies zu erreichen.

SOAP bietet eine Möglichkeit, zwischen Anwendungen zu kommunizieren auf verschiedenen Betriebssystemen laufen, mit unterschiedlichen Technologien und Programmiersprachen.

SOAP-Bausteine

Eine SOAP-Nachricht ist eine ganz normale XML-Dokument die folgenden Elemente enthält:

• Ein Umschlag Element, das das XML-Dokument als SOAP-Nachricht identifiziert
• Ein Kopfelement, das Header-Informationen enthält
• Ein Körperelement, das Gespräch und Antwortinformation enthält
• Ein Fehler Element enthält Fehler und Statusinformationen

Alle oben genannten Elemente sind in der Standard-Namespace für den SOAP-Umschlag erklärt:

http://www.w3.org/2003/05/soap-envelope/

und die Standard-Namespace für SOAP-Codierung und Datentypen:

http://www.w3.org/2003/05/soap-encoding

Syntaxregeln

Hier sind einige wichtige Syntaxregeln:

• Eine SOAP-Nachricht muss codiert werden unter Verwendung von XML
• Eine SOAP-Nachricht muss der SOAP-Envelope-Namespace verwenden
• Eine SOAP-Nachricht muss die SOAP-Encoding-Namespace verwenden
• Eine SOAP-Nachricht darf nicht zu einer DTD-Referenz enthalten
• Eine SOAP-Nachricht darf NICHT XML-Verarbeitungsanweisungen enthalten

Skeleton SOAP-Nachricht

Der SOAP-Envelope-Element

Die erforderliche SOAP Envelope Element ist das Wurzelelement einer SOAP-Nachricht. Dieses Element definiert das XML-Dokument als SOAP-Nachricht.

Beispiel

Die xmlns: Seife Namespace

Beachten Sie die xmlns: Seife Namespace in dem obigen Beispiel. Es sollte immer den Wert: "http://www.w3.org/2003/05/soap-envelope/" .

Der Namensraum definiert den Umschlag als SOAP-Umschlag.

Wenn ein anderer Namespace verwendet wird, generiert die Anwendung einen Fehler und verwirft die Nachricht.

Die encodingStyle Attribut

Das encodingStyle Attribut wird verwendet , um die Datentypen im Dokument verwendet zu definieren. Dieses Attribut kann auf jedem SOAP Element erscheinen, und gilt für das Element den Inhalt und alle untergeordneten Elemente.

Eine SOAP-Nachricht hat keine Standard-Kodierung.

Syntax

Beispiel

Der SOAP-Header-Element

Das optionale SOAP - Header - Element enthält anwendungsspezifische Informationen (like authentication, payment, etc) über die SOAP - Nachricht.

Wenn die Header-Element vorhanden ist, muss es das erste Kind-Element des Envelope Element sein.

Note: Alle unmittelbar untergeordneten Elemente des Kopfelement Namespace-qualifiziert sein müssen.

Das obige Beispiel enthält einen Header mit einem "Trans" Element, ein "mustUnderstand" Attribut mit einem Wert von 1 und einem Wert von 234.

SOAP definiert drei Attribute in der Standard-Namespace. Diese Attribute sind: mustunderstand, Schauspieler und encodingStyle.

Die Attribute im SOAP-Header definiert definiert, wie ein Empfänger sollte die SOAP-Nachricht verarbeiten.

Die mustUnderstand Attribut

Die SOAP mustunderstand-Attribut kann verwendet werden, um anzuzeigen, ob ein Kopfeintrag ist obligatorisch oder optional für den Empfänger zu verarbeiten.

Wenn Sie mustunderstand = "1" auf ein untergeordnetes Element des Header-Element hinzufügen, zeigt es an, dass der Empfänger den Header-Verarbeitung des Elements erkennen müssen. Wenn der Empfänger nicht das Element erkennt wird es fehlschlagen, wenn die Header-Verarbeitung.

Syntax

Beispiel

Der actor Attribut

Eine SOAP-Nachricht, indem verschiedene Endpunkte entlang der Nachrichtenpfad zu einem Empfänger von einem Sender reisen. Allerdings sind nicht alle Teile einer SOAP-Nachricht kann für die ultimative Endpunkt statt bestimmt, kann es für eine oder mehrere der Endpunkte auf den Nachrichtenpfad bestimmt.

Der SOAP-Schauspieler-Attribut wird verwendet, um die Header-Element an einen bestimmten Endpunkt zu adressieren.

Syntax

Beispiel

Die encodingStyle Attribut

Das encodingStyle Attribut wird verwendet , um die Datentypen im Dokument verwendet zu definieren. Dieses Attribut kann auf jedem SOAP Element erscheinen, und es wird auf dieses Element den Inhalt und alle untergeordneten Elemente anwenden.

Eine SOAP-Nachricht hat keine Standard-Kodierung.

Syntax

Die SOAP-Body-Element

Die erforderliche SOAP-Body-Element enthält die eigentliche SOAP-Nachricht für die ultimative Endpunkt der Nachricht bestimmt.

Sofort untergeordneten Elemente des SOAP-Body-Element kann Namespace-qualifiziert sein.

Beispiel

Das obige Beispiel fordert den Preis von Äpfeln. Beachten Sie, dass die m: GetPrice und die Item-Elemente über anwendungsspezifische Elemente sind. Sie sind nicht Teil des SOAP-Namespace.

Eine SOAP-Antwort könnte in etwa so aussehen:

Die SOAP-Fehler Element

Das optionale SOAP-Fehler-Element wird verwendet, um Fehlermeldungen anzuzeigen.

Die SOAP-Fehler Element hält Fehler und Statusinformationen für eine SOAP-Nachricht.

Wenn ein Fehler Element vorhanden ist, muss es als ein untergeordnetes Element des Körperelement angezeigt. Ein Fehlerelement kann nur einmal in einer SOAP-Nachricht.

Die SOAP-Fehler-Element hat die folgenden Unterelemente:

SOAP-Fehlercodes

Die faultcode Werte unten definiert sind im faultcode Element verwendet werden, wenn Fehler beschrieben werden:

Das HTTP-Protokoll

HTTP kommuniziert über TCP / IP. Ein HTTP-Client eine Verbindung zu einem HTTP-Server unter Verwendung von TCP. Nach dem Aufbau einer Verbindung kann der Client eine HTTP-Anforderung an den Server senden:

Der Server verarbeitet die Anforderung und sendet eine HTTP-Antwort zurück an den Client. Die Antwort enthält einen Statuscode, der den Status der Anforderung anzeigt:

In dem obigen Beispiel, kehrte der Server einen Statuscode 200 für HTTP Dies ist der Standard-Code Erfolg.

Wenn der Server die Anforderung nicht entschlüsseln konnte, könnte es wieder so etwas wie dieses:

SOAP Binding

Die SOAP-Spezifikation definiert die Struktur der SOAP-Nachrichten, wie sie nicht ausgetauscht werden. Diese Lücke wird gefüllt durch das, was heißt "SOAP Bindings" . SOAP Bindungen sind Mechanismen, die SOAP-Nachrichten ermöglichen, wirkungsvoll unter Verwendung eines Transportprotokolls ausgetauscht werden.

Die meisten SOAP-Implementierungen bieten Anbindungen für gemeinsame Transportprotokolle wie HTTP oder SMTP.

HTTP ist synchron und weit verbreitet. Ein SOAP-HTTP-Anforderung gibt mindestens zwei HTTP-Header: Content-Type und Content-Length.

SMTP ist asynchron und wird in letzter Instanz oder bestimmten Fällen verwendet.

Java - Implementierungen von SOAP in der Regel eine bestimmte für die JMS - Bindung zur Verfügung stellen (Java Messaging System) Protokoll.

Inhaltstyp

Der Content-Type - Header für eine SOAP - Anforderung und Antwort definiert den MIME - Typ für die Nachricht und die Zeichenkodierung (optional) für die XML - Körper der Anfrage oder Antwort verwendet.

Syntax

Beispiel

Content-Length

Der Content-Length-Header für eine SOAP-Anforderung und Antwort gibt die Anzahl von Bytes in dem Körper der Anfrage oder Antwort.

Syntax

Beispiel

Ein SOAP-Beispiel

In dem folgenden Beispiel wird ein GetStockPrice Anforderung an einen Server gesendet. Der Antrag hat eine StockName Parameter, und ein Preis-Parameter, die in der Antwort zurückgegeben wird. Der Namensraum für die Funktion wird in definierten "http://www.example.org/stock" .

Eine SOAP-Anforderung:

Die SOAP-Antwort: