本主题涵盖了 SOAtest 和 Virtualize 中的 XML 断言器工具。该工具强制 XML 消息中数据的正确性。 此工具需要验证许可证。
本章包含：

了解 XML 断言器

该工具通常连接到 SOAP 客户机或消息传递客户机，以便验证服务返回的数据。XML 断言器提供了对复杂消息验证需求的支持，而不需要脚本，并且允许您轻松地在 XML 消息上创建和维护验证断言。

在验证来自服务的结果时，您可能希望应用符合业务需求的特定规则。可能不足以验证是否发生了更改;您可能还想定义复杂的规则，定义可接受的 XML 消息的组成。

XML 断言器目的在于提供一系列断言，这些断言可以为消息有效性实施更符合逻辑和业务的规则。

这个工具通常是从 XML 消息的 Create/Update Regression Control 对话框中添加的（通过选择 Create Value Assertion 选项）。有关以这种形式添加 XML 断言器的更多详情，请查阅 对单个响应元素的值进行验证。 
 

它还可通过 Add Output 向导添加，如 添加测试输出中所述。

 

配置 XML 断言器

XML 断言器由三个主要选项卡组成：

• Summary: 此选项卡包含一个表，显示已配置的 XML 断言的详细信息。
• Configuration: 此选项卡用于创建和配置 XML 断言。
• Expected XML: 指定预期的 XML 响应，创建可以从中选择元素的模板。如果此工具接收一个有效的 XML 消息（比如，该消息来自流量或者在附加的客户机工具中定义），则此面板将自动被填充。作为一种选择，可以将示例消息复制到 Literal 或 Tree 选项卡中。注意，默认情况下不会保存预期 XML；如果要对它进行保存，请启用 Save Expected XML 选项。

若要配置 XML 断言器: 

1. 单击 XML 断言器配置选项卡中的 Add 按钮。
   
   
   
    将显示 Select Assertion 向导。
   
   
   
   
2. 选择一个断言类型。下面是对可用断言类型的简要总结。
   • Value Assertions: 可以使用以下值断言：
     
     • Value Assertion: 强制执行特定元素的值。
     • Value Occurrence Assertion: 强制具有给定值的元素出现一定数量（例如，Xpath 选择器和所指定值字符串上的文档必须 n 个匹配项）。
     • Numeric Assertion: 强制元素的数值。
     • String Comparison Assertion: 执行给定元素的文本内容的值。
     • Regular Expression Assertion: 强制元素匹配正则表达式。
     • Expression Assertion: 执行由元素组成的表达式的值。
     • Custom Assertion: 通过编写自定义逻辑脚本来强制执行元素的值。
   • Structure Assertions: 可以使用以下结构断言：
     • Occurrence Assertion: 强制元素出现的次数。
     • Has Content Assertion: 强制元素具有文本内容（即，文本长度> 0）。
     • Has Children Assertion: 强制一个元素有一个或多个子元素。
   • Compound Assertions: 可以使用以下组合断言：
     • AND Assertion: 将所有必须成功的多个断言分组。
     • OR Assertion: 在至少一个断言必须成功的地方对多个断言进行分组。
     • Conditional Assertion: 只有在满足条件时才强制执行断言（条件是以前定义的断言的组合）。
   • Difference Assertions: 可以使用以下差异断言：
     • Numeric Difference Assertion: 对特定元素的值强制执行数值差异。断言元素的数值与用户指定的基值之间存在用户指定值的差异。例如，为了断言华氏度的值低于冰点 3 度，可以将基本值设置为 32，差值设置为 -3。
     • Date Difference Assertion: 对特定元素的值强制执行日期差异。
     • DateTime Difference Assertion: 对特定元素的值强制执行日期时间差异。
   • Range Assertions: 可以使用以下差异断言：
     • Numeric Range Assertion: 强制元素的数值位于数值范围的包含范围内。
     • Date Range Assertion: 对特定元素的值强制使用日期范围
     • DateTime Range Assertion: 对特定元素的值强制设置日期时间范围
3. 单击 Next 按钮。将显示一个树视图。
   
   
   
   

4. 选择要检查此断言的元素，然后单击 Finish 按钮。注意，您可以在 XML 断言器工具的 Expected XML 选项卡中编辑此树的结构。 

   关于详细信息，清查阅 区分大小写 。

您可以通过单击 Configuration 选项卡中的 Add 按钮，添加附加的断言来应用于消息（例如要对 price 元素强制执行的数字断言）。

如果稍后想修改断言引用的元素，请单击 Configuration 右下角的 Change Element 。这将打开一个对话框，允许您图形化或手动编辑给定的元素。您可以单击 Evaluate Xpath 按钮，查看对预期 XML 应用 Xpath 表达式的结果。

 

 注意，在将提取的字符串与预期文本进行比较之前， Trim content 选项将删除提取字符串的开始和结束部分的任何空格。例如，如果提取了“bar”（忽略所有示例中的引号；它们被用来显示空格），它会变成“bar”；如果没有启用 Trim content 选项，这将匹配“bar”（并且无法匹配“bar”）。

如果您有如下 XML

<foo>
bar
</foo>

如果“bar”值前后的新行字符无趣，而且主要是格式化问题，那么您可能希望启用此选项，这样在创建提取时就不必考虑 XML 的格式。

参数化 XPaths

可以参数化 Xpaths 以引用测试或响应程序套件变量、环境变量和数据源值。  引用变量的语法为 ${myVariableName}。引用 XML 数据库值和数据源值的语法为：${myColumnName}. 

例如，如果 ${XPath Key} 是数据源列名，则可以使用

/*[local-name(.)="bookstore" and namespace-uri(.)=""]/*[local-name(.)="book" 和

namespace-uri(.)=""][child::node()[local-name(.)="title" and text()="${XPath Key}"]]

相关教程

以下教程演示如何使用此工具：

• 服务功能测试
• 使用脚本扩展 SOAtest