看过网上很多对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.1
Host: www.example.org
Content-Type: application/soap+xml; charset=utf-8
Content-Length: 299
SOAPAction: "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 没什么区别,只是把界面操作转化成代码。
- requests.post 可以直接发送 http 请求
- 准备好 SOUP 格式的请求体,传入 data 参数
- 请求头中把 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'])
接口测试面试
做接口测试的主要难点在于接口的协议往往各有不同,除了经常用到的 REST HTTP 协议, 还有文本介绍的 webservice 协议, 还会有 grpc, websocket 等其他非常流行的协议,这些内容也往往非常喜欢在技术面试中问到。
最后感谢每一个认真阅读我文章的人,礼尚往来总是要有的,虽然不是什么很值钱的东西,如果你用得到的话可以直接拿走:
这些资料,对于【软件测试】的朋友来说应该是最全面最完整的备战仓库,这个仓库也陪伴上万个测试工程师们走过最艰难的路程,希望也能帮助到你!有需要的小伙伴可以点击下方小卡片领取