Verwenden Sie den HTTPInput-Knoten, um eine HTTP-Nachricht von einem HTTP-Client für die Verarbeitung durch einen Nachrichtenfluss zu empfangen.
Dieses Thema ist in folgende Abschnitte eingeteilt:
Bei der Verwendung des HTTPInput-Knotens mit dem HTTPReply- und HTTPRequest-Knoten kann der Broker als Zwischenstation für Web-Services fungieren, und Web-Service-Anforderungen können auf die gleiche Weise umgewandelt und weitergeleitet werden wie andere von WebSphere Nachrichtenbroker unterstützte Nachrichtenformate. Web-Service-Anforderungen können im HTTP-Standardformat (1.0 oder 1.1) oder im HTTP over SSL-Format (HTTPS) empfangen werden. Sie können die Eigenschaft HTTPS verwenden so festlegen, dass Sie die Verarbeitung von HTTP- oder HTTPS-Anfragen auswählen können.
Wenn Ihre Nachrichtenflüsse SOAP-Nachrichten verarbeiten, bevorzugen Sie den SOAP-Knoten gegenüber dem HTTPInput-Knoten, um die erweiterten Funktionen einschließlich WS-Adressierung und WS-Sicherheit zu nutzen.
Wenn Sie den HTTPInputsknoten in einen Nachrichtenfluss einfügen, müssen Sie entweder einen HTTPReplyknoten in demselben Fluss einfügen oder die Nachricht an einen anderen Fluss übergeben, der einen HTTPReplyknoten enthält (beispielsweise über einen MQOutputknoten an einen zweiten Fluss, der mit einem MQInputsknoten beginnt). Im zweiten Fall (der Anforderung von und Antwort an) werden die Clients von der Anforderungs-ID koordiniert, die in der lokalen Umgebung gespeichert ist.
Der HTTPInputsknoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:
Wenn der HTTPInput-Knoten eine Nachricht von einem Web-Service-Client erhält, startet er die entsprechenden Parser, um die Header und den Hauptteil der Nachricht zu interpretieren und die Nachrichtenbaumstruktur zu erzeugen, die intern vom Nachrichtenfluss verwendet wird. Der Knoten erstellt eine eindeutige Kennung für die Eingabenachricht und speichert diese unter LocalEnvironment.Destination.HTTP.RequestIdentifer als binären Bereich mit 24 Bytes in der Baumstruktur 'LocalEnvironment'. Dieser Wert wird vom HTTPReplyknoten verwendet und darf auf keine Weise geändert werden.
HTTP-Nachrichten sind niemals permanent und haben keine bestimmte Reihenfolge.
HTTP-Nachrichten sind nicht transaktionsorientiert. Wenn der Nachrichtenfluss jedoch mit einer Datenbank oder einer anderen externen Ressource, z. B. einer WebSphere MQ-Warteschlange, interagiert, werden diese Interaktionen in einer Transaktion ausgeführt. Der HTTPInputsknoten bietet eine COMMIT-Operation (Festschreiben) oder ROLLBACK-Operation (Zurücksetzen) an. Dies ist abhängig davon, wie der Nachrichtenfluss beendet wurde, und wie er für die Fehlerbehandlung konfiguriert ist (z. B. wie die Fehlerterminals verbunden sind). Wenn der Nachrichtenfluss von diesem Knoten zurückgesetzt wird, wird eine Fehlernachricht generiert und an den Client ausgegeben. Das Format des Fehlers wird in der Eigenschaft Falsches Format definiert.
Falls in diesem Nachrichtenfluss eine Ausnahmebedingung eintritt und diese nicht abgefangen, sondern an diesen Knoten zurückgegeben wird, erstellt der Knoten eine Fehlerantwort an den Client. Dieser Fehler wird von der Ausnahmebedingung abgeleitet, und das Format des Fehlers wird durch die Eigenschaft Falsches Format definiert.
Wenn Sie einen Sendeknoten in einen Nachrichtenfluss einschließen, der mit einem HTTPInputsknoten beginnt, können Sie einen beliebigen unterstützten Sendeknoten (einschließlich benutzerdefinierter Sendeknoten) verwenden. Sie können einen Nachrichtenfluss erstellen, der Nachrichten von Web-Service-Clients empfängt und Nachrichten für Clients generiert, die alle unterstützten Transportmethoden zur Verbindung mit dem Broker verwenden. Sie können den Nachrichtenfluss so konfigurieren, dass der Broker auf Anforderung alle erforderlichen Konvertierungen bereitstellt.
Wenn Sie einen Nachrichtenfluss erstellen, der als untergeordneter Nachrichtenfluss eingesetzt werden soll, können Sie keinen Standardempfangsknoten verwenden. Sie müssen eine Instanz des Inputsknotens als ersten Knoten verwenden, um ein Eingangsterminal für den untergeordneten Nachrichtenfluss zu erstellen.
Empfängt Ihr Nachrichtenfluss keine Web-Service-Anforderungen, können Sie einen der anderen Empfangsknoten verwenden.
Der HTTPInput-Knoten befindet sich im HTTP-Fach der Palette und wird in Workbench durch folgendes Symbol dargestellt:

/Joe /Joe/Mary /Joe/* /*wird bei diesem Format die Nachricht empfangen, wenn keiner der anderen Knoten mit dieser Anforderung übereinstimmt. Mit der Anforderung http://localhost:777/Joe/Mary stimmt also Joe/* überein. Wenn die Anforderung mit keinem URL-Selektor übereinstimmt und kein Empfangsknoten mit /* festgelegt wurde, wird vom HTTPInputsknoten eine Antwort an den Sender geschickt. Beispiel:
<html> <head> <title>WebSphere MQ Integrator error report </title> </head> <body> <h1>HTTP Status 404 - Resource Not Found</h1> URI /soap does not map to any message flow in broker VCP1BRK <p> <h3>WebSphere MQ Integrator 500</h3> </body> </html>
Sie können eine URL der Form /* verwenden, um alle Anforderungen abzufangen, die nicht mit den URLs in den HTTPInputsknoten übereinstimmen. Dies ermöglicht Ihnen, eine Antwort zu senden und andere geeignete Maßnahmen zu ergreifen.
Der Broker muss zur Verwendung eines Ports konfiguriert werden (der Standardport lautet 7080). Das HTTP-Empfangsprogramm wird in der Verwaltungstask gestartet und ist an diesem Port empfangsbereit. Bei Eingang einer Anforderung sendet der Listener diese über eine WebSphere MQ-Nachricht an den HTTPInput-Knoten.
Mit dem Befehl mqsichangetrace können Sie Traceinformationen für das HTTP-Empfangsprogramm sammeln.
Verwenden Sie zur Verarbeitung des Protokolls den Befehl mqsireadlog mit httplistener als Wert für qualifier.
Sie können den HTTPInput-Knoten in jedem Nachrichtenfluss verwenden, der HTTP- oder HTTPS-Nachrichten annimmt. Das häufigste Beispiel ist ein Nachrichtenfluss, durch den ein Web-Service implementiert wird. Der Abschnitt Web-Service-Anwendungen enthält weitere Informationen hierzu.
Der HTTPInputsknoten unterstützt HTTP POST und HTTP GET. Weitere Informationen zum Aktivieren von HTTP GET finden Sie unter HTTPRequest-Knoten.
Nachdem Sie eine Instanz des HTTPInputknotens 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.
Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.
Sie finden weitere Informationen hierzu in den Abschnitten Nachrichtenflusssicherheit und Nachrichtenflusssicherheit einrichten.
Der HTTPInput-Knoten leitet jede Nachricht, die er erfolgreich empfängt, an das Ausgangsterminal weiter. Schlägt die Nachrichtenauswertung fehl, wird die Nachricht an das Fehlerterminal weitergeleitet. Sie können Knoten mit diesem Terminal verbinden, um diese Situation zu handhaben. Wenn keine Verbindung zum Fehlerterminal besteht, wird die Nachricht gelöscht, die maximale Wartezeit für den Client läuft ab, und das TCP/IP-Empfangsprogramm meldet dem Client einen Fehler. Es gibt keine anderen Situationen, in denen die Nachricht an das Fehlerterminal weitergeleitet wird.
Wenn die Nachricht von diesem Knoten abgefangen wird, nachdem eine Ausnahmebedingung weiter vorne im Nachrichtenfluss ausgelöst wurde, wird die Nachricht an das Catch-Terminal weitergeleitet. Wenn keine Verbindung zum Catch-Terminal besteht, wird die Nachricht gelöscht, die maximale Wartezeit für den Client läuft ab, und das TCP/IP-Empfangsprogramm meldet dem Client einen Fehler.
In der folgenden Tabelle werden die Terminals des HTTPInputsknotens beschrieben:
| Terminal | Beschreibung |
|---|---|
| Fehlerterminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn ein Fehler auftritt. |
| Ausgabeterminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich abgerufen wurde. |
| Catch-Terminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde. |
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 HTTPInputsknotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | Nein | Nein | Knotentyp, z. B. HTTPInput | 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 HTTPInputsknotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Pfadsuffix für URL | Ja | Ja | Diese Eigenschaft gibt den Standort an, von dem Web-Service-Anforderungen abgerufen werden. Wenn die gewünschte URL http://<Hostname>[:<Port>]/[<Pfad>] ist, müssen Sie entweder /<Pfad> oder /<Pfadfragment>/* angeben; dabei ist * ein Platzhalterzeichen, das für jedes Zeichen stehen kann. | |
| HTTPS verwenden | Nein | Ja | Gelöscht | Diese Eigenschaft gibt an, ob der Knoten sicheres HTTP akzeptiert. |
In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Eingabenachricht' des HTTPInputsknotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Nachrichtendomäne | Nein | Nein | BLOB | Die Domäne für die Syntaxanalyse der ankommenden Nachricht. Wenn das Feld leer ist, ist der Standardwert BLOB. |
| Nachrichtengruppe | Nein | Nein | Der Name oder die ID der Nachrichtengruppe, in der die ankommende Nachricht definiert ist. Alle verfügbaren Nachrichtengruppen stehen in der Liste. | |
| Nachrichtentyp | Nein | Nein | Der Name der ankommenden Nachricht. | |
| Nachrichtenformat | Nein | Nein | Der Name des physischen Formats der ankommenden Nachricht. |
In der folgenden Tabelle werden die Eigenschaften der Parser-Optionen für den HTTPInput-Knoten beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Zeitpunkt für Syntaxanalyse | Nein | Nein | Bei Bedarf | Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht syntaktisch analysiert wird.
Gültige Werte sind Bei Bedarf, Sofort und Vollständig. Eine vollständige Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse. |
| Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen | Nein | Nein | Gelöscht | Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Syntaxelemente in der Nachrichtenbaumstruktur mit Datentypen erstellt, die vom XML-Schema genommen wurden. Diese Eigenschaft kann nur ausgewählt werden, wenn die Eigenschaft Auswerten in der Registerkarte Auswerten auf Inhalt oder Inhalt und Wert gesetzt wird. |
| XMLNSC-Kompaktparser für XMLNS-Domäne verwenden | Nein | Nein | Gelöscht | Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten unter XMLNSC in Knoten, die mit dem Ausgabeterminal verbunden sind, angezeigt, wenn XMLNS die Nachrichtendomäne des MQRFH2-Eingabeheaders oder der Eigenschaften von 'Syntaxanalyse der Eingabenachricht' ist. |
| Zugriff auf gemischten Inhalt | Nein | Nein | Gelöscht | Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Erkennen von gemischtem Text in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert, und es werden keine Elemente erstellt. |
| Kommentare beibehalten | Nein | Nein | Gelöscht | Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Erkennen von Kommentaren in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert, und es werden keine Elemente erstellt. |
| Verarbeitungsanweisung beibehalten | Nein | Nein | Gelöscht | Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Erkennen von Verarbeitungsanweisungen in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt. |
| Nicht transparente Elemente | Nein | Nein | Mit dieser Eigenschaft wird eine Liste mit Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser auf nicht transparente Weise analysiert werden sollen. |
In der folgenden Tabelle werden die Fehlerhandhabungseigenschaften des HTTPInputsknotens beschrieben:
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Maximale Client-Wartezeit(Sekunden) | Ja | Nein | 180 | Die Zeit in Sekunden, die das Empfangsprogramm wartet, bevor es eine Fehlernachricht an den Client zurücksendet. Der gültige Bereich liegt zwischen null (unendliche Wartezeit) und (231)-1. |
| Fehlerformat | Nein | Ja | SOAP 1.1 | Das Format von beliebigen HTTP-Fehlern, die an den Client zurückgegeben werden. Gültige Werte sind SOAP 1.1, SOAP 1.2 und HTML. |
In der folgenden Tabelle werden die Auswertungseigenschaften des HTTPInputsknotens beschrieben:
Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Auswerten | Nein | Ja | None | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert und Inhalt. |
| 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. |
In der folgenden Tabelle werden die Eigenschaften für die Sicherheit des HTTPInput-Knotens beschrieben. Weitere Informationen zu diesen Eigenschaften finden Sie unter Identität und Identitätsauszug konfigurieren.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Identitätstokentyp | Nein | Nein | None | Diese Eigenschaft gibt den Typ des Identitätstokens an, das in der eingehenden Nachricht vorhanden ist. Gültige Werte sind: Transportstandardwert, Benutzername, Benutzername + Kennwort und X.509-Zertifikat. Wird diese Eigenschaft nicht angegeben, wird die Identität aus den Transport-Headern abgerufen, und der Typ wird auf usernameAndPassword gesetzt. |
| Identitätstokenstandort | Nein | Nein | None | Diese Eigenschaft gibt an, wo in der Nachricht sich die Identität befindet. Der Standort wird als ESQL-Feldreferenz oder XPath angegeben. Wird diese Eigenschaft nicht angegeben, wird die Identität aus den Berechtigungsübertragungs-Headern abgerufen. |
| Identitätskennwortstandort | Nein | Nein | None | Diese Eigenschaft gibt an, wo in der Nachricht sich das Kennwort befindet. Der Standort wird als ESQL-Feldreferenz oder XPath angegeben. Wird sie nicht angegeben, wird das Kennwort aus den Berechtigungsübertragungs-Headern abgerufen. Diese Eigenschaft kann nur festgelegt werden, wenn der Identitätstyp auf usernameAndPassword gesetzt ist. |
| Identität-issuedBy-Position | Nein | Nein | None | Diese Eigenschaft gibt eine Zeichenfolge oder einen Pfadausdruck an und beschreibt den Aussteller der Identität. Der Standort wird als ESQL-Feldreferenz oder XPath angegeben. Dieser ist für die Verwendung in einer Ientitätszuordnungsfunktion. Wird diese Eigenschaft nicht angegeben, ist der Standardwert der Name des Benutzeragenten oder (falls sie nicht angegeben wird) die Zeichenfolge HTTP. |
| Sicherheitsausnahmen als normale Ausnahmen behandeln | Nein | Nein | False (falsch) | Diese Eigenschaft gibt an, ob Sicherheitsausnahmen (wie z. B. 'Zugriff verweigert') als normale Ausnahmebedingungen behandelt werden sollen, und leitet sie zum Fehlerterminal (falls verbunden) weiter. Standardmäßig ist dies inaktiviert; somit wird sichergestellt, dass Sicherheitsausnahmen veranlassen, dass die Nachricht zurückgesetzt wird, selbst wenn das Fehlerterminal angeschlossen ist. |