A Sample WSDL 2.0 Document

Free Web Services - Herong's Tutorial Examples

∟A Sample WSDL 2.0 Document

his section describes a sample WSDL 2.0 document, which defines a Web service, helloService, with an operation called Hello.

Here is a simple example of WSDL 2.0 document represented in XML format, Hello_WSDL_20_SOAP.wsdl:

<?xml version="1.0"?> 
<wsdl:description xmlns:wsdl="http://www.w3.org/ns/wsdl"
  xmlns:wsoap= "http://www.w3.org/ns/wsdl/soap"
  xmlns:hy="https://www.herongyang.com/Service/"
  targetNamespace="https://www.herongyang.com/Service/">

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

  <wsdl:types>
    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
      targetNamespace="https://www.herongyang.com/Service/">
      <xsd:element name="Hello" type="xsd:string"/>    
      <xsd:element name="HelloResponse" type="xsd:string"/>    
    </xsd:schema>    
  </wsdl:types>

  <wsdl:interface name="helloInterface" >
    <wsdl:operation name="Hello" 
      pattern="http://www.w3.org/ns/wsdl/in-out" 
      style="http://www.w3.org/ns/wsdl/style/iri">
      <wsdl:input messageLabel="In" 
        element="hy:Hello" />
      <wsdl:output messageLabel="Out" 
        element="hy:HelloResponse" />
    </wsdl:operation>
  </wsdl:interface>

  <wsdl:binding name="helloBinding" 
    interface="hy:helloInterface"
    type="http://www.w3.org/ns/wsdl/soap"
    wsoap:protocol="http://www.w3.org/2003/05/soap/bindings/HTTP/">
    <wsdl:operation ref="hy:Hello" 
      wsoap:mep="http://www.w3.org/2003/05/soap/mep/soap-response"/>
  </wsdl:binding>

  <wsdl:service name="helloService" 
    interface="hy:helloInterface">
    <wsdl:endpoint name="helloEndpoint" 
      binding="hy:helloBinding"
address="https://www.herongyang.com/Service/Hello_SOAP_12.php"/>
  </wsdl:service>

</wsdl:description>

In this WSDL 2.0 sample document,

A Web service, helloService, is defined with an endpoint, helloEndpoint, with an access address at https://www.herongyang.com/Service/Hello_SOAP_12.php.
The endpoint, helloEndpoint, is linked to a binding, helloBinding.
The binding, helloBinding, is defined with a communication protocol, SOAP 1.2 over HTTP.
The binding, helloBinding, is linked to an interface, helloInterface.
The interface, helloInterface, is defined with an operation, Hello, which requires an input message element and an output message element.
Each element, Hello/HelloResponse, is defined by an XML schema included in the Types section.