本文主要是介绍第十八章 创建Web客户端 - 调整Web客户端实例的属性,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
文章目录
- 第十八章 创建Web客户端 - 调整Web客户端实例的属性
- 调整Web客户端实例的属性
- 更改 `Web` 客户端的端点
- 配置客户端以使用 `SSL`
- 指定 SOAP 版本
- 其他调整
- 使用 `HTTP` 响应
第十八章 创建Web客户端 - 调整Web客户端实例的属性
调整Web客户端实例的属性
当使用 Web
客户端类的实例时,可以指定该实例的属性来控制其行为。本节讨论最常设置的属性及其默认值。
更改 Web
客户端的端点
SOAP
向导通过设置 Web
客户端的 LOCATION
参数自动设置 Web
客户端的端点。默认情况下,它将此参数设置为与其通信的 Web
服务的 URL
。
要覆盖此设置,请设置 Web
客户端实例的 Location
属性。如果 Location
为 null
,则使用 LOCATION
参数。
常见用法是将 Location
属性设置为使用不同的端口,以启用跟踪。例如,假设在生成的 Web
客户端类中,端点定义如下:
Parameter LOCATION = "https://devsys:52773/csp/mysamples/GSOP.AddComplexWS.cls";
当使用此客户端时,可以包含以下行:
Set client.Location="https://devsys:8080/mysamples/mysamples/GSOP.AddComplexWS.cls"
注意:如果 WSDL
未指定 Web
服务的位置,则 SOAP
向导不会指定 Web
客户端的 LOCATION
参数。这是一种罕见的情况。在这种情况下,可以编辑 Web
客户端类以包含 LOCATION
参数,也可以指定 Web
客户端实例的 Location
属性,如下所示。
配置客户端以使用 SSL
如果 Web
客户端的端点具有 HTTPS
协议,则必须将 Web
客户端配置为使用 SSL
。具体来说:
- 如果尚未执行此操作,请使用管理门户创建
SSL/TLS
配置,其中包含所需SSL
连接的详细信息。有关信息,请参阅TLS
指南中的关于配置。 - 将
Web
客户端的SSLConfiguration
属性设置为等于该SSL/TLS
配置名称。
请注意,如果客户端通过代理服务器进行连接,则还必须在 Web
客户端中将 HttpProxySSLConnect
属性设置为 1
。
指定 SOAP 版本
SOAP
向导根据 Web
服务 WSDL
中的 SOAP
版本自动指定要在请求消息中使用的 SOAP
版本。具体来说,它设置 SOAPVERSION
参数。
要覆盖此设置,请设置 Web 客户端实例的 SoapVersion
属性。使用以下值之一:
- “” — The client sends
SOAP 1.1 messages
. - “
1.1
” — 客户端发送SOAP 1.1
消息。 - “
1.2
” — 客户端发送SOAP 1.2
消息。
如果 SoapVersion
为空,则使用 SOAPVERSION
参数。
其他调整
可能需要设置 Web
客户端实例的其他属性才能进行其他更改。
使用 HTTP
响应
默认情况下,当调用 Web
客户端方法时,是通过 HTTP
执行的。然后,HTTP
响应可作为 Web
客户端实例的 HttpResponse
属性使用。此属性是 %Net.HttpResponse
的实例,该选项卡又具有如下属性:
headers
包含HTTP
响应的标头。Data
是 多维数组,包含HTTP
响应中的所有数据。StatusCode
、StatusLine
和ReasonPhrase
提供状态信息。
这篇关于第十八章 创建Web客户端 - 调整Web客户端实例的属性的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!