-
引言
-
什么是 Web Services
-
Web Services 构成及调用原理
-
Web Services 接口和 API(应用程序接口)的区别
-
Web Services 接口实战
-
1.suds - SOAP 客户端
-
2.Zeep - SOAP 客户端
-
3.Zeep 和 suds 的比较
-
-
总结
引言
之前分享过很多篇基于 HTTP 请求的 API 和 UI 自动化测试的文章。
实际上,接口有很多形式,除了我们常见的 HTTP 形式的 RESTFUL 接口外,还有 Web Services 类型的接口,以及 RPC 接口。不同类型的接口测试方式各有不同。
今天分享的主题是:如何测试 Web Services 类型的接口。
什么是 Web Services
Web Service 是一种跨编程语言和跨操作系统平台的远程调用技术。
通俗地讲,Web Service 就是一个应用程序,它通过向外界暴露一个能够通过 Web 进行调用的 API 来对外提供服务。WebService 可以跨编程语言和跨操作系统,即你的客户端程序和提供服务的服务端程序可以采用不同的编程语言,使用不同的操作系统。
例如:通过 WebServices,你运行在 windows 平台上的、以 C++ 编写的客户端程序就可以和运行在 Linux 平台上的,以 Java 编写的服务器程序进行通信。
Web Services 构成及调用原理
Web Service 平台的构成,依赖以下技术:
-
UDDI:意为统一描述、发现和集成(Universal Description, Discovery, and Integration),它是一种目录服务,通过它企业可注册并搜索 Web services,它是基于 XML 的跨平台描述规范。
-
SOAP:是一种简单的基于 XML 的协议,它使应用程序通过 HTTP 来交换信息。
-
WSDL:是基于 XML 的,用于描述 Web Services,以及如何访问 Web Services 的语言。
Web Services 的调用原理如下:
Step 1:客户端想调用一个服务,但不知道去哪调用,因此它向 UDDI 注册中心发起询问。
Step 2:UDDI 注册中心,通过一番搜索,发现有个叫 Web Service A的小伙子可以提供客户端想要的服务。
Step 3:客户端向 Web Service A 发送消息,询问该如何调用它提供的服务。
Step 4:Web Service A 收到请求,发送给客户端一个 WSDL 文件。这里记录了 Web Service A 可以提供的各类方法接口。
Step 5:客户端通过 WSDL 生成 SOAP 请求(将 Web Service 提供的 xml 格式的接口方法,采用 SOAP 协议封装成 HTTP 请求),发送给 Web Service A,调用它想要的服务。
Step 6:Web Service A 按照 SOAP 请求执行相应的服务,并将结果返回给客户端。
Web Services 接口和 API(应用程序接口)的区别
Web Services 接口和我们常用的 API(应用程序接口)有哪些区别呢?下面的表格展示了它们的区别:
在我们的日常工作中,接口是以 Web Service、API,还是 RESTFUL API 形式提供给我们测试,常常取决于业务的实际情况。
Web Services 接口实战
通过前面的讲解我们了解,WSDL 是 Web Services 生成给客户端调用的接口服务描述。通过 WSDL,客户端就可以构造正确的请求发送给服务端。
在实际工作中也是如此,对于 Web Services 形式的接口,开发提供的往往就是一个 WSDL 格式的链接。比如,下面的一个链接就是一个公用的 Web Servbice 服务接口:
# IP地址服务
http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?wsdl
1.suds - SOAP 客户端
在 Python 中,客户端调用 Web Service 可以通过 suds 这个库来实现。suds Client 类提供了用于使用 Web Service 的统一 API 对象,这个对象包括以下两个命名空间。
-
service:service 对象用来调用被消费的 web service 提供的方法。
-
factory:提供一个工厂(factory),可用于创建 WSDL 中定义的对象和类型的实例。
suds 的使用
-
suds 安装
在 Python 官方停止支持 Python 2.X 版本并全面转到 Python 3.X 后,suds 原始项目的开发已经停滞了,但这不意味着 suds 不再支持 Python 3.X。suds-community fork 了原本的 suds 库,并开发了能够支持 Python 3.X的 版本,其安装命令如下:
pip install suds-community
-
简单使用
from suds.client import Client
if __name__ == "__main__":
url = 'http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?wsdl'
# 初始化
client = Client(url)
# 打印出所有可用的方法
print(client)
直接运行上述代码,你会发现执行结果如下:
# 运行结果片段
Suds ( https://fedorahosted.org/suds/ ) version: 0.8.4
Service ( IpAddressSearchWebService ) tns="http://WebXml.com.cn/"
Prefixes (1)
ns0 = "http://WebXml.com.cn/"
Ports (2):
(IpAddressSearchWebServiceSoap)
Methods (3):
getCountryCityByIp(xs:string theIpAddress)
getGeoIPContext()
getVersionTime()
Types (1):
ArrayOfString
(IpAddressSearchWebServiceSoap12)
Methods (3):
getCountryCityByIp(xs:string theIpAddress)
getGeoIPContext()
getVersionTime()
Types (1):
ArrayOfString
在这段代码中,打印出来了 IpAddressSearchWebService 支持的所有方法。你可以看到, 它有三个方法(Methods(3) 显示出这个 Web Service 所提供的方法及参数)。
-
实际案例
既然看出 IpAddressSearchWebService 这个 Web Service 支持 3 种方法,那么我们来应用下这些方法:
from suds.client import Client
if __name__ == "__main__":
url = 'http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?wsdl'
# 初始化
client = Client(url)
# 打印出所有支持的方法
print(client)
# 调用支持的方法, 使用client.service
print(client.service.getVersionTime())
print(client.service.getCountryCityByIp('192.168.0.1'))
执行上述代码,你会发现有如下输出:
# 输出结果片段
# 此为getVersionTime这个方法的输出
IP地址数据库,及时更新
# 此为getCountryCityByIp方法的输出
(ArrayOfString){
string[] =
"192.168.0.1",
"局域网 对方和您在同一内部网",
}
注意,在代码里,我使用了 client.service 的方式,那是因为 service 对象用来调用被消费的 web service 提供的方法的。
在实际工作中,你遇见的 WSDL 接口将会比这个复杂得多。故正常情况下,我们会将 WSDL 的接口封装成类使用,然后针对每个类方法,编写相应的测试用例,如下所示:
import pytest
from suds.client import Client
@pytest.mark.rmb
class WebServices(object):
WSDL_ADDRESS = 'http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?wsdl'
def __init__(self):
self.web_service = Client(self.WSDL_ADDRESS)
def get_version_time(self):
return self.web_service.service.getVersionTime()
def get_country_city_by_ip(self, ip):
return self.web_service.service.getCountryCityByIp(ip)
class TestWebServices:
def test_version_time(self):
assert WebServices().get_version_time() == "IP地址数据库,及时更新"
@pytest.mark.parametrize('ip, expected', [('10.10.10.10', '10.10.10.10')])
def test_get_country_city_by_ip(self, ip, expected):
assert expected in str(WebServices().get_country_city_by_ip(ip))
if __name__ == "__main__":
pytest.main(["-m", "rmb", "-s", "-v"])
2.Zeep - SOAP 客户端
Zeep 是 Python 中的一个现代化的 SOAP 客户端。Zeep 通过检查 WSDL 文档并生成相应的代码,来使用 WSDL 文档中的服务和类型。这种方式为 SOAP 服务器提供了易于使用的编程接口。
下面来具体讲解下 Zeep 的使用:
-
Zeep 安装
安装命令如下:python pip install zeep
-
Zeep 查询 WSDL 中可用的方法
相对于 suds 来说,想要查看一个 WSDL 描述中有哪些方法可用,Zeep 无须进行初始化动作。直接在命令行中输入如下命令即可:
python -mzeep http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?wsdl
执行后,会发现输出如下:
Prefixes:
xsd: http://www.w3.org/2001/XMLSchema
ns0: http://WebXml.com.cn/
Global elements:
ns0:ArrayOfString(ns0:ArrayOfString)
ns0:getCountryCityByIp(theIpAddress: xsd:string)
ns0:getCountryCityByIpResponse(getCountryCityByIpResult: ns0:ArrayOfString)
ns0:getGeoIPContext()
ns0:getGeoIPContextResponse(getGeoIPContextResult: ns0:ArrayOfString)
ns0:getVersionTime()
ns0:getVersionTimeResponse(getVersionTimeResult: xsd:string)
ns0:string(xsd:string)
Global types:
xsd:anyType
ns0:ArrayOfString(string: xsd:string[])
xsd:ENTITIES
xsd:ENTITY
xsd:ID
xsd:IDREF
xsd:IDREFS
xsd:NCName
xsd:NMTOKEN
xsd:NMTOKENS
xsd:NOTATION
xsd:Name
xsd:QName
xsd:anySimpleType
xsd:anyURI
xsd:base64Binary
xsd:boolean
xsd:byte
xsd:date
xsd:dateTime
xsd:decimal
xsd:double
xsd:duration
xsd:float
xsd:gDay
xsd:gMonth
xsd:gMonthDay
xsd:gYear
xsd:gYearMonth
xsd:hexBinary
xsd:int
xsd:integer
xsd:language
xsd:long
xsd:negativeInteger
xsd:nonNegativeInteger
xsd:nonPositiveInteger
xsd:normalizedString
xsd:positiveInteger
xsd:short
xsd:string
xsd:time
xsd:token
xsd:unsignedByte
xsd:unsignedInt
xsd:unsignedLong
xsd:unsignedShort
Bindings:
HttpGetBinding: {http://WebXml.com.cn/}IpAddressSearchWebServiceHttpGet
HttpPostBinding: {http://WebXml.com.cn/}IpAddressSearchWebServiceHttpPost
Soap11Binding: {http://WebXml.com.cn/}IpAddressSearchWebServiceSoap
Soap12Binding: {http://WebXml.com.cn/}IpAddressSearchWebServiceSoap12
Service: IpAddressSearchWebService
Port: IpAddressSearchWebServiceSoap (Soap11Binding: {http://WebXml.com.cn/}IpAddressSearchWebServiceSoap)
Operations:
getCountryCityByIp(theIpAddress: xsd:string) -> getCountryCityByIpResult: ns0:ArrayOfString
getGeoIPContext() -> getGeoIPContextResult: ns0:ArrayOfString
getVersionTime() -> getVersionTimeResult: xsd:string
Port: IpAddressSearchWebServiceSoap12 (Soap12Binding: {http://WebXml.com.cn/}IpAddressSearchWebServiceSoap12)
Operations:
getCountryCityByIp(theIpAddress: xsd:string) -> getCountryCityByIpResult: ns0:ArrayOfString
getGeoIPContext() -> getGeoIPContextResult: ns0:ArrayOfString
getVersionTime() -> getVersionTimeResult: xsd:string
Port: IpAddressSearchWebServiceHttpGet (HttpGetBinding: {http://WebXml.com.cn/}IpAddressSearchWebServiceHttpGet)
Operations:
getCountryCityByIp(theIpAddress: xsd:string) -> xsd:string
getGeoIPContext() -> xsd:string
getVersionTime() -> xsd:string
Port: IpAddressSearchWebServiceHttpPost (HttpPostBinding: {http://WebXml.com.cn/}IpAddressSearchWebServiceHttpPost)
Operations:
getCountryCityByIp(theIpAddress: xsd:string) -> xsd:string
getGeoIPContext() -> xsd:string
getVersionTime() -> xsd:string
从结果中可以看出,IpAddressSearchWebService 提供了 3 个 method,分别是 getCountryCityByIp,getGeoIPContext 和 getVersionTime。
-
简单使用
在得知有哪些方法可用后,我们就可以直接调用可用的方法:
import zeep
if __name__ == "__main__":
wsdl = 'http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?wsdl'
client = zeep.Client(wsdl=wsdl)
print(client.service.getCountryCityByIp('10.10.10.10'))
-
实际案例
现在我们把上面用 suds 实现的测试 IpAddressSearchWebService 的代码更改为使用 Zeep 测试:
import pytest
import zeep
@pytest.mark.rmb
class WebServices(object):
WSDL_ADDRESS = 'http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?wsdl'
def __init__(self):
self.web_service = zeep.Client(wsdl=self.WSDL_ADDRESS)
def get_version_time(self):
return self.web_service.service.getVersionTime()
def get_country_city_by_ip(self, ip):
return self.web_service.service.getCountryCityByIp(ip)
class TestWebServices:
def test_version_time(self):
assert WebServices().get_version_time() == "IP地址数据库,及时更新"
@pytest.mark.parametrize('ip, expected', [('10.10.10.10', '10.10.10.10')])
def test_get_country_city_by_ip(self, ip, expected):
assert expected in str(WebServices().get_country_city_by_ip(ip))
if __name__ == "__main__":
pytest.main(["-m", "rmb", "-s", "-v"])
可以看到,使用 Zeep 来调用 Web Service 服务同样很简单。
3.Zeep 和 suds 的比较
suds 是一个老牌的 SOAP 客户端,而 Zeep 是当前特别流行的一个 SOAP 客户端。那么我们应该如何选用呢?这里列出来几点两者的区别,仅供参考:
综上所述,Zeep 对最新版本的 Python 支持的更好,而且没有性能问题。如果你的项目是新设立的,在选用Web Service客户端时,不妨直接使用Zeep。
总结
今天的分享重点介绍了 Web Service 及 Web Service 接口,尤其是以 WSDL 格式提供的接口应该如何测试。
并且介绍了两个测试Web Service的Python 库suds和Zeep,以及在日常工作中,我们是如何使用suds或者Zeep来封装Web Services接口的。
欢迎关注【无量测试之道】公众号,回复【领取资源】
Python编程学习资源干货、
Python+Appium框架APP的UI自动化、
Python+Selenium框架Web的UI自动化、
Python+Unittest框架API自动化、
资源和代码 免费送啦~
文章下方有公众号二维码,可直接微信扫一扫关注即可。
备注:我的个人公众号已正式开通,致力于测试技术的分享,包含:大数据测试、功能测试,测试开发,API接口自动化、测试运维、UI自动化测试等,微信搜索公众号:“无量测试之道”,或扫描下方二维码:
添加关注,让我们一起共同成长!