网站的更新与维护,苏州网师园,做时时网站要多少钱,百度怎么直接访问网址文章目录 第十六章 创建Web客户端 - 修改生成的客户端类修改生成的客户端类调整生成的类以处理极长的字符串 第十六章 创建Web客户端 - 修改生成的客户端类
修改生成的客户端类
生成 Web 客户端类后#xff0c;通常不需要编辑该类。相反#xff0c;可以编写代码来创建 Web … 文章目录 第十六章 创建Web客户端 - 修改生成的客户端类修改生成的客户端类调整生成的类以处理极长的字符串 第十六章 创建Web客户端 - 修改生成的客户端类
修改生成的客户端类
生成 Web 客户端类后通常不需要编辑该类。相反可以编写代码来创建 Web 客户端的实例并提供客户端错误处理。本节记录了修改生成的客户端类时的值得注意的例外情况。
注意不要创建生成的 Web 客户端类的子类。编译器不会生成正常运行所需的支持类并且子类将无法使用。
调整生成的类以处理极长的字符串
在极少数情况下可能需要编辑生成的客户端类以适应极长的字符串或二进制值长度超过字符串长度限制的值。
当 SOAP 向导读取 WSDL 时它假定任何字符串类型的输入或输出都可以在 IRIS 中表示为 %String但这并不总是正确的。在极少数情况下字符串可能会超出字符串长度限制。同样向导假定任何 XML 类型为 base64Binary 的输入或输出都可以在 IRIS 中表示为 %xsd.base64Binary)但这并不总是正确的因为存在相同的字符串长度限制。在这两种情况下WSDL 都不包含任何信息来表明此输入或输出可能超出字符串长度限制。
当 Web 客户端遇到太长的字符串或二进制值时它会引发以下错误之一
MAXSTRING错误数据类型验证错误
ERROR #6232: Datatype validation failed for tag your_method_name ...当然此错误也可能是由数据类型不匹配引起的。
不过该问题很容易纠正调整生成的 Web 客户端类特别是从 %SOAP.WebClient 继承的类中的方法签名以使用适当的流类
使用 %GlobalCharacterStream 而不是 %String。使用 %GlobalBinaryStream 而不是 %xsd.base64Binary。
例如考虑一个 Web 服务 (MyGiantStringService)它有一个方法 (WriteIt)该方法不接受任何参数并返回一个非常长的字符串。如果使用 SOAP 向导生成 Web 客户端类则 Web 客户端类最初看起来如下所示
Class GetGiantString.MyServiceSoap Extends %SOAP.WebClient
{Method WriteIt() As %String
[Final,SoapBindingStyledocument,SoapBodyUseliteral,WebMethod]
{Quit ..WebMethod(WriteIt).Invoke($this,https://tempuri.org/MyApp.MyGiantStringService.WriteIt)
}}在这种情况下只需进行一项调整。更改 WriteIt 的返回类型如下
Method WriteIt() As %GlobalCharacterStream
[Final,SoapBindingStyledocument,SoapBodyUseliteral,WebMethod]
{Quit ..WebMethod(WriteIt).Invoke($this,https://tempuri.org/MyApp.MyGiantStringService.WriteIt)
}当编译这个类时系统会根据需要自动重新生成关联的类。
可能还需要调整任何生成的类型类中的属性类型。例如假设 Web 服务使用名为 Container 的元素其中包括字符串类型的元素 ContainerPart。当生成 Web 客户端类时系统会创建一个具有 %String 类型的 ContainerPart 属性的 Container 类。如果 Web 服务发送的字符串超过 ContainerPart 元素中的字符串长度限制 Web 客户端将引发错误。要避免此错误请将 ContainerPart 属性的类型更改为 %GlobalCharacterStream。
