rpc/encoded Example - Get Exchange Rate

WSDL Tutorials - Herong's Tutorial Examples

∟WSDL 1.1 and SOAP 1.2 Examples - Document and RPC Styles

∟rpc/encoded Example - Get Exchange Rate

This section provides a tutorial example on writing a WSDL 1.1 example that uses SOAP 1.2 over HTTP with rpc/encoded as the message style and the encoding option.

"rpc/encoded" is the popular combination of message style and encoding option for most RPC (Remote Procedure Call) Web services. So let's write the second example with:

WSDL Version: 1.1
WSDL Binding Extension: SOAP 1.2
Transportation: SOAP 1.2 over HTTP
Message Style: rpc/encoded

In this WSDL example, I want to send a SOAP request to call a RPC function to get an exchange rate. The function expects 3 input positional parameters and returns 1 value. So I wrote this WSDL document,

<?xml version="1.0"?>
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
  xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:hy="https://www.herongyang.com/Service/"
  targetNamespace="https://www.herongyang.com/Service/">

  <wsdl:documentation>
    GetExchangeRate_WSDL_11_SOAP_12_RPC.wsdl
    Copyright (c) 2007 HerongYang.com. All Rights Reserved.
  </wsdl:documentation>

  <wsdl:message name="getExchangeRateInputMessage">
    <wsdl:part name="datePart" type="xsd:date"/>
    <wsdl:part name="fromCurrencyPart" type="xsd:string"/>
    <wsdl:part name="toCurrencyPart" type="xsd:string"/>
  </wsdl:message>
  <wsdl:message name="getExchangeRateOutputMessage">
    <wsdl:part name="ratePart" type="xsd:decimal"/>
  </wsdl:message>

  <wsdl:portType name="getExchangeRatePortType">
    <wsdl:operation name="GetExchangeRate">
      <wsdl:input name="getExchangeRateInput"
        message="hy:getExchangeRateInputMessage"/>
      <wsdl:output name="getExchangeRateOutput"
        message="hy:getExchangeRateOutputMessage"/>
    </wsdl:operation>
  </wsdl:portType>

  <wsdl:binding name="getExchangeRateBinding"
    type="hy:getExchangeRatePortType">
    <soap12:binding transport="http://schemas.xmlsoap.org/soap/http"/>
    <wsdl:operation name="GetExchangeRate">
      <soap12:operation style="rpc" soapActionRequired="false"/>
      <wsdl:input name="getExchangeRateInput">
        <soap12:body use="encoded"
          parts="fromCurrencyPart toCurrencyPart datePart"/>
      </wsdl:input>
      <wsdl:output name="getExchangeRateOutput">
        <soap12:body use="encoded" parts="ratePart"/>
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>

  <wsdl:service name="getExchangeRateService">
    <wsdl:port name="getExchangeRatePort"
      binding="hy:getExchangeRateBinding">
      <soap12:address location=
        "https://www.herongyang.com/Service/GetExchangeRate12.php"/>
    </wsdl:port>
  </wsdl:service>

</wsdl:definitions>

Note that:

My input message is defined with multiple parts. Each part is used as one parameter for the RPC function.
Each input parameter is defined with an XML Schema built-in type. No explicit type definitions are used.
parts="fromCurrencyPart toCurrencyPart datePart" attribute is used with soap12:body to set the order of input parameters.