若要快速地将验证添加到 SOAP 客户端和 REST 客户端工具中,则可以直接从 CTP 界面创建断言器工具。对于 SOAP 客户端,您可以添加 XML 断言器工具。对于 REST 客户端,您可以添加 XML 或 JSON 断言器工具。CTP 中添加的任何断言器工具都将附加到所选测试的响应通讯报文。
桌面端的验证工具
此外,您可以使用桌面端产品对添加到响应通讯报文的断言器工具进行编辑。使用 SOAtest 桌面端添加到请求通讯报文的任何断言器工具在 CTP 都将不可见。
比较工具 vs. 断言器工具
如果要检查消息的所有部分或大部分是否与回归控制匹配,则使用比较工具。如果要检查消息的特定元素,并且/或者想验证除匹配之外的其他内容,则使用断言器工具。
添加断言器工具
添加新的断言器工具:
- 如果您还未运行关联的 REST 客户端或 SOAP 客户端工具,请先运行工具(如,通过选择相关的 .tst 树节点并点击执行)。在添加断言器之前,工具的通讯报文查看器必须包含通讯报文。
- 在左窗格中,请选择希望验证其响应的 REST 客户端或 SOAP 客户端。
- 在页面级操作菜单中选择添加 JSON 断言器或添加 XML 断言器。应在 REST 客户端而非 SOAP 客户端中使用 JSON 断言器。
- (可选)修改新建工具的名称。
- 按照下面的描述配置工具。
- 保存新工具的配置。
新工具将作为输出“链接”到所选测试客户端工具的响应通讯报文。
配置断言器工具
若要配置断言器工具:
- 包含的测试套件如果有多个数据源,则可以查看并更改此工具使用的数据源。详情请参阅使用数据源和数据库值参数化。
- 点击添加断言并选择要添加的断言类型。断言类型中对可用的断言进行了说明。
根据所选定断言配置断言工具的详细信息。
点击元素字段将打开 Xpath 构建器,在指定 XPath 中有所描述。在 XPath 构建器中选择一个元素以填充元素字段以及任何其他适用的字段(例如,期望值、期望类型等)。
在将提取的字符串与预期文本进行比较之前,修剪内容选项将删除提取字符串的开始和结束部分的任何空格。例如,如果提取了“bar”(忽略所有示例中的引号;它们被用来显示空格),它会变成“bar”;如果没有启用修剪内容选项,这将匹配“bar”(并且无法匹配“bar”)。
保存预期保存关联测试客户端接收到的消息。XPath 构建器使用此消息。
- 对要添加的每个断言重复上述过程。一个断言器可以检查多个断言。
断言类型
可以将以下类型的断言添加到断言器中。
值断言
类型 | 说明 |
---|---|
值断言 | 确保特定元素的值。 |
值出现次数断言 | 确保具有特定值的元素出现一定次数(例如,Xpath 选择器和所指定值字符串上的文档必须有 n 个匹配项)。 |
数字断言 | 确保元素的数值。 |
字符串比较断言 | 确保特定元素的文本内容的值。 |
正则表达式断言 | 确保元素匹配正则表达式。 |
结构断言
类型 | 说明 |
---|---|
出现次数断言 | 确保元素出现的次数。 |
有内容断言 | 确保元素具有文本内容(即,文本长度 > 0)。 |
类型断言 | 确保元素的类型。 仅适用于 JSON 断言器。 |
范围断言
类型 | 说明 |
---|---|
数值范围断言 | 确保元素的数值位于某个数值范围包含的范围内。 |
日期范围断言 | 确保特定元素的值使用某个日期范围。 |
日期时间范围断言 | 确保特定元素的值使用某个日期时间范围。 |