Online XML-Dokumente versenden: Mit SAAJ klappt es

Alle SOAP-Nachrichten werden über eine Verbindung gesendet und empfangen. SAAJ-API bildet die Verbindung durch ein SOAPConnection-Objekt ab, das vom Sender direkt an sein Ziel geht.

Der folgende Code-Ausschnitt erstellt die SOAPConnection-Objektverbindung. Nachdem die Nachricht erstellt und bestückt ist, wird die Objektverbindung zum Versenden der Nachricht genutzt. Wie bereits erwähnt, werden alle über ein SOAPConnection-Objekt laufenden Nachrichten mit der call-Methode gesendet, die die Nachricht sendet und blockiert, bis eine Antwort eingeht. Daher ist der Rückgabewert der call-Methode das SOAPMessage-Objekt, das die Antwort auf die gesendete Nachricht darstellt. Der Anfrageparameter ist die gesendete Nachricht selbst. Der Endpunkt steht für das Sendeziel.

Ein für den Versand von Anfrage-Antwort-Nachrichten implementierter Web-Service muss eine Antwort für jede Nachricht ausgeben, die er erhält. Die Antwort ist ein SOAPMessage-Objekt, ebenso wie die Anfrage. Die ersten Schritte zur Inhaltsabfrage einer Nachricht stimmen mit denen zum Einfügen von Inhalten überein. Um das SOAPBody-Objekt zu erhalten, wird das Message-Objekt benutzt. Alternativ lässt sich durch die SOAPPart– und SOAPEnvelope-Objekte auf das SOAPBody-Objekt zugreifen. Solange SOAPMessage die DOM-Struktur erbt, kann man das erhaltene XML-Dokument mit der DOM-API betrachten.

Wo gibt es SAAJ?

Die J2EE-Version 1.4 enthält die Version 1.2 von SAAJ. Sie verarbeitet nur SOAP-1.1-Nachrichten. Die neueste Enterprise Edition 5 enthält dagegen SAAJ in Version 1.3. Will man nicht die gesamte Enterprise Edition nutzen, findet sich auch in der neuesten Ausgabe des Java Web-Service-Entwickler-Pakets eine Implementierung von SAAJ 1.3 mit kompletter Dokumentation und Beispielen. Das Open-Source-Projekt GlassFish enthält ebenfalls SAAJ 1.3.

Weitere Quellen für SAAJ:

• SAAJ Standard Implementation Project
• Java-Web-Service-Anleitung
• Metro Web Service Stack Implementation