Web Service Example 5: SOAP request and response messages

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.