WS-Adressierung mit dem SOAPInput-Knoten

In diesem Abschnitt werden die zur Verfügung stehenden Optionen bei Verwendung von WS-Adressierung mit dem SOAPInput-Knoten beschrieben.

Der SOAPInput-Knoten verfügt über die Eigenschaft WS-Adressierung verwenden. Diese Eigenschaft verarbeitet die in der ankommenden Nachricht enthaltenen WS-Adressierungsinformationen.

Wenn Sie diese Eigenschaft aktivieren, werden die WS-Adressierungsinformationen verarbeitet. Dieser Prozess wird auch als Inanspruchnahme von WS-Adressierung bezeichnet. Standardmäßig wird die WS-Adressierung nicht in Anspruch genommen.

Sie können diese Eigenschaft auch in der WSDL-Datei konfigurieren. Die Eigenschaft wird dann beim Ablegen der WSDL-Datei auf dem Knoten automatisch vom Tool eingestellt. Der Knoten verhält sich abhängig von der Inanspruchnahme von WS-Adressierung wie folgt:
Adressierung wird nicht in Anspruch genommen
Die WS-Adressierungsinformationen werden nicht verarbeitet. Falls eine ankommende Nachricht WS-Adressierungsheader enthält, so werden diese ignoriert. Es findet keinerlei Verarbeitung der WS-Adressierungsinformationen statt, es sei denn, diese sind mit dem Parameter MustUnderstand gekennzeichnet.
Beim Verlassen des SOAPInput-Knotens sind die ankommenden WS-Adressierungsheader in diesem Fall in der Nachricht sichtbar, und zwar in der Nachrichtenbaumstruktur des SOAP-Parsers unter dem Ordner 'Header'. Falls die ankommende Nachricht WS-Adressierungsheader enthält und Folgendes zutrifft:
  • Die Nachricht ist gekennzeichnet als MustUnderstand
  • Die Nachricht ist auf die Rolle ausgerichtet, in der der SOAPInput-Knoten agiert
wird eine Fehlernachricht an den Client zurückgegeben.

Mittels der WS-Adressierung wird dem Knoten mitgeteilt, wie die WS-Adressierungsheader interpretiert werden müssen. In diesem Fall verbleiben die WS-Adressierungsheader im SOAP-Headerbereich des SOAP-Parsers, und sie werden durch keinen anderen SOAP-Knoten verarbeitet. In jedem Fall werden sie als SOAP-Header ohne besondere Bedeutung behandelt.

Adressierung wird in Anspruch genommen
Die Verarbeitung der WS-Adressierungsinformationen erfolgt gemäß den Angaben unter 'WS-Adressierung'. Dies bedeutet, dass Nachrichten mit Übergabeadressheadern oder Endadressheadern akzeptiert werden.
Ein Fehler wird zurückgegeben, wenn beide Header vorhanden sind und Folgendes zutrifft:
  • Keiner der Headerist mittels einer Rolle gekennzeichnet
  • Beide Header sind mit der gleichen Rolle gekennzeichnet, und der SOAPInput-Knoten agiert in dieser Rolle.

Sind die WS-Adressierungsheader in Ordnung, werden sie aus der Baumstruktur der ankommenden Nachrichten entfernt und einschließlich der erkennbaren ankommenden Verweisparameter in die LocalEnvironment-Baumstruktur im Ordner SOAP.Input.WSA eingefügt.

Nur Verweisparameter aus der endgültigen Spezifikation sind erkennbar, da sie über das Attribut IsReferenceParameter verfügen. Übergabereferenzparameter, die nicht über dieses Attribut verfügen, können nicht erkannt werden und werden daher nicht aus der Nachrichtenbaumstruktur in die Umgebungsbaumstruktur verschoben.

Die Parameter sind im Header-Ordner des SOAP-Parsers nicht sichtbar. Die Verschiebung in die Lokale Umgebung ist jedoch ein eindeutiges Signal dafür, dass diese Parameter vom Broker verarbeitet wurden. Die Parameter werden in der Lokalen Umgebung gespeichert, damit Sie sie dort überprüfen können.

Die Parameter werden aus der Nachrichtenbaumstruktur entfernt, weil sie beim Eingang verarbeitet wurden und nicht mehr gültig sind, wenn diese Nachrichtenbaumstruktur ohne weitere Änderungen versendet wird.

An dieser Stelle werden für die Antwortnachricht die korrekten, zur Eingabenachricht passenden WS-Adressierungsheader generiert und in der Lokalen Umgebung in den Ordner Destination.SOAP.Reply.WSA eingefügt.

In diesem Ordner können Sie die korrekten Antwortheader für diese Nachricht speichern; Sie können diese WSA-Antwortheader jedoch auch ändern, bevor sie den SOAPReply-Knoten erreichen.

Zugehörige Konzepte
WS-Addressing
Zugehörige Tasks
Beispiel für die Verwendung von WS-Adressierung
Zugehörige Verweise
SOAPInput-Knoten
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac64500_