第四十二章 使用 二进制 SOAP 格式 - 重新定义 Web 客户端以使用二进制 SOAP

重新定义 Web 客户端以使用二进制

可以重新定义现有的 Web 客户端，使其使用 二进制 SOAP 格式。为此，请将 Web 客户端的 SOAPBINARY 参数或 SoapBinary 属性设置为 1。可能需要进行其他更改；请参阅生成的 WSDL详细信息中的 IRIS 二进制 SOAP 格式的 WSDL 差异。

指定字符集

Web 客户端的 SoapBinaryCharset 属性指定 Web 服务的 字符集（例如：Unicode、Latin1）。如果客户端计算机和服务计算机的字符集相同，则字符串以 RAW 格式发送；否则，以 UTF8 编码格式发送。

SoapBinaryCharset 属性默认为 SOAPBINARYCHARSET 参数，该参数默认为 null，始终将字符串转换为 UTF8。

IRIS 二进制 SOAP 格式的详细信息

二进制 SOAP 的 API 与 XML SOAP 有以下不同：

• 对于 IRIS 服务器：

  • 二进制 SOAP 由 ISCSoap HTTP 标头的存在表示。
  • 没有调用 Web 服务的 Initialize() 方法。
  • 初始实现中使用了正常的 %request.Content 流。
  • 登录是通过附加到 URL 的 IRISUsername 和 IRISPassword 查询参数进行的。二进制 SOAP 不会返回任何登录页面。
  • 如果发生无效登录，则会在返回 %SOAP.Fault 的实例。

• 对于 %Net.HttpRequest响应：

  • 通过设置所调用方法的 Web 客户端类的 SoapBinary 属性来指示二进制 SOAP 请求。
  • 该请求是使用普通 EntityBody 流发送的。
  • 响应在 HttpResponse 的 Data 属性中返回。