第十八章 创建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 提供状态信息。