HTML CSS JAVASCRIPT PYTHON PYTHON2 JAVA C C++ C# SQL Excel Linux AI BOOTSTRAP PHP 教程库 参考手册 技术文章 测验 练习 HOWTO FAQ
❮ 上一节 下一节 ❯

SoapUI - WSDL

WSDL 代表 Web 服务描述语言。它是描述 Web 服务的标准格式。WSDL 由 Microsoft 和 IBM 联合开发。WSDL 的发音为"wiz-dull"，拼写为"W-S-D-L"。

WSDL ─ 简史

WSDL 1.1 于 2001 年 3 月由 Ariba、IBM 和 Microsoft 提交，作为 W3C 说明，用于描述 W3C XML 协议活动上的服务。

WSDL 1.1 尚未得到万维网联盟 (W3C) 的认可，但它刚刚发布了 2.0 版草案，该草案将成为一项建议（官方标准），因此得到了 W3C 的认可。

WSDL ─ 注意事项

WSDL 是一种基于 XML 的协议，用于在分散和分布式环境中进行信息交换。 WSDL 的其他一些功能如下 −

  • WSDL 定义描述了如何访问 Web 服务以及它将执行哪些操作。

  • 它是一种描述如何与基于 XML 的服务交互的语言。

  • 它是通用描述、发现和集成 (UDDI) 的一个组成部分，UDDI 是一个基于 XML 的全球商业注册中心。

  • WSDL 是 UDDI 使用的语言。

WSDL 用法

WSDL 通常与 SOAP 和 XML Schema 结合使用，以通过 Internet 提供 Web 服务。连接到 Web 服务的客户端程序可以读取 WSDL 以确定服务器上有哪些功能可用。使用的任何特殊数据类型都以 XML Schema 的形式嵌入到 WSDL 文件中。然后，客户端可以使用 SOAP 来实际调用 WSDL 中列出的函数之一。

了解 WSDL

WSDL 将 Web 服务分解为三个特定的、可识别的元素，这些元素一旦定义即可组合或重用。

WSDL 中可以单独定义的三个主要元素是 −

  • 类型
  • 操作
  • 绑定

WSDL 文档有各种元素，但它们都包含在这三个主要元素中，可以将其开发为单独的文档，然后可以将它们组合或重复使用以形成完整的 WSDL 文件。

在本教程中，我们遵循 CurrencyConverter WSDL：http://www.webservicex.net

格式和元素

CurrencyConverter WSDL 将如下所示 −

Currency Converter

Response

绑定元素

WSDL ─ portType

<portType> 元素将多个消息元素组合起来，形成完整的单向或往返操作。例如，<portType> 可以将一个请求和一个响应消息组合成一个请求/响应操作。这在 SOAP 服务中最常用。一个 portType 可以定义多个操作。

示例

Port Type
  • portType 元素定义一个操作，称为 ConversionRate。
  • 该操作由一个输入消息 ConversionRateHttpPostIn 组成。
  • 输出消息的操作是 ConversionRateHttpPostOut。

操作模式

WSDL 支持四种基本操作模式 −

单向

服务接收一条消息。因此，该操作只有一个输入元素。单向操作的语法是 −

<wsdl:definitions .... >  
   <wsdl:portType .... > * 
      <wsdl:operation name = "nmtoken"> 
         <wsdl:input name = "nmtoken"? message = "qname"/> 
      </wsdl:operation> 
   </wsdl:portType > 
</wsdl:definitions>

请求 ─ 响应

服务接收消息并发送响应。因此，该操作有一个输入元素，后面跟着一个输出元素。为了封装错误，还可以指定可选的故障元素。请求-响应操作的语法是 −

<wsdl:definitions .... > 
   <wsdl:portType .... > * 
      <wsdl:operation name = "nmtoken" parameterOrder = "nmtokens"> 
         <wsdl:input name = "nmtoken"? message = "qname"/> 
         <wsdl:output name = "nmtoken"? message = "qname"/> 
         <wsdl:fault name = "nmtoken" message = "qname"/>* 
      </wsdl:operation> 
   </wsdl:portType > 
</wsdl:definitions>

请求 ─ 响应

服务发送消息并接收响应。因此，该操作有一个输出元素，后面跟着一个输入元素。为了封装错误，还可以指定可选的故障元素。请求响应操作的语法是−

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

通知

服务发送一条消息。因此，该操作只有一个输出元素。以下是通知操作的语法 −

<wsdl:definitions .... > 
   <wsdl:portType .... > * 
      <wsdl:operation name = "nmtoken"> 
         <wsdl:output name = "nmtoken"? message = "qname"/> 
      </wsdl:operation> 
   </wsdl:portType > 
</wsdl:definitions>

WSDL ─ binding &服务

<binding> 元素提供了有关 portType 操作如何通过网络进行传输的具体细节。

  • 绑定可通过多种传输方式提供，包括 HTTP GET、HTTP POST 或 SOAP。

  • 绑定提供了有关使用哪种协议传输 portType 操作的具体信息。

  • 绑定提供了有关服务所在位置的信息。

  • 对于 SOAP 协议，绑定为 <soap:binding>，传输为 HTTP 协议之上的 SOAP 消息。

  • 您可以为单个 portType 指定多个绑定。

Binding Services

服务

<service> 元素定义 Web 服务支持的端口。对于每个支持的协议，都有一个端口元素。服务元素是端口的集合。

Web 服务客户端可以从服务元素 − 中了解以下内容

  • 从哪里访问服务，
  • 通过哪个端口访问 Web 服务，以及
  • 如何定义通信消息。

服务元素包括一个文档元素，用于提供人类可读的文档。

<wsdl:service name = "CurrencyConvertor">
   <wsdl:port name = "CurrencyConvertorSoap" binding = "tns:CurrencyConvertorSoap">
      <soap:address location = "http://www.webservicex.net/CurrencyConvertor.asmx" />
   </wsdl:port>
   <wsdl:port name = "CurrencyConvertorSoap12"binding = "tns:CurrencyConvertorSoap12>
      <soap12:address location = "http://www.webservicex.net/CurrencyConvertor.asmx" />
   </wsdl:port>
   <wsdl:port name = "CurrencyConvertorHttpGet" binding = "tns:CurrencyConvertorHttpGet">
      <http:address location = "http://www.webservicex.net/CurrencyConvertor.asmx" />
   </wsdl:port>
   <wsdl:portname = "CurrencyConvertorHttpPost"binding = "tns:CurrencyConvertorHttpPost">
      <http:address location = "http://www.webservicex.net/CurrencyConvertor.asmx" />
   </wsdl:port> 
</wsdl:service>
❮ 上一节 下一节 ❯