Gibt den Wert einer HTTP-Variablen zurück.

Syntax

HTTP_VARIABLE(Variablenname [ [ , Instanz ] , HTTP_Headerfeld ] )

Parameter

Rückgabe

Diese Funktion gibt den Wert der benannten HTTP-Variablen zurück. Sie wird verwendet, wenn eine HTTP-Anforderung in einem Webdienst verarbeitet wird.

LONG VARCHAR

Bemerkungen

Wenn ein Header für einen angegebenen Variablennamen nicht existiert, ist der Rückgabewert NULL.

Wenn die Webdienstanforderung vom Typ POST ist und die Variablendaten als Multipart/Formdaten übermittelt werden, empfängt der HTTP-Server HTTP-Header für jede einzelne Variable. Wenn der HTTP_Headerfeld-Parameter angegeben ist, gibt die HTTP_VARIABLE-Funktion den zugeordneten Multipart/Formdaten-Headerwert von der POST-Anforderung für die jeweilige Variable zurück.

Alle Eingabedaten durchlaufen eine Zeichensatzkonvertierung zwischen dem Zeichensatz des Clients (z.B. einem Browser) und dem Zeichensatz der Datenbank. Wenn allerdings @BINARY für HTTP_Headerfeld angegeben ist, wird der Variablen-Eingabewert ohne Zeichensatzkonvertierung zurückgegeben. Das ist nützlich beim Empfang von Binärdaten (z.B. Bilddaten) von einem Client.

Diese Funktion gibt NULL zurück, wenn sie nicht von einem Webdienst aufgerufen wird.

Siehe auch

• Serveroption -xs
• Mit Variablen arbeiten
• HTTP_DECODE-Funktion [HTTP]
• HTTP_ENCODE-Funktion [HTTP]
• HTTP_HEADER-Funktion [HTTP]
• NEXT_HTTP_HEADER-Funktion [HTTP]
• NEXT_HTTP_VARIABLE-Funktion [HTTP]
• SQL Anywhere-Webdienste
• Webdienstfunktionen
• Webdienst-Systemprozeduren

Standards und Kompatibilität

Beispiele

Wenn die folgenden Anweisungen in einer von einem HTTP-Webdienst aufgerufenen gespeicherten Prozedur verwendet werden, rufen Sie die Content-Disposition- und Content-Type-Header der Variablen image ab:

SET v_name = HTTP_VARIABLE( 'image', NULL, 'Content-Disposition' );
SET v_type = HTTP_VARIABLE( 'image', NULL, 'Content-Type' );

Wenn die folgende Anweisung in einer von einem HTTP-Webdienst aufgerufenen gespeicherten Prozedur verwendet wird, rufen Sie den Wert der Variablen image in ihrem aktuellen Zeichensatz ab, also ohne Zeichensatzkonvertierung:

SET v_image = HTTP_VARIABLE( 'image', NULL, '@BINARY' );