HTTP-Transportprotokoll mit Message Broker verwenden

In diesem Abschnitt wird das Senden und Empfangen von Dokumenten zwischen WebSphere Partner Gateway und WebSphere Business Integration Message Broker unter Verwendung des HTTP-Transportprotokolls beschrieben.

Anmerkung: Alle Verweise auf das HTTP-Transportprotokoll sind ebenso auf HTTPS anwendbar.

Erforderliche Komponenten für den Austausch von Dokumenten über den HTTP-Transport

Zum Senden und Empfangen von Dokumenten zwischen WebSphere Partner Gateway und Message Broker über das HTTP-Protokoll benötigen Sie keine weitere Software. Benötigt werden lediglich WebSphere Partner Gateway und Message Broker. Für die Kommunikation von WebSphere Partner Gateway mit Version 5.0 von Message Broker über das HTTP-Transportprotokoll müssen diese beiden Komponenten konfiguriert werden. In Tabelle 65 sind diese Konfigurationsschritte zusammenfasst.

Tabelle 65. WebSphere Partner Gateway und Message Broker konfigurieren
Komponente Version Weitere Informationen unter...
WebSphere Partner Gateway 6.0

Dokumentenversand über das HTTP-Transportprotokoll konfigurieren

Dokumenteneingang über das HTTP-Transportprotokoll konfigurieren

WebSphere Business Integration Message Broker 5.0 Message Broker konfigurieren

Darüber hinaus müssen Sie zum Senden oder Empfangen eines Dokuments zwischen WebSphere Partner Gateway und Message Broker über das HTTP-Transportprotokoll die Version 5.3 von IBM WebSphere MQ als JMS-Provider einsetzen.

Dokumente über den HTTP-Transport senden

Beim Senden eines Dokuments von WebSphere Partner Gateway an Message Broker über das HTTP-Transportprotokoll verwenden Sie spezielle HTTP-Transportknoten innerhalb des Message Broker-Nachrichtenflusses, um das von WebSphere Partner Gateway als HTTP-Datenstrom gesendete Dokument abzurufen. Die Knoten des Nachrichtenflusses führen die erforderliche Verarbeitung aus und leiten das Dokument anschließend an ein Ziel (eine JMS-Ausgabewarteschlange) weiter.

Die folgenden Schritte beschreiben, wie WebSphere Partner Gateway über das HTTP-Transportprotokoll ein Dokument an einen Nachrichtenfluss in Message Broker sendet:

  1. WebSphere Partner Gateway sendet eine HTTP-Nachricht an Message Broker.

    Wenn der Pakettyp des Dokuments 'Back-End-Integrationspaket' ist, wurden von WebSphere Partner Gateway angepasste Eigenschaften in dieser Nachricht bereitgestellt.

    Anmerkung: Innerhalb von WebSphere Partner Gateway müssen Sie ein Gateway konfigurieren, das die URL-Adresse angibt, an die WebSphere Partner Gateway die Nachricht sendet und die von Message Broker abgefragt wird. Weitere Informationen finden Sie im Abschnitt Dokumentenversand über das HTTP-Transportprotokoll konfigurieren.
  2. Der HTTPInput-Knoten des Nachrichtenflusses nimmt das Dokument auf und sendet es an den nächsten Knoten des Nachrichtenflusses. Dieser Knoten ist in der Regel ein Berechnungsknoten (Compute-Knoten).
  3. Die Knoten des Nachrichtenflusses führen die Geschäftslogik aus.

    Wenn die Geschäftslogik abgeschlossen ist, sendet der Nachrichtenfluss das resultierende Dokument an den HTTPReply-Knoten.

  4. Der HTTPReply-Knoten sendet die Ausgabenachricht standardmäßig an den Client (WebSphere Partner Gateway) zurück.

    Alternativ kann der Nachrichtenfluss die Nachricht in einen MQOutput-Knoten stellen. Der MQOutput-Knoten empfängt das Dokument und sendet es an die vorgesehene JMS-Warteschlange bzw. an eine andere Anwendung.

Dokumente über den HTTP-Transport empfangen

Zum Empfangen eines Dokuments von Message Broker durch WebSphere Partner Gateway über das HTTP-Transportprotokoll verwenden Sie spezielle HTTP-Transportknoten innerhalb des Message Broker-Nachrichtenflusses, um das Dokument, das von WebSphere Partner Gateway empfangen werden soll, als HTTP-Datenstrom zu senden. Die Knoten des Nachrichtenflusses führen die erforderliche Verarbeitung aus und erledigen die Anforderung und die Antwort (bei synchroner Interaktion) mit WebSphere Partner Gateway.

Die folgenden Schritte beschreiben, wie WebSphere Partner Gateway über das HTTP-Transportprotokoll ein Dokument von einem Nachrichtenfluss in Message Broker empfängt:

  1. Der Nachrichtenfluss innerhalb von Message Broker empfängt ein Dokument in seinem MQInput-Knoten (einer JMS-Eingabewarteschlange).
  2. Der MQInput-Knoten des Nachrichtenflusses empfängt das Dokument und sendet es an den HTTPRequest-Knoten.
  3. Der HTTPRequest-Knoten führt die Anforderungs- und Antwortinteraktionen mit dem Client (WebSphere Partner Gateway) über die angegebene URL-Adresse aus.
  4. WebSphere Partner Gateway empfängt die Nachricht von der zugehörigen URL-Adresse, die als Ziel konfiguriert ist.

    Weitere Informationen zum Ziel finden Sie im Abschnitt Dokumenteneingang über das HTTP-Transportprotokoll konfigurieren.

Nachrichtenfluss für den HTTP-Transport erstellen

Ein Message Broker-Nachrichtenfluss verwendet zur Verarbeitung von Dokumenten über das HTTP-Transportprotokoll die folgenden Transportknoten:

Die Verwendungsreihenfolge dieser Transportknoten hängt wie folgt von der Kommunikationsrichtung ab:

Tabelle 66. Knoten zum Senden von Dokumenten an Message Broker über HTTP
Knotentyp Zweck Anmerkungen
HTTPInput Empfängt das WebSphere Partner Gateway-Anforderungsdokument in einem Nachrichtenfluss.

Setzen Sie das Feld für den URL-Selektor (URL Selector) in den Basiseigenschaften (Basic Properties) dieses Transportknotens auf die URL-Adresse, an die WebSphere Partner Gateway Dokumente sendet (die URL-Adresse, die im WebSphere Partner Gateway-Ziel konfiguriert ist). Die URL-Adresse muss folgendes Format haben:

http://hostname:port/pfad

Dabei ist hostname der Name des Computers, auf dem sich Message Broker befindet, port die HTTP-Portnummer, an der Message Broker empfangsbereit ist, und pfad die Angabe der Position auf diesem Computer.

Weitere Informationen finden Sie im Abschnitt Dokumentenversand über das HTTP-Transportprotokoll konfigurieren.

Compute Führt die Operationen der Geschäftslogik aus, z. B. die Aktualisierung von Headerinformationen. Verwenden Sie ESQL zur Ausführung der Geschäftslogik. Der Berechnungsknoten sendet die resultierende Nachricht an den HTTPReply-Knoten.
HTTPReply Gibt eine Antwort an WebSphere Partner Gateway zurück. Standardmäßig sendet dieser Knoten die Ausgabenachricht an den Client. Sie können ihn jedoch auch zum Senden an einen MQOutput-Knoten konfigurieren.
MQOutput Empfängt das Dokument vom HTTPReply-Knoten und sendet es an WebSphere Partner Gateway. Dieser Transportknoten sendet das resultierende Dokument an eine JMS-Ausgabewarteschlange, die sie an das nächste Ziel weiterleitet.
Tabelle 67. Knoten zum Empfangen von Dokumenten von Message Broker über HTTP
Knotentyp Zweck Anmerkungen
MQInput Empfängt das Dokument von WebSphere Partner Gateway. Dieser Transportknoten empfängt das eingehende Dokument aus einer JMS-Eingabewarteschlange.
HTTPRequest Führt Anforderungs-/Antwortinteraktionen mit WebSphere Partner Gateway aus.

In diesem Transportknoten muss das Feld der Web-Services-URL-Adresse in den Basiseigenschaften (Basic Properties) auf die URL-Adresse gesetzt werden, an der WebSphere Partner Gateway für Dokumente empfangsbereit ist (die URL-Adresse, die im WebSphere Partner Gateway-Ziel konfiguriert ist). Die URL-Adresse muss folgendes Format haben:

http://hostname:port/bcgreceiver/pfad

Dabei ist hostname der Name des Computers, auf dem sich WebSphere Partner Gateway befindet, port die HTTP-Portnummer, an der die Empfangskomponente (Receiver) von WebSphere Partner Gateway empfangsbereit ist, und pfad die Angabe der Position auf diesem Computer.

Weitere Informationen finden Sie im Abschnitt Dokumenteneingang über das HTTP-Transportprotokoll konfigurieren.

Weitere detaillierte Informationen zur Erstellung und Konfiguration von Nachrichtenflussknoten finden Sie in der Dokumentation zu WebSphere Business Integration Message Broker.

Copyright IBM Corp. 2003, 2005