Unterschiede zwischen den SAAJ-Versionen

Die Schnittstelle SOAP with Attachments API for Java™ (SAAJ) Version 1.3 erweitert die Unterstützung von SOAP-Nachrichten der Version 1.2 in einer Web-Service-Umgebung. Zwischen SAAJ 1.2 und SAAJ 1.3 gibt mehrere Unterschiede, die in diesem Artikel beschrieben werden.

In einer typischen Web-Service-Umgebung stützen Sie sich bei der Übersetzung von Java-Objekten auf den zugrunde liegenden Code, der auf Java-Standards basiert. Die Schnittstelle SAAJ stellt APIs für das Lesen, Schreiben, Senden und Empfangen von SOAP-Nachrichten bereit und befürwortet das Senden binärer Inhalte als Anhang einer SOAP-Nachricht.

SAAJ 1.3 ist an SOAP-Nachrichten der Version 1.1 und 1.2 ausgerichtet und wird von den Programmiermodellen Java API for XML Web Services (JAX-WS) und Java API for XML-Based RPC (JAX-RPC) unterstützt. SAAJ 1.2 funktioniert nur mit SOAP-Nachrichten der Version 1.1.

Wenn Sie Ihren Code von SOAP 1.1 auf SOAP 1.2 migrieren, können Sie Ihren vorhandenen Code der SOAP Version 1.1 weiterverwenden, wenn die Nachricht eine SOAP-Nachricht der Version 1.2 ist. Wenn Sie ein Upgrade Ihres Basiscodes auf SAAJ 1.3 durchführen, können Sie den vorhandenen Code, der auf der Basis von SOAP-Nachrichten der Version 1.1 operiert, weiterverwenden. Ein Beispiel für diese Unterschiede ist in SOAP 1.1 zu finden. In dieser Version wird der lesbare Text eines Fehlers im Element "faultString" gespeichert. In SOAP 1.2 wird der lesbare Text im Element "Reason" gespeichert. Ihr Code könnte dem folgenden Beispiel gleichen:
String text = soapFault.getFaultString();
Die Methode getFaultString () gibt den Wert von "faultString" zurück, wenn die Nachricht auf SOAP 1.1 basiert. Wenn Sie SOAP 1.2 verwenden, gibt getFaultString() den Wert von "Reason" zurück. Darüber hinaus stellt die Schnittstelle SAAJ 1.3 eine neue Methode mit dem Namen "getReasonText (Locale)" bereit, die einen bestimmten "Reason"-Wert abruft. Die Methode "getReasonText (Locale)" gibt eine dokumentierte Ausnahme zurück, wenn die Nachricht auf SOAP 1.1 basiert. Die Schnittstelle SAAJ 1.3 unterstützt vorhandenen Code bei der Verarbeitung von Nachrichten, die auf SOAP 1.1 oder auf SOAP 1.2 basieren.

Weitere Unterschiede zwischen SAAJ 1.2 und SAAJ 1.3 sind in der folgenden Liste aufgeführt:

Eine vollständige Liste der unterstützten Standards und Spezifikationen finden Sie in der Dokumentation zu den Web-Service-Spezifikationen und den Anwendungsprogrammierschnittstellen.


Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_saajverdiffs
Dateiname:cwbs_saajverdiffs.html