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.
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.
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.
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:
Wenn der Pakettyp des Dokuments 'Back-End-Integrationspaket' ist, wurden von WebSphere Partner Gateway angepasste Eigenschaften in dieser Nachricht bereitgestellt.
Wenn die Geschäftslogik abgeschlossen ist, sendet der Nachrichtenfluss das resultierende Dokument an den HTTPReply-Knoten.
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.
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:
Weitere Informationen zum Ziel finden Sie im Abschnitt Dokumenteneingang über das HTTP-Transportprotokoll konfigurieren.
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:
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. |
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.