WSDL

最新推荐文章于 2025-07-22 17:47:01 发布

chonghan1893

最新推荐文章于 2025-07-22 17:47:01 发布

阅读量110

点赞数

CC 4.0 BY-SA版权

文章标签：运维

原文链接：https://my.oschina.net/clyy/blog/2961935

WSDL

WSDL是基于XML的用于描述Web Services以及如何访问Web Services的语言。

什么是WSDL？

WSDL指网络服务描述语言
WSDL使用XML编写
WSDL是一种XML文档
WSDL用于描述网络服务
WSDL也可用于定位网络服务
WSDL还不是W3C标准

WSDL可描述网络服务（Web Services）

WSDL指网络服务描述语言（Web服务描述语言）。

WSDL是一种使用XML编写的文档。这种文档可描述某个Web服务。它可规定服务的位置，以及此服务提供的操作（或方法）。

WSDL文档

WSDL文档仅仅是一个简单的XML文档。

它包含一系列描述某个web服务的定义。

WSDL文档结构

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

元素          定义
<portType>  web service 执行的操作
<message>   web service 使用的消息
<types>     web service 使用的数据类型
<binding>   web service 使用的通信协议

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

<definitions>

<types>
  data type definitions........
</types>

<message>
  definition of the data being communicated....
</message>

<portType>
  set of operations......
</portType>

<binding>
  protocol and data format specification....
</binding>

</definitions>

WSDL文档可包含其它的元素，比如扩展元素，以及一个服务元素，此元素可以若干个Web服务的定义组合在一个单一的WSDL文档中。

WSDL端口

<portType> 元素是最重要的WSDL元素。

它可描述一个web服务，可被执行的操作，以及相关的消息。

把可以<portType>元素比传统动词}编程语言中的一个函数库（或一个模块，或一个类）。

操作类型

请求 - 响应是最普通的操作类型，不过WSDL定义了四种类型：

类型                      定义
One-way 此操作可接受消息，但不会返回响应。
Request-response       此操作可接受一个请求并会返回一个响应
Solicit-response       此操作可发送一个请求，并会等待一个响应。
Notification           此操作可发送一条消息，但不会等待响应。

单向操作

一个单向操作的例子：

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

在这个例子中，端口“glossaryTerms”定义了一个名为“setTerm”的单向操作。

这个“setTerm”操作可接受新术语表项目消息的输入，这些消息使用一条名为“newTermValues”的消息，此消息带有输入参数“term”和“value”。不过，没有为这个操作定义任何输出。

请求 - 响应操作

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

在这个例子中，端口“glossaryTerms”定义了一个名为“getTerm”的请求 - 响应操作。

“getTerm”操作会请求一个名为“getTermRequest”的输入消息，此消息带有一个名为“term”的参数，并将返回一个名为“getTermResponse”的输出消息，此消息带有一个名为“值“的参数。

WSDL消息

<message> 元素定义一个操作的数据元素。

每个消息均由一个或多个部件组成。可以把这些部件比作传统编程语言中一个函数调用的参数。

WSDL类型

<types> 元素定义web service使用的数据类型。

为了最大程度的平台中立性，WSDL使用XML Schema语法来定义数据类型。

WSDL绑定

<binding> 元素为每个端口定义消息格式和协议细节。

绑定到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="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。

操作元素定义了每个端口提供的操作符。

对于每个操作，相应的SOAP行为都需要被定义。同时您必须如何对输入和输出进行编码。在这个例子中我们使用了“文字”。

WSDL实例

这是某个WSDL文档的简化的片段：

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

在这个例子中，<portType>元素把“glossaryTerms”定义为某个端口的名称，把“getTerm”定义为某个操作的名称。

操作“getTerm”拥有一个名为“getTermRequest”的输入消息，以及一个名为“getTermResponse”的输出消息。

<message> 元素可定义每个消息的部件，以及相关联的数据类型。

对比传统的编程，glossaryTerms是一个函数库，而“getTerm”是带有输入参数“getTermRequest”和返回参数getTermResponse的一个函数。