SOAP WebService接口功能自动化测试

此处我们以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年工作经验的朋友。