配置 WSDL 绑定
另请参见
您可以使用 WSDL 编辑器来创建绑定。此外,还可以修改“新建 WSDL 文档”向导生成的绑定。
在 WSDL 文件中,绑定为端口类型定义消息格式和协议详细信息。
您可以绑定一个遵循 SOAP 1.1 协议的绑定。该绑定包含一个 SOAP 绑定节点以及一个或多个操作。每个操作可以包含以下元素:
- soap:body 元素,它提供 SOAP 正文元素的信息。
- soap:header 和 soap:headerfault 元素,它们提供 SOAP 头标元素的信息。
- soap:fault 元素,它提供 SOAP 错误详细信息元素的信息。
如果更改了绑定的名称,WSDL 编辑器则会重命名同一文件中的所有实例。如果要重命名关联 XSD、WSDL 和 BPEL 文件中的所有实例,请右键单击绑定节点,然后选择“重构”>“重命名”。
您可以通过现有的端口类型来快速创建绑定和服务。如果要在以后修改绑定,请参见创建绑定中的相应步骤。
通过端口类型创建绑定和服务:
- 在 "WSDL" 视图中,右键单击端口类型节点,然后选择“添加”>“绑定和服务端口”。
将显示“生成绑定和服务端口”对话框。
- 提供绑定的名称。
- 本发行版本中支持的唯一绑定类型为 SOAP 协议。
- 绑定子类型选项指示如何将绑定转换为 SOAP 消息。如果消息部件和绑定子类型的设置不符合 WS-I 基本配置文件,则会显示一条错误消息。
- 提供服务的名称。
- 提供端口的名称。
- 单击“确定”。
将显示一个绑定节点和一个服务节点。绑定节点包含一个 SOAP 绑定节点以及一个或多个操作。服务节点包含一个端口节点。
- 端口的 SOAP 地址节点包含一个“位置”属性,它用于指定端口地址。向导将为该“位置”属性生成伪值。请确保将伪值替换为有效值。
创建绑定
除了通过现有的端口类型快速创建绑定和服务之外,您还可以单独创建绑定、服务及其子节点。本部分将介绍如何创建绑定,以及随后如何配置 SOAP 信息。
- “生成绑定和服务端口”对话框中的“绑定子类型”选项是本部分中介绍的“样式”和 "use" 属性的组合。
创建绑定:
- 在 "WSDL" 视图中,右键单击“绑定”节点,然后选择“添加绑定”。
将显示一个绑定节点。
- 如果未显示“属性”窗口,请选择“窗口”>“属性”。
- 选择该绑定节点。
- (可选)将“名称”属性设置为新名称。
- 将“类型”属性设置为绑定将引用的端口类型。
- 右键单击该绑定节点,然后选择“添加”>“绑定操作”。
- 如果绑定的端口类型包含多个操作,则会显示“选择操作”对话框。选择一个或多个操作,然后单击“确定”。将显示一个或多个操作节点。
添加 SOAP 绑定节点:
- 在 "WSDL" 视图中,右键单击绑定节点,然后选择“添加”>“SOAP 绑定”。
将显示一个 SOAP 绑定节点。
- 如果未显示“属性”窗口,请选择“窗口”>“属性”。
- 选择该 SOAP 绑定节点。
- “样式”属性指示如何将绑定转换为 SOAP 消息。请将其值设置为 document 或 rpc。
为操作配置 SOAP 元素:
- 在 "WSDL" 视图中,右键单击操作节点,然后选择“添加”>“SOAP 操作”。
将显示一个 SOAP 操作节点。此节点包含操作的总体信息。
- 如果未显示“属性”窗口,请选择“窗口”>“属性”。
- 选择该 SOAP 操作节点。
- "soapAction" 属性指定操作的 SOAPAction 头标的值。
- “样式”属性指示如何将绑定转换为 SOAP 消息。请将其值设置为 document 或 rpc。
- 根据方案的不同,在输入、输出以及错误节点中添加元素。
- 输入节点可以添加以下元素:soap:body 和 soap:header。
- 输出节点可以添加以下元素:soap:body 和 soap:header。
- 错误节点可以添加以下元素:soap:fault。
- 要添加 soap:headerfault 元素,请右键单击 soap:header 节点,然后选择“添加 headerfault”。
- 如果添加了 soap:body 元素,则可以设置以下属性。
- "parts" 属性指示出现在 SOAP 正文元素中某个位置的消息部件。
- "encodingStyle" 属性可以设置为表示消息中使用的编码的 URI 列表。
- "use" 属性指示如何将绑定转换为 SOAP 消息。请将其值设置为 literal 或 encoded。
- "namespace" 属性为使用 encoded 的方案提供信息。
- 如果添加了 soap:header 元素,则可以设置以下属性。"message" 和 "part" 属性是必需的。
- "message" 和 "part" 属性引用定义头标类型的消息部件。
- "use" 属性指示如何将绑定转换为 SOAP 消息。请将其值设置为 literal 或 encoded。
- "encodingStyle" 属性可以设置为表示消息中使用的编码的 URI 列表。
- "namespace" 属性为使用 encoded 的方案提供信息。
- 如果添加了 soap:headerfault 元素,则可以设置以下属性。"message" 和 "part" 属性是必需的。
- "message" 和 "part" 属性引用定义头标类型的消息部件。
- "use" 属性指示如何将绑定转换为 SOAP 消息。请将其值设置为 literal 或 encoded。
- "encodingStyle" 属性可以设置为表示消息中使用的编码的 URI 列表。
- "namespace" 属性为使用 encoded 的方案提供信息。
- 如果添加了 soap:fault 元素,则可以设置以下属性。
- "encodingStyle" 属性可以设置为表示消息中使用的编码的 URI 列表。
- "use" 属性指示如何将绑定转换为 SOAP 消息。请将其值设置为 literal 或 encoded。
- "namespace" 属性为使用 encoded 的方案提供信息。
删除绑定
您可以从 WSDL 文件中删除绑定。
删除绑定:
- 在 "WSDL" 视图中,右键单击绑定节点,然后选择“删除”。
- 另请参见
- 配置 WSDL 文件组件
法律声明