HTTPReply-Knoten

Verwenden Sie den HTTPReply-Knoten, um eine Antwort vom Nachrichtenfluss an einen HTTP-Client zurückzugeben. 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 HTTP- oder HTTPS-Nachrichten annehmen muss. Das häufigste Beispiel hierfür ist ein Nachrichtenfluss, durch den ein Web-Service implementiert wird. Weitere Informationen zu Web-Service-Anwendungen finden Sie unter Web-Service-Anwendungen.

Wenn Sie einen HTTPReply-Knoten in einen Nachrichtenfluss einfügen, müssen Sie entweder einen HTTPInput-Knoten in demselben Fluss einfügen, oder die Nachricht muss von einem anderen Fluss empfangen werden, der im selben Broker aktiv ist und mit einem HTTPInput-Knoten anfing. Diese Antwort wird durch eine Anforderungs-ID, die in der lokalen Umgebung vom HTTPInput-Knoten gespeichert wird, mit der Antwort verknüpft.

Dieser Knoten erstellt für den Web-Service-Client eine Antwortnachricht auf Basis der gesamten Nachrichtenbaumstruktur der Eingabe, die an den Anforderer zurückgegeben wird.

Der HTTPReply-Knoten befindet sich im HTTP-Fach der Palette und wird in Workbench durch folgendes Symbol dargestellt:

Symbol für HTTPAntwortknoten

Den HTTPReplyknoten konfigurieren

Nachdem Sie eine Instanz des HTTPReplyknotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

Konfigurieren Sie denHTTPReply -Knoten.

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine Ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Auf der Registerkarte Grundeinstellungen:
    1. 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 weitergegeben. Bei Inaktivierung des Kontrollkästchens müssen Sie einen Wert für Zeitlimit für Antwortübergabe (Sekunden) angeben.
    2. 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 weitergegeben, falls es angeschlossen ist. Wenn das Fehlerterminal nicht angeschlossen ist und nicht rechtzeitig eine Bestätigung eingeht, wird eine Ausnahmebedingung generiert.
    3. 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 dies nicht Bestandteil der ursprünglichen Anforderung war.

  3. Legen Sie auf der Registerkarte Auswertung die Auswertungseigenschaften fest, siehe Auswertungseigenschaften. Berücksichtigen Sie, dass eine Nachricht, die an das Fehlerterminal des Knotens übergeben wird, nicht ausgewertet wird.

    Nähere Informationen finden Sie unter Nachrichten überprüfen.

Ausgabeterminals mit einem anderen Knoten verbinden

Schließen Sie das Ausgabe- oder Fehlerterminal 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

In der folgenden Tabelle werden die HTTPReply-Knotenterminals beschrieben .

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

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

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

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Knotentyp, z. B. HTTPReply Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

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

Eigenschaft M C Standardwert Beschreibung
Transportfehler ignorieren Ja Nein Ausgewählt Wenn Sie das Kontrollkästchen aktivieren, werden transportbezogene Fehler ignoriert.
Zeitlimit für Senden der Antwort (Sekunden) Ja Nein 120 Die Zeit in Sekunden, die der HTTPReplyknoten wartet, bis er davon ausgeht, dass die Antwort nicht an den Client zugestellt werden konnte. 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 Wenn Sie das Kontrollkästchen aktivieren, werden die Header für den standardmäßigen Web-Service mit Hilfe der Werte vom HTTPReplyHeader oder HTTPResponseHeader erstellt.

In der folgenden Tabelle werden die Auswertungseigenschaften des HTTPReplyknotens beschrieben.

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft M C Standardwert Beschreibung
Auswerten Nein Ja Übernehmen Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen.
Aktion bei Fehler 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.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac04585_