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