SOAP 客户端工具向 SOAP 服务器发送消息。 要使用 SOAP 客户端工具发送消息,您需要指定消息以及如何通过在工具的配置面板中设置参数来进行发送。
有关如何配置 SOAP 客户端工具的不同选项的信息可以在以下小节中找到:
WSDL 选项
在 WSDL 选项卡中指定选项允许使用让您更易指定请求消息的项填充请求选项卡。可以配置以下 WSDL 设置:
WSDL 选项卡允许您指定以下 WSDL 设置:
- 资源模式:指定 WSDL URI 或 Schema URL 模式。
- WSDL URI:描述可以访问该 Web 服务的 WSDL URI。可以输入值或点击浏览按钮。如果没有 WSDL,则可以将该字段保留为空。
- Schema URL:描述可以访问此 Web 服务的 Schema URL。可以输入值或点击浏览按钮。如果没有 Schema,则可以将该字段保留为空。
- 限定到 WSDL:(如果选择 Schema 资源模式,则约束到 Schema)确定消息工具的某些参数是否从 WSDL(或 Schema)获取值,而不是从手动输入获取值。 如果启用该选项,则禁用掉某些参数(例如,路由器端点、SOAP 操作、SOAP Body 和 Header 参数)并从 WSDL 中获取它们的值。如果禁用该选项,则刷新 WSDL(刷新 Schema)按钮也将被禁用。
- WSDL 文档:(如果可用,自动完成):描述给定 WSDL URI 上的 Web 服务。
请求选项
请求选项卡允许您配置要发送的工具的请求。
在 SOAP 客户端工具的请求选项卡中,您可以从视图下拉列表中选择输入模式。SOAP 客户端工具与消息传送客户端工具和消息桩工具共享这些选项。有关这些共享选项的更多信息,请参阅视图/输入模式概述。
传输选项
传输选项允许确定客户端是否使用 HTTP 1.0、HTTP 1.1、JMS, SonicMQ、WebSphere MQ、RMI、SMTP、TIBCO、.NET WCF HTTP 或 .NET WCF TCP 协议来发送请求。若要配置每个协议的属性,请从 SOAP 客户端工具的传输选项卡中的传输下拉列表中选择合适的协议。
跨工具复制和粘贴传输设置
可以将传输设置从一个工具复制到另一个工具。
- 选择要复制的左窗格设置类别。
- 右键点击所选内容,然后选择复制。
- 打开目标工具的相同界面。
- 右键点击配置面板,然后选择粘贴。
客户端工具的内部传输
通过使用 localhost、127.0.0.1
或特殊主机名 host.virt.internal
链入响应器的客户端可将消息路由到本地服务器的虚拟资产中,而无需消耗 HTTP 连接。使用 localhost 或 127.0.0.1
时,指定的端口必须与 Virtualize 部署的端口一致;使用 host.virt.internal
时,则不使用该端口。例如,部署在 http://localhost:9080/myVirtualAsset 上的虚拟资产也可以通过一个使用 http://host.virt.internal/myVirtualAsset 的链式客户端访问。
附件选项
附件选项卡允许您在不使用脚本的情况下发送二进制或 XML 附件。若要发送附件,请执行附件选项卡中的以下操作:
- 点击添加按钮。将在附件表中显示一个 XML 附件条目。
- 双击 XML 附件条目。将显示一个编辑附件对话框。
- 在编辑附件对话框中,从模式下拉菜单中选择 XML 或二进制。
- 配置附件:
- XML 模式有以下选项:
- 视图:从下拉菜单中选择所需视图并相应地进行配置。选项有字面量 XML、表单 XML、脚本化 XML 和表单输入。
- 二进制模式有以下选项:
- Base 64 编码:启用 Base 64 编码,对二进制值进行编码。
- 数据源列:选择发送来自数据源列的值。
- 文件:选择发送来自文件的值。通过点击浏览按钮选择所需的文件。如果要将该文件的路径作为当前配置文件的相对路径来保存,则选择保留为相对路径选项。
- 文本:选择发送文本值。
- 内容类型:指定内容类型。如果想对附件头信息进行添加/更改或删除操作,请点击编辑消息头按钮。
- XML 模式有以下选项:
WS-Policy 选项
WS-Policy 选项卡用于跟踪工具使用的 web 服务策略。它还允许您在策略之间切换,并根据该策略更新附加的工具。
更新 WS-Policy
- 启用约束到 WSDL 种定义的策略选项,启用用于更新策略配置的控件。
- 点击端点、操作或消息选项卡,并从 WSDL 中附加新策略。结果将是为每个主题选择的所有备选方案的并集。
- 点击更新策略配置,删除当前策略配置并添加新选择的策略配置。
混合选项
以下选项可以在 SOAP 客户端工具的混合选项卡中使用:
- 注意:在此字段中附加有关使用 SOAP 客户端的目的的其他信息。
- 有效的 HTTP 响应码:有效 HTTP 响应代码的常规范围是 200-299。可以从下拉菜单中选择固定值,然后输入指定响应码、代码范围或逗号分隔的代码列表,这些代码表示有效的 HTTP 响应,例如
302
或500-599
。还可以从下拉菜单中选择脚本化,该脚本以编程方式指定有效的 HTTP 响应代码。 超时 (秒):指定 FTP、telnet 或 HTTP 请求超时后的延迟长度(以秒为单位)。默认设置对应首选项面板的超时设置。定制设置允许输入超时时间。可以输入一个负超时值,表示指定无限的超时。
- 因超时测试失败:选择此选项可使工具在超时后失败。
- 只在发生超时时才通过测试:如果发生指定的超时(如,工具没有在指定的时间内完成执行),则选择此选项让工具通过。
附件封装格式:指定是否使用默认或定制封装格式。默认选项指定在系统首选项的 Misc 选项卡中选择的附件封装格式(更多信息,请参阅 SOAP 设置)。自定义选项允许选择 MIME、DIME、MTOMAlways或 MTOM Optional。更多详情,请参阅使用附件。
- SOAP 版本:从下拉菜单中选择自定义,然后选择 SOAP 1.1 或 SOAP 1.2。默认值为 SOAP 1.1。
- 传出消息编码:可选择传出消息的编码。可以从首选项面板中选择任意字符编码来读写文件,但是传出消息编码提供了其他灵活性,因此从全局设置中为 SOAP 请求设置不同的字符集编码。
- 类型/使用:(如果在 WSDL 选项卡中选择了约束请求到 WSDL 复选框,则禁用选项)这些选项允许您选择 SOAP 消息的 Body 格式和编码:
- Body 格式:选择 document 或 rpc。
- 使用:选择 encoded 或 literal。
- 编码格式 URI:(如果可用,自动完成)列出用来发送请求的编码格式 URI。
- 目标对象 URI:指定目标对象 URI。