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.

HTTPHeader-Knoten

Mit dem HTTPHeader-Knoten können Sie HTTP-Header wie beispielsweise HTTPInput, HTTPResponse, HTTPRequest und HTTPReply hinzufügen, ändern oder löschen.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Der HTTPHeader-Knoten stellt eine Toolkit-Schnittstelle zur Verfügung, mit der HTTP-Header ohne Codieraufwand bearbeitet werden können; der Nachrichtenhauptteil wird nicht geändert. Sie können einen gesamten Header hinzufügen bzw. entfernen oder auch nur bestimmte Headereigenschaften bearbeiten. Sie können diese Eigenschaften auf einen festen Wert setzen oder auf einen Wert, der durch einen XPath-Ausdruck zum Aufruf eines Werts in einer der Nachrichtenbaumstrukturen angegeben ist. Mit XPath wird eine gültige Position bereitgestellt, von der ein Wert für eine Eigenschaft kopiert werden kann. Bei dieser Position kann es sich beispielsweise um den Hauptteil der Nachricht, die Baumstruktur der lokalen Umgebung oder um eine Ausnahmeliste handeln.

HTTPInput- und HTTPResponse-Header können nur über die eingehende Nachricht gelöscht oder weitergeleitet werden. Die zugehörigen Headereigenschaften können nicht geändert werden und es können keine weiteren Eigenschaften hinzugefügt werden.

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

Symbol für den Timeout Control-Knoten

Verwendung dieses Knotens in einem Nachrichtenfluss

Ausführliche Informationen zur Verwendung des Knotens finden Sie im folgenden Beispiel:

Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im WebSphere Message Broker Toolkit integrierte Information Center verwendet wird.

Terminals und Eigenschaften

Nachdem Sie eine Instanz des Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Bei diesem Knoten ist die Angabe von Eigenschaften nicht obligatorisch.

In der folgenden Tabelle werden die Terminals des HTTPHeader-Knotens beschrieben:
Terminal Beschreibung
Eingabeterminal (In) Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Fehlerterminal (Failure) Das Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn während der Extraktion ein Fehler auftritt.
Ausgang Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn die Eingabenachricht erfolgreich verarbeitet wird.

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 zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

In der folgenden Tabelle werden die Beschreibungseigenschaften des HTTPHeader-Knotens beschrieben:

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein HTTPHeader 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 HTTPInput-Headereigenschaften beschrieben:
Eigenschaft O K Standardwert Beschreibung
HTTPInput-Headeroptionen Nein Ja Header weiterleiten Optionen für die Steuerung des HTTPInputHeaders als Gesamteinheit.

Wählen Sie Header weiterleiten aus, um eventuell vorhandene Werte aus einer eingehenden Nachricht weiterzuleiten.

Wählen Sie Header löschen aus, um einen eventuell vorhandenen Header zu löschen.

In der folgenden Tabelle werden die HTTPResponse-Headereigenschaften beschrieben:
Eigenschaft O K Standardwert Beschreibung
HTTPResponse-Headeroptionen Nein Ja Header weiterleiten Optionen für die Steuerung des HTTPResponseHeaders als Gesamteinheit.

Wählen Sie Header weiterleiten aus, um eventuell vorhandene Werte aus einer eingehenden Nachricht weiterzuleiten.

Wählen Sie Header löschen aus, um einen eventuell vorhandenen Header zu löschen.

In der folgenden Tabelle werden die HTTPRequest-Headereigenschaften beschrieben:
Eigenschaft O K Standardwert Beschreibung
HTTPRequest-Headeroptionen Nein Ja Header weiterleiten Konfigurieren Sie den HTTPRequest-Header. Diese Optionen sind verfügbar.
Header weiterleiten
Wählen Sie diese Option aus, wenn Sie die Werte aus einer eingehenden Nachricht weiterleiten möchten.
Header hinzufügen
Wählen Sie diese Option aus, wenn Sie dem Header neue Eigenschaften hinzufügen möchten oder bestehende Eigenschaften ändern bzw. löschen möchten.
Header ändern
Wählen Sie diese Option aus, wenn Sie Eigenschaften hinzufügen möchten oder bestehende Eigenschaften ändern bzw. löschen möchten.
Header löschen
Wählen Sie diese Option aus, wenn Sie den HTTPRequest-Header und alle zugehörigen Eigenschaften aus der eingehenden Nachricht entfernen möchten.
Eingehende Werte löschen Nein Ja Nicht ausgewählt Diese Option, die nur aktiviert ist, wenn Header ändern gewählt wurde, entfernt alle vorhandenen Eigenschaftsnamen und zugehörigen Werte aus der eingehenden Nachricht.
HTTPRequest-Header Nein Ja Kein Standardwert Dieses Feld ist nur aktiviert, wenn Sie Header hinzufügen oder Header ändern für die HTTPRequest-Headeroptionen ausgewählt haben. Die Anzeige weist keine vordefinierten Eigenschaften auf; sie wird zur Erstellung angepasster Eigenschaften und Werte verwendet. Fügen Sie mithilfe der Eigenschaftentabelle für den Header neue Eigenschaften hinzu bzw. ändern oder löschen Sie bestehende Eigenschaften. Es besteht keine Begrenzung im Hinblick auf die Anzahl der Eigenschaften. Jede Eigenschaft muss einen Namen und ein Typqualifikationsmerkmal aufweisen. Das Typqualifikationsmerkmal kann Wert, XPath oder Löschen sein.
Wert
Geben Sie einen neuen gültigen Wert für die ausgewählte Eigenschaft ein. Ein Nullwert oder eine leere Zeichenfolge wird ebenfalls als gültiger Wert angesehen.
XPath
Geben Sie einen gültigen XPath-Ausdruck an. WebSphere Message Broker unterstützt XPath-Definitionen, die mit einer XPath-Variablen wie beispielsweise $Root oder $LocalEnvironment beginnen. Wenn mehrere Werte für den XPath-Ausdruck vorhanden sind, wird nur das erste Vorkommen geliefert. (Folgende Beispiele für XPath-Ausdrücke sind gültig: $LocalEnvironment/Host und $Root/HTTPRequest/Content-Type).
Löschen
Geben Sie die Eigenschaft an, die aus der eingehenden Nachricht gelöscht werden soll. Der Wert, welcher der ausgewählten Eigenschaft zugeordnet ist, wird ebenfalls gelöscht.

In der folgenden Tabelle werden die HTTPReply-Headereigenschaften beschrieben:

Eigenschaft O K Standardwert Beschreibung
HTTPReply-Headeroptionen Nein Ja Header weiterleiten Konfigurieren Sie den HTTPReply-Header. Diese Optionen sind verfügbar.
Header weiterleiten
Wählen Sie diese Option aus, wenn Sie die Werte aus einer eingehenden Nachricht weiterleiten möchten.
Header hinzufügen
Wählen Sie diese Option aus, wenn Sie dem Header neue Eigenschaften hinzufügen möchten oder bestehende Eigenschaften ändern bzw. löschen möchten.
Header ändern
Wählen Sie diese Option aus, wenn Sie Eigenschaften hinzufügen möchten oder bestehende Eigenschaften ändern bzw. löschen möchten.
Header löschen
Wählen Sie diese Option aus, wenn Sie den HTTPReply-Header und alle zugehörigen Eigenschaften aus der eingehenden Nachricht entfernen möchten.
Eingehende Werte löschen Nein Ja Nicht ausgewählt Diese Option, die nur aktiviert ist, wenn Header ändern gewählt wurde, entfernt alle vorhandenen Eigenschaftsnamen und zugehörigen Werte aus der eingehenden Nachricht.
HTTPReply-Header Nein Ja Kein Standardwert Dieses Feld ist nur aktiviert, wenn Sie Header hinzufügen oder Header ändern für die HTTPRequest-Headeroptionen gewählt haben. Die Anzeige weist keine vordefinierten Eigenschaften auf; sie wird zur Erstellung angepasster Eigenschaften und Werte verwendet. Fügen Sie mithilfe der Eigenschaftentabelle für den Header neue Eigenschaften hinzu bzw. ändern oder löschen Sie bestehende Eigenschaften. Es besteht keine Begrenzung im Hinblick auf die Anzahl der Eigenschaften. Jede Eigenschaft muss einen Namen und ein Typqualifikationsmerkmal aufweisen. Das Typqualifikationsmerkmal kann Wert, XPath oder Löschen sein.
Wert
Geben Sie einen neuen gültigen Wert für die ausgewählte Eigenschaft ein. Ein Nullwert oder eine leere Zeichenfolge wird ebenfalls als gültiger Wert angesehen.
XPath
Geben Sie einen gültigen XPath-Ausdruck an. WebSphere Message Broker unterstützt XPath-Definitionen, die mit einer XPath-Variablen wie beispielsweise $Root oder $LocalEnvironment beginnen. Wenn mehrere Werte für den XPath-Ausdruck vorhanden sind, wird nur das erste Vorkommen geliefert. (Folgende Beispiele für XPath-Ausdrücke sind gültig: $LocalEnvironment/Host und $Root/HTTPRequest/Content-Type).
Löschen
Geben Sie die Eigenschaft an, die aus der eingehenden Nachricht gelöscht werden soll. Der Wert, welcher der ausgewählten Eigenschaft zugeordnet ist, wird ebenfalls gelöscht.
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:20:25


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac60280_