文章目录
- [第十四章 创建Web客户端 - XML 命名空间的 SOAP 向导选项](#第十四章 创建Web客户端 - XML 命名空间的 SOAP 向导选项)
- [`XML` 命名空间的 `SOAP` 向导选项](#
XML
命名空间的SOAP
向导选项) -
- [添加 `NAMESPACE` 类参数](#添加
NAMESPACE
类参数) - [对文档样式 `Web` 方法使用未包装的消息格式](#对文档样式
Web
方法使用未包装的消息格式) - 不创建数组属性
- [为可为 `null` 的元素生成 `XMLNIL` 属性参数](#为可为
null
的元素生成XMLNIL
属性参数) - [为可为 `nillable` 元素生成 `XMLNILNOOBJECT` 属性参数](#为可为
nillable
元素生成XMLNILNOOBJECT
属性参数) - [将 `XMLSEQUENCE` 参数设置为 `0`](#将
XMLSEQUENCE
参数设置为0
) - [生成设置为 `1` 的 `XMLIGNORENULL` 参数](#生成设置为
1
的XMLIGNORENULL
参数) - 使用二进制流
- [指定 `SECURITYIN` 类参数](#指定
SECURITYIN
类参数)
- [添加 `NAMESPACE` 类参数](#添加
第十四章 创建Web客户端 - XML 命名空间的 SOAP 向导选项
XML
命名空间的 SOAP
向导选项
SOAP
向导的第 3
步屏幕包括以下选项,使能够配置从 WSDL
生成的类包:
添加 NAMESPACE
类参数
指示生成的类型类是否将包含等于 Web
服务的命名空间的 NAMESPACE
类参数集。
- 如果
WSDL
显式指示给定类型所属的命名空间,则"添加命名空间类参数"会被选中并呈灰色显示。在这种情况下,生成的类型类包括等于该命名空间的NAMESPACE
类参数集。 - 如果
WSDL
没有指明给定类型的命名空间,可以选择或清除添加NAMESPACE
类参数。
对文档样式 Web
方法使用未包装的消息格式
指示是否对生成的 Web
客户端中的方法使用未包装的消息格式。此选项仅影响 SoapBindingStyle
等于"document
"的方法。
如果 WSDL
满足以下任一陈述,请选中此复选框:
<message>
元素包含多个部分。- 响应消息使用的类型属于多个命名空间。
或者,向导会失败并显示如下错误消息:
java
ERROR #6425: Element 'wsdl:binding:operation:msg:input' - message 'AddSoapOut'
Message Style must be used for document style message with 2 or more parts.
不创建数组属性
指示向导是否生成数组属性。
为可为 null
的元素生成 XMLNIL
属性参数
指示向导是否为生成的类中的适用属性指定 XMLNIL
属性参数。
此选项适用于与用 nillable="true"
指定的 XML
元素相对应的每个属性。如果选择此选项,向导会将 XMLNIL=1
添加到属性定义中。否则不添加该参数。
为可为 nillable
元素生成 XMLNILNOOBJECT
属性参数
指示向导是否为生成的类中的适用属性指定 XMLNILNOOBJECT
属性参数。
此选项适用于与使用 nillable="true"
指定的 XML
元素相对应的每个属性。如果选择此选项,向导会将 XMLNILNOOBJECT=1
添加到属性定义中。否则,向导不会添加此参数。
将 XMLSEQUENCE
参数设置为 0
指示向导是否将生成的类中的 XMLSEQUENCE
类参数设置为 0
。
默认情况下,向导在生成的类中将此参数设置为 1
,这可确保这些类遵循 WSDL
架构中给定的元素顺序。当架构在给定父级中具有多个同名元素时,此值非常有用。
生成设置为 1
的 XMLIGNORENULL
参数
指示向导是否在生成的类中指定 XMLIGNORENULL
类参数。
如果选择此选项,向导会将 XMLIGNORENULL=1
添加到类定义中,包括生成的 Web
客户端(或 Web
服务)。否则不添加该参数。
使用二进制流
指示向导是否为每个 xsd:base64Binary
类型的元素生成一个 %Stream.GlobalBinary
类型的属性。
如果选择此选项,则生成的属性的类型为 %Stream.GlobalBinary
。或者,属性的类型为 %xsd.base64Binary
。
该向导会忽略 xsd:base64Binary
类型的任何属性。
指定 SECURITYIN
类参数
指定生成的客户端类中 SECURITYIN
类参数的值。
如果使用 Web
服务安全性,请使用 REQUIRE
或 ALLOW
,具体取决于希望客户端需要这些元素还是只是验证它们。否则,IGNORE
或 IGNOREALL
通常是合适的。
如果关联(和编译的)配置类中存在安全策略,则忽略 SECURITYIN
参数。