Auf vom Client bereitgestellte SOAP-Anforderungsheader zugreifen

Mit einer Kombination der Funktionen NEXT_SOAP_HEADER und SOAP_HEADER können Sie Header in SOAP-Anforderungen erhalten. Die Funktion NEXT_SOAP_HEADER durchläuft die SOAP-Header, die in einem SOAP-Anforderungsrahmen enthalten sind, und gibt den nächsten SOAP-Headernamen zurück. Sie mit NULL aufzurufen führt dazu, dass sie den Namen des ersten Headers zurückgibt. Nachfolgende Header werden abgerufen, indem der Funktion NEXT_SOAP_HEADER der Name des vorigen Headers übergeben wird. Diese Funktion gibt NULL zurück, wenn sie mit dem Namen des letzten Headers aufgerufen wird.

Das folgende Beispiel zeigt, wie der SOAP-Header abgerufen wird:

SET hd_key = NEXT_SOAP_HEADER( hd_key );
    IF hd_key IS NULL THEN
      -- no more header entries
      LEAVE header_loop;
    END IF;

Wenn diese Funktion mehrfach aufgerufen wird, werden alle Headerbereiche genau einmal zurückgegeben, jedoch nicht unbedingt in der Reihenfolge, in der sie in der SOAP-Anforderung angeordnet sind.

Die Funktion SOAP_HEADER gibt den Wert des angegebenen SOAP-Header-Felds 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 Feldnamen nicht existiert, ist der Rückgabewert NULL.

Das Beispiel sucht nach einem SOAP-Header namens "Authentication". Wenn dieser Header gefunden wird, werden der Wert für den gesamten SOAP-Header sowie die Werte der Attribute @namespace und mustUnderstand extrahiert. Der Wert des SOAP-Headers könnte z.B. wie die folgende XML-Zeichenfolge aussehen:

<Authentication xmlns="CustomerOrderURN" mustUnderstand="1">
  <userName pwd="none">
    <first>John</first>
    <last>Smith</last>
  </userName>
</Authentication>

Für diesen Header hat das Attribut @namespace den Wert CustomerOrderURN.

Das Attribut mustUnderstand hat in diesem Beispiel den Wert 1.

Diese XML-Zeichenfolge wird mit der Funktion OPENXML syntaktisch analysiert. Hierzu wird eine XPath-Zeichenfolge mit dem Wert /*:Authentication/*:userName verwendet.

SELECT * FROM OPENXML( hd_entry, xpath )
    WITH ( pwd LONG VARCHAR '@*:pwd',
        first_name LONG VARCHAR '*:first/text()',
        last_name LONG VARCHAR '*:last/text()' );

Unter Verwendung des oben dargestellten SOAP-Headerwerts erstellt die SELECT-Anweisung wie folgt eine Ergebnismenge:

pwd	first_name	last_name
none	John	Smith

Für diese Ergebnismenge wird ein Cursor deklariert und die drei Spaltenwerte werden in drei Variablen abgerufen. Sie haben nun alle gewünschten Informationen, die an den Webdienst übergeben wurden.

Beispiel

Das folgende Beispiel zeigt, wie ein Webserver SOAP-Anforderungen mit Parametern und SOAP-Header verarbeiten kann. Das Beispiel implementiert einen SOAP-Vorgang mit dem Namen addItem, der zwei Parameter benötigt: amount vom Typ int und item vom Typ string. Die Prozedur sp_addItems verarbeitet einen SOAP-Header zur Authentifizierung, indem sie den Vor- und den Nachnamen des Benutzers extrahiert. Die Werte werden dafür verwendet, den Validierungsheader einer SOAP-Antwort mit der Systemprozedur sa_set_soap_header mit Daten zu füllen. Die Antwort ist ein Ergebnis bestehend aus drei Spalten: quantity, item und status mit den Datentypen INT, LONG VARCHAR und LONG VARCHAR.

// create the SOAP service
call sa_make_object( 'service', 'addItems' );
alter SERVICE "addItems"
    TYPE 'SOAP'
    format 'concrete'
    AUTHORIZATION OFF
    USER dba
    AS call sp_addItems( :amount, :item );

// create SOAP endpoint for related services
call sa_make_object( 'service', 'store' );
alter SERVICE "store"
    TYPE 'DISH'
    AUTHORIZATION OFF
    USER dba;

// create the procedure that will process the SOAP requests for the addItems service
create or replace procedure sp_addItems( "count" int, item long varchar )
result( quantity int, item long varchar, status long varchar )
begin
    declare "hd_key" long varchar;
    declare "hd_entry" long varchar;
    declare "pwd" long varchar;
    declare "first" long varchar;
    declare "last" long varchar;
    declare "xpath" long varchar;
    declare "authinfo" long varchar;
    declare "namespace" long varchar;
    declare "mustUnderstand" 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 );
            set xpath = '/*:' || hd_key || '/*:userName';
            set "namespace" = soap_header( hd_key, 1, '@namespace' );
            set mustUnderstand = soap_header( hd_key, 1, 'mustUnderstand' );
            begin
        // parse for the pieces that we are interested in
                declare crsr cursor for select * from
                    openxml( hd_entry, xpath )
                        with ( pwd long varchar '@*:pwd',
                               "first" long varchar '*:first/text()',
                               "last" long varchar '*:last/text()');
                open crsr;
                fetch crsr into pwd, "first", "last";
                close crsr;
            end;
      // build a response header, based on the pieces from the request header
            set authinfo = XMLELEMENT( 'Validation',
            XMLATTRIBUTES(
                    "namespace" as xmlns,
                    "mustUnderstand" as mustUnderstand ),
                    XMLELEMENT( 'first', "first" ),
                    XMLELEMENT( 'last', "last" ) );

            call sa_set_soap_header( 'authinfo', authinfo);
        end if;
    end loop header_loop;
    //  code to validate user/session and check item goes here...
    select count, item, 'available';
end;

Weitere Hinweise zur clientseitigen Implementierung dieses Beispiels finden Sie unter Header der SOAP-Anforderung verwalten oder Beispiel: Verarbeitung von SOAP-Headern, -Parametern und -Antworten.

Kommentieren Sie diese Seite in DocCommentXchange.