WSDL

WSDL
Web Services Description Language的缩写，是一个用来描述Web服务和说明如何与Web服务通信的XML语言。
用于描述Web service及其函数、参数和返回值。因为是基于XML的，所以WSDL既是机器可阅读的，又是人可阅读的，这将是一个很大的好处。一些最新的开发工具 既能根据你的Web service生成WSDL文档，又能导入WSDL文档，生成调用相应Web service的代码。

WSDL 文件包含以下元素：
　　Type：使用某种语法（如 XML 模式）的数据类型定义（string、int） Message：要传递的数据 Part：消息参数 Operation：服务支持的操作的抽象描述 Port Type / Interface：一个或多个端点支持的操作的抽象集。此名称已更改，因此可能会遇到两者中的任何一个。 Binding：特定端口类型的具体协议和数据格式规范 Port / Endpoint：绑定和网络地址的组合。此名称也已更改，因此可能会遇到两者中的任何一个。 Service：相关端点的集合，包括其关联的接口、操作、消息等。

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>
　　<portType>
　　definition of a port.......
　　</portType>
　　<binding>
　　definition of a binding....
　　</binding>
　　</definitions>WSDL 文档可包含其它的元素，比如 extension 元素，以及一个 service 元素，此元素可把若干个 web services 的定义组合在一个单一的 WSDL 文档中。
　　如需完整的语法概述，请访问 WSDL 语法 这一节。同样要记住，与服务交互所需的所有细节都位于其 WSDL 文件中。


WSDL 简介
WSDL 指网络服务描述语言 (Web Services Description Language)。WSDL 是一种使用 XML 编写的文档。这种文档可描述某个 Web service。它可规定服务的位置，以及此服务提供的操作（或方法）。

WSDL 文档
WSDL 文档仅仅是一个简单的 XML 文档。它包含一系列描述某个 web service 的定义。
元素 定义
<portType> web service 执行的操作（比作传统编程语言中的一个函数库（或一个模块、或一个类））
<message> web service 使用的消息（每个消息均由一个或多个部件组成。可以把这些部件比作传统编程语言中一个函数调用的参数。）
<types> web service 使用的数据类型（使用 XML Schema 语法来定义数据类型。）
<binding> web service 使用的通信协议（每个端口定义消息格式和协议细节。）

WSDL 端口
<portType> 元素是最重要的 WSDL 元素。
它可描述一个 web service、可被执行的操作，以及相关的消息。端口定义了指向某个 web service 的连接点。可以把该元素比作传统编程语言中的一个函数库（或一个模块、或一个类），而把每个操作比作传统编程语言中的一个函数。
类型 定义
One-way 此操作可接受消息，但不会返回响应。
Request-response 此操走可接受一个请求并会返回一个响应
Solicit-response 此操作可发送一个请求，并会等待一个响应。
Notification 此操作可发送一条消息，但不会等待响应。

WSDL 绑定
WSDL 绑定可为 web service 定义消息格式和协议细节。
一个 请求 - 响应 操作的例子：
<message name="getTermRequest">
   <part name="term" type="xs:string" />
</message>

<message name="getTermResponse">
   <part name="value" type="xs:string" />
</message>

<portType name="glossaryTerms">
  <operation name="getTerm">
      <input message="getTermRequest" />
      <output message="getTermResponse" />
  </operation>
</portType>

<binding type="glossaryTerms" name="b1">
<soap:binding style="document"
transport="http://schemas.xmlsoap.org/soap/http" />
  <operation>
    <soap:operation
     soapAction="http://example.com/getTerm" />
    <input>
      <soap:body use="literal" />
    </input>
    <output>
      <soap:body use="literal" />
    </output>
  </operation>
</binding>
binding 元素有两个属性 - name 属性和 type 属性。
name 属性定义 binding 的名称，而 type 属性指向用于 binding 的端口，在这个例子中是 "glossaryTerms" 端口。
soap:binding 元素有两个属性 - style 属性和 transport 属性。
style 属性可取值 "rpc" 或 "document"。在这个例子中我们使用 document。transport 属性定义了要使用的 SOAP 协议。在这个例子中我们使用 HTTP。
operation 元素定义了每个端口提供的操作符。
对于每个操作，相应的 SOAP 行为都需要被定义。同时您必须如何对输入和输出进行编码。在这个例子中我们使用了 "literal"。

WSDL 和 UDDI
UDDI 是一种目录服务，企业可以使用它对 Web services 进行注册和搜索。
UDDI，英文为 "Universal Description, Discovery and Integration"，可译为“通用描述、发现与集成服务”。
什么是 UDDI？
UDDI 是一个独立于平台的框架，用于通过使用 Internet 来描述服务，发现企业，并对企业服务进行集成。
• UDDI 指的是通用描述、发现与集成服务
• UDDI 是一种用于存储有关 web services 的信息的目录。
• UDDI 是一种由 WSDL 描述的 web services 界面的目录。
• UDDI 经由 SOAP 进行通信
• UDDI 被构建入了微软的 .NET 平台

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>

 

 

--------------------------------------------------------------------------------------------------
我们的淘客网开通啦，欢迎大家去逛逛~\(≧▽≦)/~啦啦啦~~~
淘乐园：http://taoleyuan.jimdo.com
淘宝购物资讯网：http://taoke178.jimdo.com