此处我们以qqCheckOnline的WebService接口为例进行讲解,接口的具体信息如下:
l 接口描述:获得腾讯QQ在线状态
l 入参:qqCode,String类型,默认QQ号码:8698053
l 出参:qqCheckOnlineResult,String类型
返回数据代表的含义为:Y = 在线;N = 离线;E = QQ号码错误;A = 商业用户验证失败;V = 免费用户超过数量
l 返回格式:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<qqCheckOnlineResponse xmlns="http://WebXml.com.cn/">
<qqCheckOnlineResult>string</qqCheckOnlineResult>
</qqCheckOnlineResponse>
</soap:Body>
</soap:Envelope>
了解了接口信息之后我们来看看如何完成接口用例脚本的设计,大致步骤如图5.1所示
图5.1 接口用例脚本设计步骤
5.2.1 单接口的测试方法
按照图5.1所示的步骤完成初步设置后,脚本结构如图5.2所示,这个是最简单的脚本状态,还有很多地方需要我们优化改进,下面我们就把常见的优化方法分别讲解下。注意:后续的操作都在TestSuite中完成。
图5.2 脚本结构
根据接口的信息我们在设计测试用例的时候,可能需要考虑多种情况,包括但不限于正确的QQ号码、错误的QQ号码、处于在线状态的QQ号码和处于离线状态的QQ号码等来验证各种情况下的接口的正确性,具体的用例需要根据具体的接口信息来设计。此处我们只以正确且处于在线状态的QQ号码为例进行讲解。
1. 参数化
打开我们TestSteps下的qqCheckOnline接口,如图5.3所示,你会发现其中的qqCode是写死的,显然这个不是我们希望的,我们希望这里是“活”的。
图5.3 qqCode
那如何能使该参数变“活”呢,这时候就要利用DataSource这个强大的功能了。在DataSource中可以通过多种外部介质来实现参数化,比如:
l File:文本文件的形式。
l Excel:最好使用2003格式的Excel。
l Grid:表格形式。
l JDBC:JDBC数据源,就是从数据库中获取。
l XML:XML格式。
l Groovy:Groovy脚本形式。
这里我们使用File类型的文本文件形式进行参数化,大致实现步骤如下:
1) 在本地电脑上新建一个文本文件:qq.txt,并在文件中输入如图5.4所示的内容。
图5.4 qq.txt
2) 新建一个DataSource,填入相关的数据信息,注意它的顺序要位于接口之前。如图4.5所示。
图5.5 DataSource
部分字段的解释如下:
l DataSource:选择外部的存储介质。
l File:选择文件的路径。
l Properties:把从外部存储介质中获取的结果保存到这里。
l 其余的字段可以保持默认。
3) 切换到qqCheckOnline接口,把之前写死的qqCode变“活”。只需在qqCode参数处右键鼠标选择“Get Data”下对应步骤中的Properties即可。如图5.6所示。
图5.6 Get Data
4) 增加DataSource Loop,完成参数化的遍历,如果不添加这个则永远取出来的是第一个QQ号码,最终的脚本结构如图5.7所示。其中DataSource Step是选择的源数据,Target Step是选择目标步骤。这里需要特别注意DataSource、接口、DataSource Loop的顺序。
图5.7 DataSource Loop
2. 断言(检查点)
既然我们是做接口的功能自动化,那一定会对返回的响应数据(出参)进行检查,只有符合我们预期结果才能认为该接口通过测试,要完成这件事情就需要用到断言,也就是大家常说的检查点,大致实现步骤如下:
1) 双击TestSteps中的接口并运行,在响应区域对你想检查的内容添加断言,右键选择Add Assertion->for Cotent,如图5.8所示。
图5.8 选择断言
2) 在弹出的“XPath Expression”对话框中我们可以看到已经识别出来了要检查的内容就是qqCheckOnlineResult对应的值Y,直接点击“save”按钮即可,如图5.9所示。
图5.9 确认断言
3) 最终完成后的效果如图5.10所示,其中Assertions表示的就是断言。
图5.10 断言效果图
在SoapUI中有多种形式的断言,可谓功能十分强大,可以通过单击“Add Assertion”来查看,具体内容见书籍中的第五章。
3. 运行与报告
完成上述步骤之后,你就可以运行本用例脚本了,双击本TestCase,在弹出的“qqCheckOnline TestCase”对话框中点击“绿色小箭头”即可,如图5.13所示。如果想看SoapUI生成的测试报告,点击“文档”形状的图标即可,测试报告样式如图5.14所示。
所有类似这样单接口的测试大概都是这个过程,大家需要根据具体的接口信息做一定的调整,但整体的思路和方法是大同小异的,也希望大家在不断学习的过程中可以悟到“一通百通”的道理,这样即使你只有2年的工作经验也可能会超过有5年工作经验的朋友。