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

LONG VARCHAR

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

Wenn Variablenname oder ein Header für einen angegebenen Variablenname-Wert zur Angabe eines HTTP-Headerfeldattributs 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 Attribut-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 Attribut 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 die angegebene Instanz nicht vorhanden ist oder wenn die Funktion nicht von einem HTTP-Dienst aufgerufen wird.

• NEXT_HTTP_VARIABLE-Funktion [HTTP]
• sa_http_variable_info-Systemprozedur
• Auf vom Client bereitgestellte HTTP-Variablen und -Header zugreifen
• Webdienstfunktionen
• Webdienst-Systemprozeduren

Bei Verwendung des folgenden Beispiels in einer gespeicherten Prozedur, die von einem HTTP-Webdienst aufgerufen wird, werden die Werte der in der Beispiel-URL angegebenen HTTP-Variablen abgerufen.

-- http://sample.com/demo/ShowDetail?product_id=300&customer_id=101
BEGIN
  DECLARE v_customer_id LONG VARCHAR;
  DECLARE v_product_id LONG VARCHAR;
  SET v_customer_id = HTTP_VARIABLE( 'customer_id' );
  SET v_product_id = HTTP_VARIABLE( 'product_id' );
  CALL ShowSalesOrderDetail( v_customer_id, v_product_id );
END;

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' );