Web Service 接口怎么测试

看过网上很多对 Web Service 的解释，有些文章写得通俗易懂，但是缺少深度解读；有的文章图文并茂，但是没有现成案例；有的文章非常详细，但是没有直观感受。

于是，我想从测试一个 web service 接口的角度，写一篇比较系统的文章，来进一步认识 web service。

Web Service 服务是什么

首先要知道什么是 Service，才能理解 Web Service。

服务（Service）是计算机提供的某种功能，在以前的计算机中，通常以后台程序（Daemon)的形式存在。比如，在计算机中可以安装 MySQL 服务，提供访问数据库的功能；在计算机中安装 SSH 服务，提供远程连接的功能。

服务可以分为两种：本地服务和网络服务。本地服务是在当前计算机上能访问的服务，其他计算机无法访问；网络服务是在另一台计算机上提供服务，其他计算机通过网络连接访问服务，网络既可以是远程的 web 服务，也可以是局域网服务。

举个例子，我想做一个书籍阅读的 App，我已经把书籍的展示页面，收藏书籍这些功能都实现了，但是我既不是写作者，也不是出版社，我根本就没有任何的新闻内容可以展示到 App 上。

我想了两个办法：第一个办法就是把我现在已经有的书籍录入到 App 中，用户安装我的 App 后，不需要联网也是可以阅读书籍的，我提供的书籍数据这种服务就是本地服务。

第二个办法是我直接和出版社合作，直接通过出版社提供的网络服务获取书籍内容，我的 App 只负责展示，当用户需要某本书籍时，通过访问出版社提供的服务就能得到书籍内容。

这种通过网络去获取其他电子内容的服务就是 Web Service。通过这种方式，我还可以实现服务聚合（Service Mashup），同时和多个出版社合作，我可以自己实现一套统一的 Web Service 接口，对接不同的出版社内容。任何形式的网络服务，不管返回 HTML、JSON、XML 还是图片，都是 Web Service。

Web Service 原理

本质上来说，Web Service 就是提供一个数据服务，而其他客户端应用通过网络来获取数据，这些客户端可以是浏览器，可以是手机 App，可以是桌面应用，可以是电视盒子，可以是智能手表。

请求服务和响应服务的数据格式由双方制定（实际上一般由服务方指定，客户端按照要求操作），可以是 HTML，可以是 JSON，也可以是 XML 等其他格式。

实现 Web Service 的技术架构主要有两种方式：

• REST，使用统一的无状态操作集来表示 web 资源，目前的主要数据格式是 JSON，但也可以使用 XML。

• 非 REST，服务可以不使用统一的指令集，进行任意的组合操作，比如 RPC。

广义上的 Web Service 几乎包括了所有的网络服务，而我们平时谈论的 Web Service，是特指 W3C 定义的概念。

A Web service is a software system designed to support interoperable machine-to-machine interaction over a network. It has an interface described in a machine-processable format (specifically WSDL). Other systems interact with the Web service in a manner prescribed by its description using SOAP messages, typically conveyed using HTTP with an XML serialization in conjunction with other Web-related standards.

概括下重点就是说：Web Service 通过 WSDL 描述了一个网络通讯接口，其他的系统可以使用 SOAP 协议和 web service 交互数据，SOAP 基于 HTTP 实现，并且使用 XML 来组织数据。

有点难理解对不对，接下来我们一一解释。

Web Service 协议

接下来谈论的 Web Service 都是指 W3C Web Service，不再是广义上的。要理解这个定义，需要先弄清楚几个概念：WSDL、SOAP、HTTP、XML。

WSDL 文件详解

WSDL 是 Web Service 的接口文档，和你在 Swagger 中看到的接口描述作用完全一样。通过 WSDL，客户端知道该发送什么格式的请求数据，才能被服务正确解析。

WSDL（Web 服务描述语言，Web Services Description Language）读作 wiz-dəl，用来描述 Web 服务的公共接口。它描述了如何调用服务，需要什么参数，以及返回什么数据结构，它的用途大致类似于编程语言中对接口（interface)的类型说明。

一个 WSDL 的描述一般类似这样，实际编写时一般不需要手工填写，也不需要去深入看里面的构成，由工具生成就可以了。 在这个Demo网页中可以看到更多示例，之后会有具体的案例说明。

<?xml version="1.0" encoding="UTF-8"?><description xmlns="http://www.w3.org/ns/wsdl"              xmlns:tns="http://www.tmsws.com/wsdl20sample"              xmlns:whttp="http://schemas.xmlsoap.org/wsdl/http/"             xmlns:wsoap="http://schemas.xmlsoap.org/wsdl/soap/"             targetNamespace="http://www.tmsws.com/wsdl20sample">
<documentation>    This is a sample WSDL 2.0 document. </documentation>
<!-- Abstract type -->   <types>      <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"                xmlns="http://www.tmsws.com/wsdl20sample"                targetNamespace="http://www.example.com/wsdl20sample">                          <xs:element name="request"> ... </xs:element>         <xs:element name="response"> ... </xs:element>      </xs:schema>   </types>
<!-- Abstract interfaces -->   <interface name="Interface1">      <fault name="Error1" element="tns:response"/>      <operation name="Get" pattern="http://www.w3.org/ns/wsdl/in-out">         <input messageLabel="In" element="tns:request"/>         <output messageLabel="Out" element="tns:response"/>      </operation>   </interface>
<!-- Concrete Binding Over HTTP -->   <binding name="HttpBinding" interface="tns:Interface1"             type="http://www.w3.org/ns/wsdl/http">      <operation ref="tns:Get" whttp:method="GET"/>   </binding>   <!-- Concrete Binding with SOAP-->   <binding name="SoapBinding" interface="tns:Interface1"             type="http://www.w3.org/ns/wsdl/soap"             wsoap:protocol="http://www.w3.org/2003/05/soap/bindings/HTTP/"            wsoap:mepDefault="http://www.w3.org/2003/05/soap/mep/request-response">      <operation ref="tns:Get" />   </binding>
<!-- Web Service offering endpoints for both bindings-->   <service name="Service1" interface="tns:Interface1">      <endpoint name="HttpEndpoint"                 binding="tns:HttpBinding"                 address="http://www.example.com/rest/"/>      <endpoint name="SoapEndpoint"                 binding="tns:SoapBinding"                 address="http://www.example.com/soap/"/>   </service></description>

SOAP 协议

SOAP 是一组标准的 XML 数据格式，通常在 HTTP 请求中传递。但其实除了 HTTP 以外，它也可以在 SMTP、UDP、TCP 等协议上传输，自然也可以用在 web service 上。也就是说，作为一种组装数据的格式，它是独立的。

看一个具体的例子，下面表示访问 InStock服务中的GetStockPrice接口，并且传递参数 StockName为 T。

POST /InStock HTTP/1.1Host: www.example.orgContent-Type: application/soap+xml; charset=utf-8Content-Length: 299SOAPAction: "http://www.w3.org/2003/05/soap-envelope"
<?xml version="1.0"?><soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:m="http://www.example.org">  <soap:Header>  </soap:Header>  <soap:Body>    <m:GetStockPrice>      <m:StockName>T</m:StockName>    </m:GetStockPrice>  </soap:Body></soap:Envelope>

从这个例子中可以看出，SOUP 消息内容是由 XML 编写的，主要分为几个部分：

• Envelope，将 XML 文档标识为 SOAP 消息，必须

• Header，消息头，可以不填。

• Body, 包含需要调用的接口，参数以及响应信息，必须。

• 还有一个 Fault，表示调用过程出错后的展示信息。

Web Service 接口测试

根据上面的内容，大致梳理了 WSDL、SOUP、XML 和 HTTP 的关系。

现在可以开始测试 web service 服务了。

1、在浏览器中查看一个WSDL描述文件， 也可以访问parasoft的示例网站获取更多 WSDL 文件。

2、在 chrome 浏览器中安装 Wizdler 插件或者 Boomerang，可以从 WSDL 中解析服务提供的接口，以及访问接口需要填写的参数类型。

3、点击接口名称，跳转到测试页面，修改请求参数。比如在 addInteger 接口中插入 12 和 13 两个参数。

4、点击 Go 就可以往 Web Service 发送请求，得到响应结果。

Postman 测试 web service

使用 Postman 测试 Web Service 并无太大区别，还是读取 WSDL 文件，从中解析出每个接口需要传递的参数格式。

• 在 URL 中填入服务地址

• 请求方法选择 POST 请求

• 请求格式选在 application/xml

• 把 WSDL 生成的请求数据复制到 body 参数中

Python 测试 web service 接口

Python 测试 web service 接口和 postman 没什么区别，只是把界面操作转化成代码。

1. requests.post 可以直接发送 http 请求

2. 准备好 SOUP 格式的请求体，传入 data 参数

3. 请求头中把 content-type 修改成 appliction/xml

import requests
data = """\<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">    <Body>        <getItemById xmlns="http://bookstore.parasoft.com/">            <id xmlns="">1</id>        </getItemById>    </Body></Envelope>"""url = 'https://parabank.parasoft.com/parabank/services/store-01'headers = {'content-type': 'application/xml'}resp = requests.post(url, data=data,)print(resp.text)

Python 测试 web service 的终极方案

俗话说，有轮子就不要自己再造，Python 之所以这么多人用就是生态完善，你能想到的场景基本都有现成的库可以调用。而访问 web service 接口可以使用 zeep 这个库。

有了它之后，你只需要传入 wsdl 文件或者 url 地址，zeep 会自动帮你解析。 你也不用再自己组装 SOUP 数据，zeep 会帮你组装。 访问接口后的响应结果你也不用解析，zeep 帮你解析了。

import zeep
wsdl = 'https://parabank.parasoft.com/parabank/services/store-01?wsdl'client = zeep.Client(wsdl=wsdl)resp = client.service.getItemById(1)print(resp['name'])

是不是很简洁？现在我们就讲这么多把，后面有时间再讲一下 zeep 的系统用法。

参考：

• 阮一峰：web service是什么
  

• wiki百科：web service
  

• REST
  

• wiki百科：REST
  

• wiki百科：WSDL
  

• W3C WSDL 2.0
  

• wiki百科：SOUP
  

• w3c: SOUP
  

• zeep
  

我是九柄，公众号【 九柄 】，分享软件测试文章、面试、教程资料，欢迎来看看。