Variablen in einem SOAP-Envelope übergeben

Sie können Variablen in einem SOAP-Envelope übergeben, indem Sie einen SOAP-Vorgang mit der SET SOAP-Option einer Webclient-Funktion oder -Prozedur einrichten.

Der folgende Code veranschaulicht, wie Sie einen SOAP-Vorgang in einer Webclient-Funktion einrichten:

CREATE OR REPLACE FUNCTION soapAddItemFunction("amount" int, item long varchar)
RETURNS XML
    URL 'http://localhost/store'
    SET 'SOAP(OP=addItems)'
    TYPE 'SOAP:DOC';

In diesem Beispiel enthält der addItems-Vorgang die amount- und item-Werte, die als Parameter an die soapAddItemFunction-Funktion übergeben werden.

Sie können eine Anforderung senden, indem Sie das folgende Beispielskript ausführen:

SELECT soapAddItemFunction(5, 'shirt');

Ein Aufruf des soapAddItemFunction-Funktionsaufrufs generiert einen SOAP-Envelope, der ähnlich wie der folgende aufgebaut ist:

'<?xml version="1.0"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:m="http://localhost">
  <SOAP-ENV:Body>
    <m:addItems>
      <m:amount>5</m:amount>
      <m:item>shirt</m:item>
    </m:addItems>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>'

Als Alternative zur vorherigen Vorgehensweise können Sie eigene SOAP-Daten erstellen und in einem HTTP-Wrapper an den Server senden.

Variablen für SOAP-Dienste müssen in eine Standard-SOAP-Anforderung eingefügt werden. Auf andere Art angegebene Werte werden ignoriert.

Der folgende Code veranschaulicht die Erstellung einer HTTP-Wrapper-Prozedur, die einen angepassten SOAP-Envelope aufbaut:

create or replace procedure addItemHttpWrapper( amount int, item long varchar )
result(response xml)
begin
    declare payload xml;
    declare response xml;

    set payload =
'<?xml version="1.0"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:m="http://localhost">
  <SOAP-ENV:Body>
    <m:addItems>
      <m:amount>' || amount || '</m:amount>
      <m:item>' || item || '</m:item>
    </m:addItems>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>';
    set response = httpAddItemFunction( payload );
    /* process response as demonstrated in addItemFunctionWrapper */
    select response;
end

Der folgende Beispielcode veranschaulicht die Webclient-Funktion, die zum Senden der Anforderung verwendet wird:

create or replace function httpAddItemFunction("soapPayload" xml )
returns XML
	url 'http://localhost/store'
    type 'HTTP:POST:text/xml'
    header 'SOAPAction: "http://localhost/addItems"';

Sie können eine Anforderung senden, indem Sie das folgende Beispielskript ausführen:

call addItemHttpWrapper( 5, 'shirt' );

Kommentieren Sie diese Seite in DocCommentXchange.