WSDL

WSDL

　　WSDL

　　Web Services Description Language的缩写，是一个用来描述Web服务和说明如何与Web服务通信的XML语言。

　　怎样向别人介绍你的Web service有什么功能，以及每个函数调用时的参数呢？你可能会自己写一套文档，你甚至可能会口头上告诉需要使用你的Web service的人。这些非正式的方法至少都有一个严重的问题：当程序员坐到电脑前，想要使用你的Web service的时候，他们的工具(如Visual Studio)无法给他们提供任何帮助，因为这些工具根本就不了解你的Web service。解决方法是：用机器能阅读的方式提供一个正式的描述文档。Web service描述语言(WSDL)就是这样一个基于XML的语言，用于描述Web service及其函数、参数和返回值。因为是基于XML的，所以WSDL既是机器可阅读的，又是人可阅读的，这将是一个很大的好处。一些最新的开发工具既能根据你的Web service生成WSDL文档，又能导入WSDL文档，生成调用相应Web service的代码。

　　================================================================================================

　　WSDL用来提供对服务的描述 ，它的主要构成要素有五个:

　　1）Types： 定义WSDL定义中所用到的数据类型，即XML Schema Types

　　2）Message : 对一组消息的输入和输出参数的定义

　　3）portType : 定义Web服务的操作

　　4) Binding ：描述特定服务接口的协议、数据格式、安全性和其它属性.

　　5) Services : 制定特定服务的URL和提供的调用接口，包含一组端口元素

[ 编辑本段]

WSDL 文档结构

　　WSDL 文档是利用这些主要的元素来描述某个 web service 的：

　　元素 定义

　　web service 执行的操作

　　<message> web service 使用的消息

　　<types> web service 使用的数据类型

　　<binding> web service 使用的通信协议

　　一个 WSDL 文档的主要结构是类似这样的：

　　<definitions>

　　<types>

　　definition of types........

　　</types>

　　<message>

　　definition of a message....

　　</message>

　　definition of a port.......

　　</portType>

　　<binding>

　　definition of a binding....

　　</binding>

　　</definitions>WSDL 文档可包含其它的元素，比如 extension 元素，以及一个 service 元素，此元素可把若干个 web services 的定义组合在一个单一的 WSDL 文档中。

　　如需完整的语法概述，请访问 WSDL 语法 这一节。

描述于 W3C 工作草案的完整 WSDL 1.2 语法已列在下面：

<wsdl:definitions name="nmtoken"? targetNamespace="uri">

    <import namespace="uri" location="uri"/> *
	
    <wsdl:documentation .... /> ?

    <wsdl:types> ?
        <wsdl:documentation .... /> ?
        <xsd:schema .... /> *
    </wsdl:types>

    <wsdl:message name="ncname"> *
        <wsdl:documentation .... /> ?
        <part name="ncname" element="qname"? type="qname"?/> *
    </wsdl:message>

    <wsdl:portType name="ncname"> *
        <wsdl:documentation .... /> ?
        <wsdl:operation name="ncname"> *
            <wsdl:documentation .... /> ?
            <wsdl:input message="qname"> ?
                <wsdl:documentation .... /> ?
            </wsdl:input>
            <wsdl:output message="qname"> ?
                <wsdl:documentation .... /> ?
            </wsdl:output>
            <wsdl:fault name="ncname" message="qname"> *
                <wsdl:documentation .... /> ?
            </wsdl:fault>
        </wsdl:operation>
    </wsdl:portType>

    <wsdl:serviceType name="ncname"> *
        <wsdl:portType name="qname"/> +
    </wsdl:serviceType>

    <wsdl:binding name="ncname" type="qname"> *
        <wsdl:documentation .... /> ?
        <-- binding details --> *
        <wsdl:operation name="ncname"> *
            <wsdl:documentation .... /> ?
            <-- binding details --> *
            <wsdl:input> ?
                <wsdl:documentation .... /> ?
                <-- binding details -->
            </wsdl:input>
            <wsdl:output> ?
                <wsdl:documentation .... /> ?
                <-- binding details --> *
            </wsdl:output>
            <wsdl:fault name="ncname"> *
                <wsdl:documentation .... /> ?
                <-- binding details --> *
            </wsdl:fault>
        </wsdl:operation>
    </wsdl:binding>

    <wsdl:service name="ncname" serviceType="qname"> *
        <wsdl:documentation .... /> ?
        <wsdl:port name="ncname" binding="qname"> *
            <wsdl:documentation .... /> ?
            <-- address details -->
        </wsdl:port>
    </wsdl:service>

</wsdl:definitions>