如何测试webservice接口

看过网上很多对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网页中可以看到更多示例，之后会有具体的案例说明。

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

2. <description xmlns="http://www.w3.org/ns/wsdl"

3. xmlns:tns="http://www.tmsws.com/wsdl20sample"

4. xmlns:whttp="http://schemas.xmlsoap.org/wsdl/http/"

5. xmlns:wsoap="http://schemas.xmlsoap.org/wsdl/soap/"

6. targetNamespace="http://www.tmsws.com/wsdl20sample">

8. <documentation>

9. This is a sample WSDL 2.0 document.

10. </documentation>

12. <!-- Abstract type -->

13. <types>

14. <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"

15. xmlns="http://www.tmsws.com/wsdl20sample"

16. targetNamespace="http://www.example.com/wsdl20sample">

18. <xs:element name="request"> ... </xs:element>

19. <xs:element name="response"> ... </xs:element>

20. </xs:schema>

21. </types>

23. <!-- Abstract interfaces -->

24. <interface name="Interface1">

25. <fault name="Error1" element="tns:response"/>

26. <operation name="Get" pattern="http://www.w3.org/ns/wsdl/in-out">

27. <input messageLabel="In" element="tns:request"/>

28. <output messageLabel="Out" element="tns:response"/>

29. </operation>

30. </interface>

32. <!-- Concrete Binding Over HTTP -->

33. <binding name="HttpBinding" interface="tns:Interface1"

34. type="http://www.w3.org/ns/wsdl/http">

35. <operation ref="tns:Get" whttp:method="GET"/>

36. </binding>

38. <!-- Concrete Binding with SOAP-->

39. <binding name="SoapBinding" interface="tns:Interface1"

40. type="http://www.w3.org/ns/wsdl/soap"

41. wsoap:protocol="http://www.w3.org/2003/05/soap/bindings/HTTP/"

42. wsoap:mepDefault="http://www.w3.org/2003/05/soap/mep/request-response">

43. <operation ref="tns:Get" />

44. </binding>

46. <!-- Web Service offering endpoints for both bindings-->

47. <service name="Service1" interface="tns:Interface1">

48. <endpoint name="HttpEndpoint"

49. binding="tns:HttpBinding"

50. address="http://www.example.com/rest/"/>

51. <endpoint name="SoapEndpoint"

52. binding="tns:SoapBinding"

53. address="http://www.example.com/soap/"/>

54. </service>

55. </description>

 SOAP协议

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

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

1. POST /InStock HTTP/1.1

2. Host: www.example.org

3. Content-Type: application/soap+xml; charset=utf-8

4. Content-Length: 299

5. SOAPAction: "http://www.w3.org/2003/05/soap-envelope"

7. <?xml version="1.0"?>

8. <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:m="http://www.example.org">

9. <soap:Header>

10. </soap:Header>

11. <soap:Body>

12. <m:GetStockPrice>

13. <m:StockName>T</m:StockName>

14. </m:GetStockPrice>

15. </soap:Body>

16. </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

1. import requests

3. data = """\

4. <Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">

5. <Body>

6. <getItemById xmlns="http://bookstore.parasoft.com/">

7. <id xmlns="">1</id>

8. </getItemById>

9. </Body>

10. </Envelope>

11. """

12. url = 'https://parabank.parasoft.com/parabank/services/store-01'

13. headers = {'content-type': 'application/xml'}

14. resp = requests.post(url, data=data,)

15. print(resp.text)

Python 测试 web service 的终极方案

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

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

1. import zeep

3. wsdl = 'https://parabank.parasoft.com/parabank/services/store-01?wsdl'

4. client = zeep.Client(wsdl=wsdl)

5. resp = client.service.getItemById(1)

6. print(resp['name'])

接口测试面试

做接口测试的主要难点在于接口的协议往往各有不同，除了经常用到的 REST HTTP 协议， 还有文本介绍的 webservice 协议， 还会有 grpc, websocket 等其他非常流行的协议，这些内容也往往非常喜欢在技术面试中问到。

 

总结：

感谢每一个认真阅读我文章的人！！！

作为一位过来人也是希望大家少走一些弯路，如果你不想再体验一次学习时找不到资料，没人解答问题，坚持几天便放弃的感受的话，在这里我给大家分享一些自动化测试的学习资源，希望能给你前进的路上带来帮助。

软件测试面试文档

我们学习必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有字节大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。

 

          视频文档获取方式：
这份文档和视频资料，对于想从事【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴我走过了最艰难的路程，希望也能帮助到你！以上均可以分享，点下方小卡片即可自行领取。