Broker ruft bestehenden Web-Service auf

In diesem Szenario ruft der Broker eine die Implementierung eines vorhandenen Web-Service auf. Die WSDL für den Web-Service ist bereits vorhanden und wird für die Zusammenstellung einer Nachrichtengruppe importiert. Ein auf dieser Nachrichtengruppe basierender Nachrichtenfluss sendet eine Web-Service-Anforderung und erhält die Antwort beispielsweise über einen SOAPRequest-Knoten.

Das Diagramm zeigt einen vorhandenen Web-Service sowie die WSDL mit der Beschreibung des Service. Die WSDL wird für die Zusammenstellung einer Nachrichtengruppe importiert. Zum Aufruf des Web-Service wird ein auf der Nachrichtengruppe basierender Nachrichtenfluss erstellt, und beide werden in einem Broker implementiert.

Beschreibung der Symbole:

Dieses Diagramm beschreibt die in den anderen Diagrammen verwendeten Symbole und wird an dieser Stelle nicht beschrieben, weil es zu jedem der Diagramme eine eigene Beschreibung gibt.

Mögliche Einsatzbereiche

Entwicklungsschritte

  1. Importieren Sie eine WSDL-Definition, um eine Nachrichtengruppe mit Definitionen für die SOAP-Nachrichten, die von der WSDL beschrieben werden, zu erstellen.
  2. Erstellen Sie einen Nachrichtenfluss, um den Web-Service aufzurufen. Bei Verwendung der SOAP-Domäne nutzt der Nachrichtenfluss einen SOAPRequest-Knoten, einen SOAPAsyncRequest-Knoten oder einen SOAPAsyncResponse-Knoten. Die Knoten werden mittels der in Schritt 1 importierten WSDL konfiguriert. Bei Bedarf kann die WSDL auf einen leeren Erstellungsbereich des Nachrichtenflusseditors gezogen werden, um ein völlig neues Nachrichtenflussgerüst zu erstellen. Wenn keine SOAP-Domäne verwendet wird, muss der Nachrichtenfluss mittels Transportknoten und einer XML- oder MIME-Domäne konstruiert werden. Gibt die WSDL-Bindung bei einer SOAP-Anforderungsnachricht beispielsweise HTTP-Transport an, kann bei Verwendung der XMLNSC-Domäne ein HTTPRequest-Knoten verwendet werden. In diesem Fall können Sie die Endpunktinformationen für den Web-Service manuell für den Knoten konfigurieren.
  3. Erstellen Sie eine Brokerarchivdatei für die Implementierung. Die Brokerarchivdatei enthält Ihren Nachrichtenfluss und die Nachrichtengruppe mit der importierten WSDL. Für die SOAP-Domäne muss die WSDL auf jeden Fall implementiert sein, da die Nachrichten während der Laufzeit anhand der WSDL überprüft werden. Außerdem werden die WSDL-Informationen zur logischen Baumstruktur hinzugefügt. Die Nachrichtengruppe enthält XML-Schemadefinitionen, die in SOAP-, XMLNSC- oder MRM-Domänen für die Nachrichtenüberprüfung verwendet werden können.

Laufzeit

Ihr Nachrichtenfluss erstellt eine entsprechend formatierte Web-Service-Anforderung, ruft den Web-Service auf und wertet die Web-Service-Antwort aus. Bei Verwendung der SOAP-Domäne greift Ihr Nachrichtenfluss auf das logische Baumstrukturmodell von SOAP zurück. Anderenfalls verwendet der Nachrichtenfluss die logische Baumstruktur der ausgewählten Domäne, beispielsweise der MIME-Domäne, falls Ihre Web-Service-Nachrichten SOAP mit Anhängen verwenden.

Beispiel 1

Zwischengeschalteter Web-Service
In diesem Beispiel verwendet eine Clientanwendung einen Web-Service namens 'Account', der von einer anderen Organisation bereitgestellt wird. Der Client wird von vielen Mitarbeitern Ihres Unternehmens verwendet. Er verwendet eine Operation namens 'getBalance'. Der Account-Service wird nun aber so modifiziert, dass sich die Definition der Operation 'getBalance' ändert. Statt daraufhin den Client zu bearbeiten, können Sie Nachrichtenflüsse erstellen, die eine Schnittstelle zum Account-Service bereitstellen. Der Nachrichtenfluss kann den Account-Service zur Erledigung seiner Arbeit auffordern, und der neue Web-Service kann diese an den ursprünglichen Web-Service delegieren. Damit kann der Client den Account-Service weiterhin, allerdings mit den neuen Nachrichtenflüssen verwenden.

Nachfolgend finden Sie typische Nachrichtenflussmuster für dieses Beispiel. In jedem dieser Fälle ruft der zwischengeschaltete Anforderungsknoten den Account-Service auf:

1. Verwendung der SOAPInput-, SOAPRequest- und SOAPReply-Knoten:

Dies ist ein Nachrichtenfluss mit den Knoten 'SOAP Input', 'Compute1', 'SOAP Request', 'Compute2' und 'SOAP Reply'.

2. Verwendung der SOAPInput-, SOAPAsyncRequest-, SOAPAsyncResponse- und SOAPReply-Knoten:

Dies sind zwei Nachrichtenflüsse. Der erste Nachrichtenfluss enthält die Knoten 'SOAP Input1', 'Compute1' und 'SOAP Asynchronous Request'. Der zweite Nachrichtenfluss enthält die Knoten 'SOAP Asynchronous Response', 'Compute2' und 'SOAP Reply1'.

3. Verwendung der HTTPInput-, HTTPRequest- und HTTPReplyKnoten:

Dies ist ein Nachrichtenfluss mit den Knoten 'HTTPInput', 'Compute', 'HTTPRequest', 'Compute1' und 'HTTPReply'.

In den Nachrichtenflüssen dieses Beispiels passt 'Compute1' die ursprüngliche 'getBalance'-Nachricht an den geänderten Account-Service an, während 'Compute2' die Antwortnachricht in das Originalformat zurückkonvertiert. Falls Sie eine WSDL importiert oder generiert haben, verfügen Sie bereits über ein Nachrichtenmodell für die Operation 'getBalance'. Sie können in diesem Fall statt der Compute-Knoten die Zuordnung-Knoten verwenden.

HTTP-Details

Wenn Sie die HTTP-Transportknoten wie in diesem Beispiel verwenden, können Sie den HTTPRequest-Knoten so konfigurieren, dass er aus den vom HTTPInput-Knoten empfangenen Headern HTTP-Header generiert. Dadurch können Cookies und andere anwendungsspezifische Header über den Nachrichtenfluss weitergeleitet werden. Der HTTPReply-Knoten kann zum Extrahieren der Header aus der Antwort des Web-Service verwendet werden, um diese an den anfordernden Client zurückzusenden. Dazu müssen Sie sowohl für den HTTPRequest-Knoten als auch für den HTTPReply-Knoten die Option HTTP-Standard-Header auf Basis der Antwort generieren auswählen. Im Allgemeinen benötigen Sie zur Generierung der Antwort an den Client die ursprüngliche Anforderungsnachricht nicht. Sie können daher für den HTTPRequest-Knoten die Option Eingabenachricht durch Antwort des Webservices ersetzen auswählen. Falls Sie die Daten aus der Eingabeanforderung beibehalten möchten, speichern Sie sie in der Baumstruktur 'LocalEnvironment' unter 'Compute1', und rufen Sie sie unter 'Compute2' ab, um sie in die Antwort einzufügen.

Beispiel 2

Verwendung eines Web-Service
In diesem Beispiel wird ein Prozess für die Personalabteilung Ihres Unternehmens durch einen WebSphere MQ-Nachrichtenfluss implementiert. Im Zuge der Verarbeitung ruft der Nachrichtenfluss einen Web-Service auf, um die Mitarbeiter-IDs abzurufen. Mitarbeiter-IDs werden im Mitarbeiterverzeichnis des Unternehmens verwaltet, auf das über einen Web-Service zugegriffen wird. Nachfolgend finden Sie typische Nachrichtenflussmuster für dieses Beispiel. In jedem dieser Fälle ruft der zwischengeschaltete Knoten die Mitarbeiter-ID ab:

1. Verwendung der MQInput-, SOAPRequest- und MQOutput-Knoten:

Dies ist ein Nachrichtenfluss mit den Knoten 'MQInput', 'Compute1', 'SOAP Request', 'Compute2' und 'MQOutput'.

2. Verwendung der MQInput-, SOAPAsyncRequest-, SOAPAsyncResponse- und MQOutput-Knoten:

Dies sind zwei Nachrichtenflüsse. Der erste Nachrichtenfluss enthält die Knoten 'MQInput', 'Compute1' und 'SOAP Asynchronous Request'. Der zweite Nachrichtenfluss enthält die Knoten 'SOAP Asynchronous Response', 'Compute2' und 'MQOutput'.

3. Verwendung der MQInput-, HTTPRequest- und MQOutput-Knoten:

Dies ist ein Nachrichtenfluss mit den Knoten 'MQInput', 'Compute1', 'HTTPRequest', 'Compute2' und 'MQOutput'.

In den Nachrichtenflüssen dieses Beispiels bereitet 'Compute1' die Web-Service-Anforderung vor, während 'Compute2' die Antwort verarbeitet, zum Beispiel durch Einfügen der Mitarbeiter-ID in eine andere Nachricht. Statt der Compute-Knoten können Sie in diesem Beispiel auch Zuordnung-Knoten verwenden.

HTTP-Details

Wenn Sie die HTTP-Transportknoten wie in diesem Beispiel verwenden, empfiehlt es sich in der Regel, die Option Eingabenachricht durch Antwort des Webservices ersetzen in den Eigenschaften des HTTPRequest-Knotens zu inaktivieren. Die Antwort aus dem Verzeichnisserver des Unternehmens wird in ein temporäres Verzeichnis der Nachrichtenbaumstruktur kopiert. Dieses temporäre Verzeichnis wird durch die Eigenschaft Position der Antwortnachricht in Baumstruktur des gleichen Knotens festgelegt. In 'Compute2' können Sie ESQL so codieren, dass das Ergebnis abgerufen und die endgültige Nachricht aktualisiert wird.

Dies ist ein Nachrichtenfluss mit den Knoten 'MQInput', 'Compute1', 'HTTPRequest', 'Compute2' und 'MQOutput'. Der HTTPAnforderungsknoten interagiert mit dem Unternehmensverzeichnisserver über eine HTTP-Verbindung.

In diesen Szenarios sollte bevorzugt die SOAP-Domäne verwendet werden. Weitere Informationen zur Auswahl einer Domäne für Web-Services finden Sie im Abschnitt WebSphere Message Broker und Web-Services.

Zugehörige Konzepte
Web-Services, WSDL und Nachrichtenflüsse
Broker implementiert neue Web-Service-Schnittstelle
Broker implementiert bestehende Web-Service-Schnittstelle
Broker implementiert Schnittstelle, die nicht auf Web-Service basiert, in neuem Web-Service
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac34530_