Web-Services-Addressing-Unterstützung für JAX-WS-Anwendungen mit Adressierungsfeatures

Für JAX-WS-Anwendungen können Sie die WS-Addressing-Unterstützung während der Entwicklung einer Clientanwendung über die Adressierungsfeatures im Code aktivieren.

Informationen zu diesem Vorgang

Verwenden Sie eine der folgenden Adressierungsfeatureklassen in Ihrem Clientcode:
  • AddressingFeature - Verwenden Sie diese Klasse, wenn Sie Nachrichten senden möchten, die WS-Addressing-Header gemäß der WS-Addressing-Spezifikation vom August 2005 enthalten.
  • SubmissionAddressingFeature - Verwenden Sie diese Klasse, wenn Sie Nachrichten senden möchten, die WS-Addressing-Header gemäß der WS-Addressing-Spezifikation vom August 2004 enthalten.
Wenn Sie beide Featureklassen verwenden, entscheidet der Typ der angegebenen Endpunktreferenz, welche Spezifikation verwendet wird. Wenn Sie beispielsweise ein Objekt W3CEndpointReference angeben, wird die Spezifikation vom August 2005 verwendet. Wenn Sie eine Endpunktreferenz angeben, deren Typ mit dem durch die Featureklasse angegebenen Typ in Konflikt steht, z. B. ein Objekt W3CEndpointReference mit einer Instanz von SubmissionAddressingFeature wird ein Fehler ausgelöst. Wenn Sie keine Endpunktreferenz angeben, wird standardmäßig die Spezifikation vom August 2005 verwendet.
Geben Sie bis zu drei optionale Parameter für jede Instanz der Adressierungsfeatures an:
Tabelle 1. Parameter für die Adressierungsfeatures. In der Tabelle sind die verschiedenen Parameter der Adressierungsfeatures mit ihren gültigen Werten und der jeweiligen Beschreibung aufgeführt.
Parametername Gültige Werte Beschreibung
enabled

true (Standardwert)
false

Gibt an, ob die WS-Addressing-Unterstützung aktiviert ist.
required

true
false (Standardwert)

Gibt an, ob WS-Addressing-Header erforderlich sind.
responses

Responses.All (Standardeinstellung)
Responses.ANONYMOUS
Responses.NON_ANONYMOUS

Gibt an, ob ein synchrones oder ein asynchrones Nachrichtenaustauschmuster verwendet werden soll. Geben Sie "Responses.ANONYMOUS" an, um Nachrichten in einem synchronen Nachrichtenaustauschmuster zu senden. Verwenden Sie "Responses.NON_ANONYMOUS", um Nachrichten in einem asynchronen Nachrichtenaustauschmuster zu senden.
Anmerkung: Dieser Parameter wird für die Klasse "SubmissionAddressingFeature" nicht unterstützt.
Anmerkung: Sie können die Featureklassen für die Adressierung nur für eine Bindung des Typs "SOAP (1.1 oder 1.2) over HTTP" verwenden. Wenn Sie die Klasse mit einer anderen Bindung verwenden, z. B. XML over HTTP, wird auf den Clients eine Ausnahme ausgelöst, und der Web-Service wird auf den Servern nicht implementiert.

Vorgehensweise

Erstellen Sie eine Instanz einer der Adressierungsfeatureklassen mit den gegebenenfalls erforderlichen Parametern. Verwenden Sie beispielsweise den folgenden Code, um anzugeben, dass WS-Addressing aktiviert wird und erforderlich ist, dass die Spezifikation vom August 2005 und das asynchrone Nachrichtenaustauschmuster verwendet wird:
AddressingFeature feat = new AddressingFeature(true, true, AddressingFeature.Responses.NON_ANONYMOUS);
Verwenden Sie den folgenden Code, um anzugeben, dass WS-Addressing gemäß der Spezifikation vom August 2004 inaktiviert ist:
SubmissionAddressingFeature feat = new SubmissionAddressingFeature(false);

Ergebnisse

Wenn Sie angeben, dass WS-Addressing aktiviert ist, schließt der Client WS-Addressing-Header in SOAP-Nachrichten ein. Die Header entsprechen der WS-Addressing-Spezifikation, die durch den Typ der verwendeten Featureklasse angezeigt wird. Wenn der Server keine Annotationen verwendet oder Richtliniensätze für die Aktivierung von WS-Addressing verwendet, akzeptiert der Server sowohl die Spezifikation vom August 2005 als auch die vom August 2004.

Wenn Sie angeben, dass WS-Addressing erforderlich ist und der Client eine Nachricht empfängt, die keine WS-Addressing-Header enthält, gibt der Client einen Fehler zurück.

Wenn Sie das Antwortattribut angeben, wird das entsprechende Nachrichtenaustauschmuster verwendet.


Symbol, das den Typ des Artikels anzeigt. Taskartikel



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