WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

HTTPReply-Knoten

Verwenden Sie den HTTPReply-Knoten, um eine Antwort vom Nachrichtenfluss an einen HTTP-Client zu liefern. Dieser Knoten generiert die Antwort für einen HTTP-Client, von dem die Eingabenachricht durch den HTTPInput-Knoten empfangen wurde, und wartet auf die Bestätigung, dass sie gesendet wurde.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Der HTTPReply-Knoten kann in jedem Nachrichtenfluss verwendet werden, der eine Antwort an HTTP- oder HTTPS-Nachrichten senden muss. Das häufigste Beispiel für dieses Szenario ist ein Nachrichtenfluss, durch den ein Web-Service implementiert wird.

Weitere Informationen zu Web-Services finden Sie unter Web-Service-Nachrichten verarbeiten.

Standardmäßig werden HTTP-Nachrichten vom brokerweiten Empfangsprogramm verarbeitet; dieses wird beim Start eines Nachrichtenflusses, der einen HTTP-Knoten enthält, ebenfalls gestartet. Alle eingehenden und ausgehenden HTTP-Nachrichten werden durch dieses Empfangsprogramm geleitet, und zwar für falle HTTP-Knoten, die in allen Nachrichtenflüssen in allen Ausführungsgruppen auf dem Broker implementiert werden.

Sie können die Ausführungsgruppe so konfigurieren, dass sie mithilfe ihres eingebetteten Empfangsprogramms die HTTP-Knoten in allen Nachrichtenflüssen verarbeitet, die für diese Ausführungsgruppe implementiert sind. Das eingebettete Empfangsprogramm kommuniziert direkt mit dem Client und den Knoten.

Weitere Informationen zur Verwendung des eingebetteten Empfangsprogramms finden Sie unter HTTP-Empfangsprogramme.

Der HTTPReply-Knoten eignet sich nicht für die Antwort auf eine Web-Service-Anforderung, die von einem SOAPInput-Knoten empfangen wird; der Broker generiert eine Ausnahmebedingung, wenn versucht wird, zu antworten.

Wenn Sie die Ausführungsgruppe für die Nutzung des zugehörigen Empfangsprogramms für HTTP-Knoten konfiguriert haben, müssen Sie den Fluss, der den HTTPReply-Knoten enthält, in der Ausführungsgruppe implementieren, die den HTTPInput-Knoten enthält. Wenn Ihr Broker so konfiguriert ist, dass zur Unterstützung von HTTP-Knoten das brokerweite Empfangsprogramm gestartet wird, müssen Sie den Antwortfluss in demselben Broker implementieren - die Ausführungsgruppe spielt jedoch keine Rolle, da das Empfangsprogramm gemeinsam genutzt wird.

Der HTTPReply-Knoten erstellt für den Web-Service-Client eine Antwortnachricht auf Basis der gesamten Nachrichtenbaumstruktur der Eingabe, die an den Anforderer zurückgegeben wird. Wenn die Nachricht anfangs von einem HTTPInput-Knoten in einem anderen Nachrichtenfluss empfangen wurde, wird die Reaktion über eine Anforderungskennung, die in der lokalen Umgebung der Nachricht vom HTTPInput-Knoten gespeichert wird, mit der Antwort verknüpft.

Der HTTPReply-Knoten befindet sich im HTTP-Fach der Palette und wird in WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für HTTPReply-Knoten

Ausgabeterminals mit einem anderen Knoten verbinden

Schließen Sie das Ausgabe- oder Fehlerterminal (Failure) dieses Knotens an einen anderen Knoten in diesem Nachrichtenfluss an, um die Nachricht weiterzuverarbeiten, Fehler zu behandeln oder die Nachricht an eine weitere Zieladresse zu senden.

Terminals und Eigenschaften

Nachdem Sie eine Instanz des HTTPReply-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Eigenschaften des Knotens werden in der Ansicht 'Eigenschaften' angezeigt. Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

In der folgenden Tabelle werden die HTTPReply-Knotenterminals beschrieben .

Terminal Beschreibung
Eingabeterminal (In) Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Fehlerterminal (Failure) Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn während der Weitergabe der Nachricht ein Fehler auftritt.
Ausgang Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich übergeben wurde und in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss für die Implementierung zur BAR-Datei hinzugefügt wird).

In der folgenden Tabelle werden die Beschreibungseigenschaften des HTTPReply-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein HTTPReply Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens.
Langbeschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

In der folgenden Tabelle werden die grundlegenden Eigenschaften des HTTPReply-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Transportfehler ignorieren Ja Nein Ausgewählt Aktivieren Sie das Kontrollkästchen Transportfehler ignorieren, wenn transportbezogene Fehler ignoriert werden sollen (wenn beispielsweise keine Verbindung zum Client besteht). Wenn Sie das Kontrollkästchen inaktivieren und ein transportbezogener Fehler auftritt, wird die Eingabenachricht an das Fehlerterminal (Failure) weitergegeben. Bei Inaktivierung des Kontrollkästchens müssen Sie einen Wert für Zeitlimit für Antwortübergabe (Sekunden) angeben.
Zeitlimit für Senden der Antwort (Sekunden) Ja Nein 120 Legen Sie den Wert Zeitlimit für Antwortübergabe (Sekunden) fest, wenn Transportfehler nicht ignoriert werden sollen. Diese Eigenschaft gibt die Zeit in Sekunden an, die der Knoten auf die Bestätigung wartet, dass der Client die Antwort empfangen hat. Wird die Bestätigung innerhalb dieser Zeitspanne empfangen, wird die Eingabenachricht über das Ausgangsterminal (falls angeschlossen) an den übrigen Nachrichtenfluss weitergegeben. Andernfalls wird die Eingabenachricht über das Fehlerterminal (Failure) weitergegeben, falls es angeschlossen ist. Wenn das Fehlerterminal (Failure) nicht angeschlossen ist und nicht rechtzeitig eine Bestätigung eingeht, wird eine Ausnahmebedingung generiert.

Der gültige Bereich liegt zwischen null (unendliche Wartezeit) und (231)-1. Diese Eigenschaft ist nur gültig, wenn das Kontrollkästchen Transportfehler ignorieren nicht aktiviert ist.

HTTP-Standard-Header auf Basis von Antwort generieren Ja Nein Ausgewählt Aktivieren Sie HTTP-Standard-Header auf Basis der Antwort generieren, wenn die standardmäßigen Header des Web-Service mit Werten aus dem HTTPReplyHeader oder dem HTTPResponseHeader erstellt werden sollen. Wenn der entsprechende Header nicht in der Eingabenachricht vorhanden ist, werden Standardwerte verwendet.

Der Knoten fügt in den HTTPReplyHeader immer einen Header des Typs 'Content-Length' ein, der auf den richtigen errechneten Wert gesetzt ist, selbst wenn dieser Header nicht Bestandteil der ursprünglichen Anforderung war.

In der folgenden Tabelle werden die Auswertungseigenschaften des HTTPReply-Knotens beschrieben.

Wenn eine Nachricht an das Fehlerterminal des Knotens weitergegeben wird, wird sie nicht ausgewertet. Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswerten Nein Ja Übernehmen Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen. validateMaster
Fehlerbehebungsmaßnahme Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angeben, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste.  
Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft O K Standardwert Beschreibung
Ereignisse Nein Nein Ohne Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss Überwachungsereignisse definiert. Über Hinzufügen, Bearbeiten und Löschen können Sie Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren).

Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:19:52


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac04585_