Broker implementiert neue Web-Service-Schnittstelle

In diesem Szenario implementiert der Broker eine neue Web-Service-Schnittstelle. Die WSDL für den Web-Service wird aus einer Nachrichtengruppe generiert und den Clients zur Verfügung gestellt. Ein auf dieser WSDL und der Nachrichtengruppe basierender Nachrichtenfluss empfängt eine Anforderung und erstellt daraufhin eine Antwortnachricht aus Daten, die er von einer bestehenden Anwendung erhält, die kein Web-Service ist.

Dieses Diagramm zeigt eine Nachrichtengruppe, die aus einer Schnittstellendefinition (z. B. aus einer Headerdatei) einer bestehenden Anwendung erstellt wurde, die zur Zeit nicht als Web-Service zugänglich ist. Aus der Nachrichtengruppe wird eine WSDL-Datei generiert und für die Verwendung durch einen Web-Service-Client exportiert. Zum Aufruf der Anwendung wird ein auf der Nachrichtengruppe und der WSDL basierender Nachrichtenfluss erstellt. Der Nachrichtenfluss und die Nachrichtengruppe werden in einem Broker implementiert. Dadurch wird der Ursprungsanwendung eine Web-Service-Schnittstelle zur Verfügung gestellt.

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.

Dieses Szenario wird manchmal als Web-Service-Fassade bezeichnet. Das Design der Web-Service-Schnittstelle besteht in der Regel aus einigen Umgruppierungen, Einschränkungen oder Erweiterungen der bestehenden Schnittstellen und wird nicht durch eine bestehende WSDL-Definition eingeschränkt.

Mögliche Einsatzbereiche

Entwicklungsschritte

  1. Erstellen Sie eine Nachrichtengruppe für Geschäftsnachrichten, indem Sie beispielsweise eine bestehende Schnittstellendefinition, z. B. eine C-Headerdatei oder ein COBOL-Copy Book, importieren.
  2. Generieren Sie aus der Nachrichtengruppe eine WSDL-Definition.
  3. Erstellen Sie mit Hilfe eines SOAP-Toolkits (z. B. Rational Application Developer) einen geeigneten Web-Service-Client auf Basis der WSDL-Definition.
  4. Entwickeln Sie einen Nachrichtenfluss, um den Web-Service zu implementieren.

Laufzeit

Ihr Nachrichtenfluss empfängt eine Web-Service-Anforderung, wandelt sie in ein von der bestehenden Anwendung erwartetes Format um und ruft die bestehende Anwendung auf. Die Antwort von der bestehenden Anwendung wird in eine gültige Web-Service-Antwort umgewandelt.

Beispiel 1

In diesem Beispiel wird ein bestehender Nachrichtenfluss so modifiziert, dass er einen Web-Service bereitstellt. Falls die Daten des bestehenden Nachrichtenflusses in einer Nachrichtengruppe modelliert sind, kann aus dieser Nachrichtengruppe eine WSDL-Definition generiert und den Clients zur Verfügung gestellt werden.

Die meisten Nachrichtenflüsse, die WebSphere MQ derzeit für Ein- oder Ausgabeoperationen verwenden, können so angepasst werden, dass sie Web-Services als Ersatz oder zusätzliches Protokoll unterstützen.

Nachfolgend finden Sie typische Nachrichtenflussmuster für dieses Beispiel. In jedem dieser Fälle ersetzen oder ergänzen die Empfangs- und Antwortknoten die ursprünglichen MQInput- und MQOutput-Knoten. Der größte Teil des Nachrichtenflusses erfüllt nützliche Verarbeitungsaufgaben.

1. Verwendung der SOAPInput- und SOAPReply-Knoten:

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

2. Verwendung der HTTPInput- und HTTPReply-Knoten:

Dies ist ein Nachrichtenfluss mit den Knoten 'HTTP Input', 'Compute1' und 'HTTP Reply'.

Bei Verwendung der SOAP-Domäne unterscheidet sich der Aufbau der logischen Baumstruktur von der ursprünglichen Domäne. Dies muss im Nachrichtenfluss berücksichtigt werden. Bei Verwendung der HTTP-Knoten mit der ursprünglichen Domäne bleibt der Aufbau der logischen Baumstruktur unverändert. Informationen zur Auswahl der Domäne finden Sie im Abschnitt WebSphere Message Broker und Web-Services.

HTTP-Details
Wenn Sie die HTTP-Knoten verwenden, können Sie den HTTPReply-Knoten so konfigurieren, dass er für die an den Client gesendete Antwortnachricht einen Satz von HTTP-Standard-Headern generiert. Dadurch verringern sich die Änderungen, die Sie durchführen müssen, um den Nachrichtenfluss so umzuwandeln, dass er statt WebSphere MQ-Nachrichten HTTP-Nachrichten verarbeitet.

Beispiel 2

In diesem Beispiel wird ein Nachrichtenfluss erstellt, der asynchronen Zugriff auf eine WebSphere MQ-Anwendung bereitstellt.

Nachfolgend finden Sie typische Nachrichtenflussmuster für dieses Beispiel. In jedem dieser Fälle empfängt der Nachrichtenfluss eine Web-Service-Anforderung und erstellt die Antwortnachricht aus Daten, die via MQ von der Anwendung zurückgegeben werden.

1. Verwendung von zwei Nachrichtenflüssen mit SOAPInput- und SOAPReply-Knoten:

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

2. Verwendung von zwei Nachrichtenflüssen mit HTTPInput- und HTTPReply-Knoten:

Dies sind zwei Nachrichtenflüsse. Der erste Nachrichtenfluss enthält die Knoten 'HTTP Input', 'Compute1' und 'MQOutput'. Der zweite Nachrichtenfluss enthält die Knoten 'MQInput', 'Compute2' und 'HTTP Reply'.

In beiden Fällen empfängt der erste Nachrichtenfluss ankommende Anforderungen von einem Web-Service-Client. Der Knoten 'Compute1' wandelt die Anforderung um, und ein MQOutput-Knoten sendet die geänderte Anforderung an die bestehende Anwendung.

Im zweiten Nachrichtenfluss empfängt ein MQInput-Knoten die Antwort der Anwendung. Der Compute2-Knoten wandelt die Nachricht daraufhin um und leitet sie an einen Antwortknoten weiter, der dem ursprünglichen Web-Service-Client antwortet.

Zudem muss der Compute1-Knoten einige Korrelationsdaten speichern, die vom Compute2-Knoten abgerufen werden, um sicherzustellen, dass die Antworten von der WebSphere MQ-Anwendung an den Client zurückgegeben werden, der die ursprüngliche Anforderung gesendet hat.

HTTP-Details

Verwendung der HTTPInput- und MQOutput-Knoten für die abgehende Nachricht und der MQInput- und HTTPReply-Knoten für die Antwortnachricht:

Dies sind zwei Nachrichtenflüsse. Der erste enthält die Knoten 'HTTPInput', 'Compute1' und 'MQOutput'. Der zweite enthält die Knoten 'MQInput', 'Compute2' und 'HTTPReply'. Der MQOutput-Knoten am Ende des ersten Nachrichtenflusses stellt eine Nachricht in eine WebSphere MQ-Warteschlange, die von einer vorhandenen Anwendung bedient wird, die ihre Antworten in die Eingabewarteschlange stellt, die wiederum vom MQInput-Knoten am Anfang des zweiten Nachrichtenflusses bedient wird.

Eine Möglichkeit, die Korrelationsdaten zu bewahren, besteht in der Verschlüsselung der HTTP-Anforderungskennung in der abgehenden Nachricht durch den Compute1-Knoten. (Eine alternative Möglichkeit wäre das Speichern der Anforderungskennung in einer Datenbank). Der HTTPInput-Knoten stellt die Anforderungs-ID im Feld 'Destination.HTTP.RequestIdentifier' in der Baumstruktur 'LocalEnvironment' bereit. Der Compute1-Knoten kann diesen Wert lesen und speichern.

Der Compute2-Knoten liest die HTTP-Anforderungs-ID aus der Nachricht und legt 'LocalEnvironment.Destination.HTTP.RequestIdentifier' auf Basis dieses Wertes fest. Der HTTPReply-Knoten stellt anhand der Anforderungs-ID sicher, dass die Nachricht den richtigen HTTP-Client erreicht.

Die Implementierung dieses Szenarios erfordert eine korrekte Handhabung des MQMD. Aus allen Nachrichten, die über WebSphere MQ eingehen, muss der MQMD-Header entfernt werden, bevor sie an einen HTTPReply- oder HTTPRequest-Knoten gesendet werden (außer wenn ein MQMD-Header im HTTP-Datenstrom gewünscht wird).

Fügen Sie im ESQL-Modul für den Compute1-Knoten eine Anweisung wie die folgende ein:
SET OutputRoot.XMLNS.A.MessageID =    
			CAST(InputLocalEnvironment.Destination.HTTP.RequestIdentifier AS CHARACTER);
Fügen Sie im ESQL-Modul für den Compute2-Knoten eine Anweisung wie die folgende ein:
SET OutputLocalEnvironment.Destination.HTTP.RequestIdentifier =     
			CAST(InputRoot.XMLNS.A.MessageID AS BLOB);
Zugehörige Konzepte
Web-Services, WSDL und Nachrichtenflüsse
Broker ruft bestehenden Web-Service auf
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
ac34540_