A Sample WSDL 2.0 Document

WSDL Tutorials - Herong's Tutorial Examples

∟A Sample WSDL 2.0 Document

This 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) 2009 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">
      <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.

This sample WSDL document is also available at https://www.herongyang.com/Service/Hello_WSDL_20_SOAP.wsdl.

Note that the follow "style" attribute has been removed the operation, Hello, because the input message XML element definition does not meet the requirements of the specified style, iri. Based on WSDL 2.0 specification, message style is optional. You don't have to follow any predefined styles. Thanks to Ridita who informed me this error.

  style="http://www.w3.org/ns/wsdl/style/iri"

Table of Contents

About This Book

►Introduction to WSDL 2.0

What Is WSDL 2.0

►A Sample WSDL 2.0 Document

WSDL 2.0 Core, Adjuncts and Extensions

List of APIs and Tools for WSDL 1.1 and 2.0

WSDL 2.0 Document Structure and Syntax

WSDL Version 2.0 Part 2: Adjuncts

WSDL 2.0 Document Examples with SOAP Binding

Using WSDL Document in Java Apache Axis2/Java for WSDL

Apache Woden for WSDL Documents in Java

SoapUI - Web Service Testing Tool

PHP SOAP Extension for WSDL

Perl SOAP::Lite for WSDL

Introduction to WSDL 1.1

WSDL 1.1 Document Structure and Syntax

WSDL 1.1 Binding Extension for SOAP 1.1

SoapUI as WSDL 1.1 Testing Tool

WSDL 1.1 and SOAP 1.1 Examples - Document and RPC Styles

PHP SOAP Extension for WSDL 1.1

Perl SOAP::Lite for WSDL 1.1

Apache Axis2/Java for WSDL 1.1

Using WSDL2Java to Generate Web Service Stub Classes

WSDL 1.1 Binding Extension for SOAP 1.2

WSDL 1.1 and SOAP 1.2 Examples - Document and RPC Styles

SOAP 1.2 Binding - PHP, Java and Perl Clients

WSDL Related Terminologies

Archived Tutorials

References

Full Version in PDF/EPUB