SOAP_HEADER( Headerschlüssel [ Index, Headerattribut ] )

LONG VARCHAR

Diese Funktion kann mit einem einzigen Parameter Headerschlüssel verwendet werden, um einen Headereintrag zurückzugeben. Ein Headereintrag ist eine XML-Zeichenfolgendarstellung eines Elements und seiner Unterelemente, die in einem SOAP-Header enthalten sind.

Diese Funktion kann auch verwendet werden, um ein Attribut eines Headereintrags zu extrahieren, indem die optionalen Parameter Index und Headerattribut angegeben werden.

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

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

• NEXT_SOAP_HEADER-Funktion [SOAP]
• sa_set_soap_header-Systemprozedur
• Praktische Einführung: Verwenden von SQL Anywhere für den Zugriff auf einen SOAP/DISH-Dienst
• Webdienstfunktionen
• Webdienst-Systemprozeduren

Bei Verwendung des folgenden Beispiels in einer gespeicherten Prozedur, die von einem HTTP-Webdienst aufgerufen wird, werden alle im SOAP-Anforderungsheader enthaltenen Schlüssel verarbeitet. Wenn die Funktion den Authentication-Schlüssel verarbeitet, ruft sie auch den Wert des Schlüssels ab.

BEGIN
  DECLARE hd_key LONG VARCHAR;
  DECLARE hd_entry LONG VARCHAR;
header_loop:
  LOOP
    SET hd_key = NEXT_SOAP_HEADER( hd_key );
    IF hd_key IS NULL THEN
      -- no more header entries
      LEAVE header_loop;
    END IF;
    IF hd_key = 'Authentication' THEN
      SET hd_entry = SOAP_HEADER( hd_key );
    END IF;
  END LOOP header_loop;
END;