Web service example 5: SOAP request and response messages

Previous Next

This topic provides background information about the SOAP messages that are sent in Web Service Example 5: Document-Oriented Method with Complex Type Parameters.

In example 5, the following client SQL statement is executed:

INVOKE TRAVELCOMPONENT.GETSCHEDULEDTOURS WITH

SELECT '<Destination xmlns="http://MyWebServer/TravelService/TRAVELSERVICE.wsdl">AUSTRALIA</Destination>'

The Web Service component handles this statement, and composes a SOAP request message. The information how to compose this message is defined in the TRAVELSERVICE.wsdl file:

<wsdl:operation name="GetScheduledTours">

    <soap:operation soapAction="http://MyWebServer/TravelService/TRAVELSERVICE.ashx#GetScheduledTours" style="document"/>

    <wsdl:input name="GetScheduledTours">

        <soap:body use="literal"/>

        </wsdl:input>

    <wsdl:output name="GetScheduledToursResponse">

        <soap:body use="literal"/>

        </wsdl:output>

</wsdl:operation>

In this code fragment, the attributes style="document" and use="literal" do NOT result in any method names or parameter names appearing in the SOAP request message. This is why in a document-oriented method, all XML elements must be included in the SQL statement:

<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope

    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

    xmlns:xsd="http://www.w3.org/2001/XMLSchema"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soapenv:Body>    <Destination xmlns="http://MyWebServer/TravelService/TRAVELSERVICE.wsdl"

        xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">

            AUSTRALIA

    </Destination>

</soapenv:Body></soapenv:Envelope>

The body of this SOAP request message includes the XML elements that are included in the SQL statement.

Next, the following statement is sent to the Rules Service:

INVOKE TRAVELSERVICE.GetScheduledTours WITH

SELECT '... soap message above ...' request

Then, the Web Service provider composes a SOAP response:

<soap:Envelope

    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

    xmlns:tns="http://MyWebServer/TravelService/TRAVELSERVICE.wsdl">

<soap:Body>

    <tns:Scheduled_Tours documentName="Scheduled Tours">

        <SCHEDTOUR TOUR_TYPE="ISLAND SUNTANNER" START_DATE="2005-11-01000000" RETURN_DATE="2005-11-13000000" PRICE="120" MAX_PART="10" GUIDE="137">

        </SCHEDTOUR>

        <SCHEDTOUR TOUR_TYPE="ISLAND SUNTANNER" START_DATE="2005-11-15000000" RETURN_DATE="2005-11-27000000" PRICE="122" MAX_PART="5" GUIDE="6">

        </SCHEDTOUR>

    </tns:Scheduled_Tours>

</soap:Body>

</soap:Envelope>

The body of this SOAP response message only includes the Scheduled_Tours parameter of the web service provider method in XML format.