HTTP_HEADER-Funktion [HTTP]

Gibt den Wert eines HTTP-Headers zurück.

Syntax

HTTP_HEADER( Headerfeldname )

Parameter

Headerfeldname Der Name eines HTTP-Headerfelds

Rückgabe

LONG VARCHAR

Bemerkungen

Diese Funktion gibt den Wert des benannten HTTP-Headerfelds zurück, oder NULL, wenn sie nicht von einem HTTP-Dienst aufgerufen wurde. Sie wird verwendet, wenn eine HTTP-Anforderung über einen Webdienst verarbeitet wird.

Wenn ein Header für einen angegebenen Headerfeldnamen nicht existiert, ist der Rückgabewert NULL. Der Rückgabewert ist ebenfalls NULL, wenn die Funktion nicht von einem Webdienst aufgerufen wurde.

Einige Header, die beim Verarbeiten einer HTTP-Webdienstanforderung von Interesse sind, sind die folgenden. Weitere Hinweise zu diesen Headern finden Sie unter [external link] http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html.org/Protocols/rfc2616/rfc2616-sec14.html.

Cookie Die vom Client gespeicherten Cookie-Werte, die mit der angeforderten URI verknüpft sind (falls vorhanden)
Referer Der URL der Seite, die den Link zur angeforderten URI enthielt
Host Name oder IP des Hosts, der die Anforderung übermittelt hat
User-Agent Der Name der Clientanwendung
Accept-Encoding Eine Liste von Kodierungen für die Antwort, die für die Clientanwendung akzeptabel ist

Diese speziellen Header sind stets definiert, wenn eine HTTP-Webdienstanforderung verarbeitet wird:

@HttpMethod Gibt den Typ der Anforderung zurück, die verarbeitet wird. Mögliche Werte sind HEAD, GET oder POST.
@HttpURI Die vollständige URI der Anforderung, wie sie in der HTTP-Anforderung angegeben wurde
@HttpVersion Die HTTP-Version der Anfrage (z.B. 1.0 oder 1.1)
@HttpQueryString Gibt den Abfrageteil des angeforderten URIs an, sofern er existiert.

Diese Spezial-Header ermöglichen den Zugriff auf die erste Zeile einer Clientanforderung (auch Anforderungszeile genannt).

Siehe auch

Standards und Kompatibilität

SQL/2003 Erweiterung des Herstellers

Beispiel

Mit dem folgenden Beispiel wird der Cookie-Headerwert abgerufen, wenn die Anweisung in einer von einem HTTP-Webdienst aufgerufenen gespeicherten Prozedur verwendet wird:

SET cookie_value = HTTP_HEADER( 'Cookie' );

Mit dem folgenden Beispiel wird der Wert des ersten HTTP-Headers abgerufen, wenn die Anweisung in einer von einem HTTP-Webdienst aufgerufenen gespeicherten Prozedur verwendet wird.

DECLARE header_name LONG VARCHAR;
DECLARE header_value LONG VARCHAR;
SET header_name = NEXT_HTTP_HEADER( NULL );
SET header_value = HTTP_HEADER( header_name );

Kommentieren Sie diese Seite in DocCommentXchange.
Senden Sie uns Feedback über diese Seite via E-Mail.