WS-Adressierung mit den Knoten SOAPAsyncRequest und SOAPAsyncResponse

In diesem Abschnitt werden die zur Verfügung stehenden Optionen bei Verwendung von WS-Adressierung mit den Knoten SOAPAsyncRequest und SOAPAsyncResponse beschrieben.

Für die Funktion der Knoten SOAPAsyncRequest und SOAPAsyncResponse ist die WS-Adressierung erforderlich.

Der Remote-Web-Service muss die WS-Adressierung daher verstehen, um die vom SOAPAsyncRequest-Knoten gesendeten WS-Adressierungsheader verarbeiten zu können und die Antwort an den richtigen SOAPAsyncResponse-Knoten, der in der Eigenschaft address (Adresse) der Antwortendpunkt-MAP angegeben ist, zurücksenden zu können.

Darüber hinaus ist in der Antwortendpunkt-MAP unter der Eigenschaft reference parameters (Referenzparameter) auch der Benutzerkontext angegeben. Der in diesem Headerabschnitt übergebene Kontext muss daher vom Remote-Web-Service korrekt in den SOAP-Header der Antwortnachricht kopiert werden, damit der Antwortknoten die Kontextinformationen abrufen und zurück in die vom SOAPAsyncResponse-Knoten weitergegebene Baumstruktur LocalEnvironment ablegen kann.

SOAPAsyncRequest-Knoten

Der SOAPRequest-Knoten verfügt über die schreibgeschützte Eigenschaft WS-Adressierung verwenden, die standardmäßig auf 'true' (wahr) gesetzt ist, in welchem Fall die WS-Adressierung für diesen Knoten obligatorisch ist. Diese Eigenschaft bewirkt, dass die WS-Adressierung für diesen Knoten prinzipiell in Anspruch genommen wird. Die Einstellung kann weder durch den Knoten noch mittels der zur Konfiguration dieses Knotens verwendeten WSDL-Datei geändert werden.

Der Knoten sieht zuerst im Ordner Destination.SOAP.Request.WSA der Lokalen Umgebung nach. Wenn dieser Ordner leer ist, generiert der Knoten in der abgehenden Nachricht automatisch alle erforderlichen WS-Adressierung-MAPs. Dabei gelten folgende Standards:
  • Action: aus der WSDL-Konfigurationsdatei. Wenn dieser Wert in dieser Datei nicht explizit angegeben ist, wird standardmäßig der in der WSDL-Bindungsspezifikation definierte Wert verwendet.
  • To: aus der Knoteneigenschaft Web-Service-URL.
  • ReplyTo: die Adresse des zugehörigen SOAPAsyncRequest-Knotens.
  • MessageID: Eine eindeutige UUID.

Wenn der Ordner Destination.SOAP.Request.WSA in der Lokalen Umgebung nicht leer ist, werden die Eigenschaften der zuvor aufgeführten Standard-MAPs durch die Eigenschaften der vom Benutzer bereitgestellten MAPs überschrieben.

Aufgrund der Eigenheiten des asynchronen SOAP-Knotenpaars können Sie allerdings die Eigenschaft Adresse des ReplyTo-Nachrichtenaustauschprogramms (MEP) nicht angeben. Falls die Eigenschaft angegeben sein sollte, wird sie ignoriert.

Nach der Generierung der Haupt-MEPs sucht der Knoten an verschiedenen Stellen nach einzelnen Teilen der Kontextinformationen, um diese in den Referenzparametern (Reference Parameters) der Eigenschaft ReplyTo in einem <wmb:context>-Element zu übergeben. Die Informationen werden nur hinzugefügt, wenn die folgenden Ordner existieren und nicht leer sind:
  • Destination.SOAP.Request.UserContext

    Diese Information wird einem Unterordner namens UserContext hinzugefügt.

  • Destination.SOAP.Reply.WSA

    Diese Information wird einem Unterordner namens ReplyWSA hinzugefügt.

  • Destination.SOAP.Reply.Identifier

    Diese Information wird einem Unterordner namens ReplyID hinzugefügt.

SOAPAsyncResponse-Knoten

Nach Erhalt der Antwort entfernt der SOAPAsyncResponse-Knoten alle WS-Adressierungsheader aus der Antwortnachricht und fügt sie in den Ordner SOAP.Response.WSA ein. Sie können die Header in diesem Ordner abfragen.

Das Element <wmb:context> und sein Inhalt wird allerdings nicht in diesen Ordner eingefügt. Stattdessen werden die Informationen dieses Elements verarbeitet und an den erwarteten Stellen in der assemblierten Nachricht, die den SOAPAsyncResponse-Knoten verlässt, eingefügt. Sie können daher im Originalnachrichtenfluss auf den Benutzerkontext und die ursprünglichen Antwortheader der WS-Adressierung zugreifen.

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