WSDL学习笔记

一、            WSDL简介

1. 什么是WSDL

ü  是网络服务描述语言

ü  使用XML编写

ü  也可以用于定位网络服务

二、            WSDL文档

1. WSDL文档结构

WSDL文档用这些主要元素描述web service（本文中建成ws）：

 <wsdl:portType>     ws可以执行的操作
<wsdl:message>      ws使用的消息？

<wsdl:types>            ws使用的数据类型

<wsdl:binding>         ws使用的通讯协议

一个WSDL文档的主要结构：

<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions>

 

  <wsdl:types>

         ……

  </wsdl:types>

  

  <wsdl:message name="settleMessageRequest">

         ……

  </wsdl:message>

     

  <wsdl:portType name="WebServiceClientPortType">

         ……

  </wsdl:portType>

    

  <wsdl:binding>

         ……

  </wsdl:binding>

   

  <wsdl:service name="WebServiceClient">

         ……

  </wsdl:service>

</wsdl:definitions>

WSDL文档可以包含其他元素

 

WSDL types元素定义ws使用的数据类型，为了达到平台中立性，WSDL使用XML Schema语法来定义数据类型

WSDL message元素定义一个数据操作的元素，类似于函数的参数

WSDL portType元素是最重要的WSDL元素，可以描述一个ws所有可执行的操作以及相关信息，类似于函数库

WSDL Binding为每个portType定义消息格式和协议细节

 

2. WSDL实例

简化的WSDL文档片段

 

<message name=”getNameRequest”>

         <part name=”term” type=”xs:string”>

</message>

<message name=”getNameResponse”>

         <part name=”value” type=”xs:stirng”>

</message>

<portType name=”glossaryTerms”>

         <operation name=”getTerm”>

                   <input message=”getNameRequest”/>

                   <output message=”getNameResponse”/>

         </operation>

</portType>

在这个例子中，glossaryTerms为portType名称，getTerm为操作名称，getTerm拥有一个名为getNameRequest的输入消息，一个名为getNameResponse的输出消息

<message>可以定义每个message的部件part，以及相关联的数据类型

三、            WSDL端口portType

WSDL的portType描述ws所有的操作

1. 操作类型

WSDL定义了四种操作类型

One-way                              此操作服务端接受消息，但不会返回响应

Request-response            服务端接受一个消息，并返回给客户端一个响应

Solicit-response                 服务端发起一个请求，客户端返回一个响应 ？

Notification                         服务端发送给客户端一个通知。？

2. One-way操作

<message name="newTermValues">

   <part name="term" type="xs:string"/>

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

</message>

 

<portType name="glossaryTerms">

   <operation name="setTerm">

      <input name="newTerm" message="newTermValues"/>

   </operation>

</portType >

3. Request-Response 操作

<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>

4. Solicit-response操作

<wsdl:definitions .... >

    <wsdl:portType .... > *

        <wsdl:operation name="nmtoken" parameterOrder="nmtokens">

           <wsdl:output name="nmtoken"? message="qname"/>

           <wsdl:input name="nmtoken"? message="qname"/>

           <wsdl:fault name="nmtoken" message="qname"/>*

        </wsdl:operation>

    </wsdl:portType >

</wsdl:definitions>

先定义output，再定义input

个人理解：client实现nmtoken方法，供server端调用。

四、            WSDL绑定

1. 绑定到SOAP

<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=”bl”>

         <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>

         </soap:binding>

</binding>

 

binding元素有两个属性，type指示要绑定的port（函数库）glossaryTerms

soap:binding元素有两个属性，style和transport

style可以取值为document或者rpc

transport定义SOAP使用的传输协议

soap:body 的use属性可以取值为literal或者encoded

对于style和use，推荐使用document和literal

详细区别见 http://www.ibm.com/developerworks/cn/webservices/ws-whichwsdl

transport取值范围？

五、            WSDL和UDDI

略

六、            完整的WSDL语法

略