本主题解释如何在 SOAtest 和 Virtualize 中配置并应用 WS-I 工具。此工具检查 WSDL 是否遵循 WS-I 的 Basic Profile 2.0 (适用于 SOAP 1.2), 1.2 (适用于 SOAP 1.1)或 1.1 (也适用于 SOAP 1.1)。还可以将它添加到 SOAP 客户机的流量对象输出中,以验证 SOAP 消息的一致性。 此工具需要验证许可证。
本章包含:
了解 WS-I
此工具检查 WSDL 是否符合以下要求:
- WS-I 基本概要 2.0 互操作性规范(2010)适用于 SOAP 1.2。此概要文件来自基本概要文件 1.1 和 SSBP 1.0。
- 2010 WS-I 基本概要 1.2 互操作性规范(2010)适用于 SOAP 1.1。此概要文件来自基本概要文件 1.1 和 SSBP 1.0。
- WS-I 基本概要 1.1 互操作性规范(2006)适用于 SOAP 1.1。此概要文件来自基本概要文件 1.0。SSBP(Simple SOAP Binding Protocol)1.0 派生自 Basic Profile 1.0 中与信封序列化及其在消息中的表示相关的部分。
验证与 WS-I 的一致性对于确保服务的互操作性特别有用。通过将服务开发限制为基本概要文件中指定的技术,你可以增加服务与其他系统互操作的可能性。在不一致的情况下,你可以精确地确定需要更改什么以确保互操作性。
该工具解析 WSDL,将其传递给测试工具,并生成 WS-I 一致性报告,该报告可以在 web 浏览器、SOAtest 或 Virtualize 内部编辑器中查看。除了分析 WSDLs 之外,它还可以分析 SOAP 消息并验证它们与 WS-I 断言的一致性。
分析符合 WS-I 的 SOAP 消息
WS-I 工具还可以添加到 SOAP 客户机的流量对象输出中,以验证 SOAP 消息的一致性。
自定义 WS-I
可以为所有配置自定义以下选项:
- WSDL: 指定要检查的 WSDL。
- Profile: 指定要检查符合哪些基本概要文件。
当该工具链接到 SOAP 客户机的流量对象输出时,还可以自定义以下选项:
- Suppress request assertion failures: 当启用(默认)时,将忽略 SOAP 请求的任何基本概要违规。
检查 WS-I Basic Profile 1.1 + SSBP 1.0 时,可以自定义以下选项:
- -wsdlElement: 这个 wsdlElement 字段(parent, name, namespace, type)在 wsdlURI 字段中输入有效 WSDL 并按住键盘上的 Enter 后自动填充。
- assertionResults: 指定应出现在一致性报告中的断言结果的类型。 assertionResults 下拉菜单中的有效选项如下所示:
- all: 列出所有测试断言的结果。
- notPassed: 列出除结果为
passed
的其他所有断言测试结果。 - onlyFailed: 只列出结果为
failed
的测试断言结果。
- failureMessage: 指定一致性报告中是否包含每个测试断言的预定义 Basic Profile 1.1 错误消息。如果未选中此框,则在一致性报告中不会显示预定义的错误消息。如果选中此框,则在一致性报告中将显示预定义的错误消息。
- failureDetail: 指定一致性报告中是否包含特定于 WSDL 或 SOAP 构件的错误详细信息。如果未选中此框,则错误详细信息将不会显示在一致性报告中。如果选中此框,则错误详细信息将显示在一致性报告中。
一致性报告输出
WS-I 工具生成一个输出文件,其中包含与你输入的 WSDL 对应的 Web 服务的一致性报告。此一致性报告显示了已处理断言的测试结果。此外,一致性报告显示了所处理的每个测试断言的一致性级别,并可以列出所遇到的任何错误的详细信息。报告还包含测试断言结果的摘要,这些结果表明 Web 服务是否通过了一致性测试。
定制了 WS-I 工具之后,可以链接编辑或浏览工具来显示 WS-I 一致性报告的输出。要做到这一点,请完成以下步骤:
- 右键单击 WS-I 测试节点,然后从快捷菜单选择 Add Output 。将显示添加输出对话框。从左窗格选择 Conformance Report ,右窗格选择 Browse ,然后单击 Finish。运行 WS-I 测试之后,浏览器窗口将打开并显示 WS-I 概要文件一致性报告。
- 右键单击 WS-I 测试节点,然后从快捷菜单选择 Add Output 。将显示添加输出对话框。从左窗格选择 Conformance Report ,右窗格选择 Edit ,然后单击 Finish。运行 WS-I 测试之后,WS-I 概要文件一致性报告将显示在右边 GUI 面板中。
有关 WS-I 工具规范的更多信息,或关于 WS-I 一致性报告的更多信息,请参见 http://www.ws-i.org。