挂机宝做网站,城乡建设局的官方网站,中国电力建设协会网站,html购物网站源码文章目录 第十二章 创建Web客户端SOAP向导的概述使用SOAP向导 第十二章 创建Web客户端
web客户端是访问web服务的软件。web客户端提供了一组代理方法#xff0c;每个方法对应于web服务的一个方法。代理方法使用与它所对应的web服务方法相同的签名#xff0c;并在被请求时调用… 文章目录 第十二章 创建Web客户端SOAP向导的概述使用SOAP向导 第十二章 创建Web客户端
web客户端是访问web服务的软件。web客户端提供了一组代理方法每个方法对应于web服务的一个方法。代理方法使用与它所对应的web服务方法相同的签名并在被请求时调用web服务方法。介绍如何在 IRIS数据平台中创建和使用web客户端。
注意:对 web服务自动生成的WSDL可能不包括SOAP报头元素的信息:
如果通过设置HeadersOut属性手动添加SOAP报头请确保遵循添加和使用自定义报头元素中指定支持的报头元素中的说明。如果这样做WSDL将包含所有适用的信息。否则它不会必须将WSDL保存到一个文件中并根据需要手动编辑它。如果通过设置SecurityOut属性(如保护Web服务中所述)来添加WS-Security头元素则WSDL不包括所有需要的信息。(这是因为WSDL是在编译时生成的而头文件是在运行时添加的。)在这种情况下将WSDL保存到文件中并根据需要手动编辑它。
由于许多原因使用WS-Policy添加WS-Security元素更简单、更容易如创建和使用策略中所述。使用WS-Policy生成的WSDL包含所有需要的信息。
在其他情况下生成的WSDL包含所有需要的信息。
注意W3C规范不要求web服务提供生成的WSDL。
SOAP向导的概述
要创建 web客户端可以使用Studio中的SOAP向导或提供的相应类方法。在任何一种情况下输入都是WSDL文档。这些工具生成一个web客户端类和所有需要的支持类。
可以为WSDL提供URL或文件路径。
注意:如果WSDL表明同时支持SOAP 1.1和SOAP 1.2那么如果需要SOAP向导将生成两组类。
使用SOAP向导
如果可以访问描述给web服务的WSDL则可以使用Studio中的SOAP向导为该服务生成web客户端。
注意:如果启用了代理服务器Studio将在与模板(如SOAP Wizard)进行通信时使用它。有关指定代理服务器和端口的信息请参见使用代理服务器。
要使用SOAP向导:
在Studio中单击工具插件 SOAP向导。在SOAP向导的第一个屏幕上指定WSDL的位置和访问它所需的SSL配置:
a. 单击URL或FILE来指示WSDL的格式。
b. 键入WSDL URL或者浏览到WSDL文件。
c. 如果指定了需要SSL认证的URL(即以https开头的URL)请执行以下操作:
在“SSL配置”下拉列表中选择SSL配置。
重要:SSL Configuration字段仅指定向导用于访问WSDL的SSL配置。
可选地清除“当建立SSL连接时服务器证书中的服务器标识是否与正在连接的系统的名称匹配”复选框。
选中该复选框后向导将确定证书服务器名称是否与用于连接到该服务器的DNS名称匹配。如果名称不匹配则不允许连接。这种默认行为可以防止中间人攻击在RFC 2818中有描述在一个新的选项卡中第3.1节。也可以在新选项卡中查看RFC 2595opened第2.4节了解更多信息。
d. 单击Next。
向导尝试访问并显示WSDL。
提示:如果向导在多次尝试后无法访问WSDL URL可以将WSDL保存为文件并浏览到它。
如果向导成功将出现步骤2屏幕。
e. 如果WSDL URL需要密码身份验证请指定凭据: 选择要使用的凭证类型: 对于凭据选择用户名和密码。对于HTTP基本身份验证凭据选择“HTTP身份验证用户名”和“密码”。 填写Username和Password字段。 单击“重试”。 向导不会保存条目。如果用户名和密码有效则出现步骤2屏幕。 在SOAP向导的第2步屏幕上指定向导如何从WSDL生成类: 配置Options中的设置以控制类生成和编译区域。单击Next。出现步骤3屏幕。 在SOAP向导的第3步屏幕上指定向导如何包装它从WSDL生成的类: 在屏幕顶部配置设置以确定向导如何从WSDL中的XML名称空间生成类包。可选地编辑类包名。点击下一步该向导生成、编译并列出类。然后出现步骤 4 屏幕。
注意如果架构中元素的名称以下划线 (_) 开头则为该元素生成的类的属性以百分号 (%) 开头。
单击“完成”。
