WS-Addressing 的必需消息寻址属性

WS-Addressing 1.0 元数据规范声明哪些消息寻址属性 (MAP) 必须包含在 WSDL 1.1 和 WSDL 2.0 文档中。 WS-Addressing 的 CICS® 实现可帮助您通过自动提供这些必需 MAP 的值来符合 WS-Addressing 规范。

有关 WS-Addressing MAP 的简介，请参阅 Web Service 寻址概述。

您可以在提供的 WSDL 中为 MAP 指定自己的值，并且可以使用 CICS WS-Addressing API 命令在寻址上下文中更新这些值。 如果未提供必需 MAP 的值，那么 CICS 将为您生成值。

下表列出了对于具有 WSDL 1.1 和 WSDL 2.0:

表 1. WS-Addressing 的必需消息寻址属性。
WS-Addressing MAP 名称 描述 在 WSDL 1.1 中必需 在 WSDL 2.0 中必需
<wsa:To> 消息的预期接收方的地址。 False False
<wsa:操作> WS-Addressing 操作: 输入，输出或故障。 对于以下 MEP 是必需的:
  • 单向
  • 双向 (请求)
  • 双向 (响应)
 对于以下 MEP 是必需的:
  • 仅入
  • 仅健壮的 In-In (In)
  • 仅功能强大 (故障)
  • 入出 (In)
  • 出入 (Out)
  • 入选可退出（入）
  • In-optional-out (输出)
<wsa:From> 消息源自的端点。 False False
这种方法 值 不 必需
<wsa:ReplyTo> 用于应答消息的预期接收方的端点。 False False
<wsa:FaultTo> 与消息相关的故障的预期接收方的端点。 False False
<wsa:MessageID> 唯一消息标识。 对于以下 MEP 是必需的:
  • 双向 (请求)
 对于以下 MEP 是必需的:
  • 仅健壮的 In-In (In)
  • 入出 (In)
  • 入选可退出（入）
<wsa:RelatesTo> 用来指示此消息如何与另一条消息相关的一对值。 该元素包括相关消息的 <wsa:MessageID> 和一个表达关系类型的可选属性。 对于以下 MEP 是必需的:
  • 双向 (响应)
 对于以下 MEP 是必需的:
  • 仅功能强大 (故障)
  • 出入 (Out)
  • In-optional-out (输出)

有关更多信息，请参阅 W3C WS-Addressing 1.0 元数据 规范: http://www.w3.org/TR/ws-addr-metadata/。

注：
  • 如果没有为 <wsa:ReplyTo> MAP 的地址元素设置值，地址将被设置为匿名 URI：http://www.w3.org/2005/08/addressing/anonymous。 匿名 URI 指示将响应发送回请求者。
  • 如果没有为 <wsa:FaultTo> MAP 的地址元素指定值，CICS 会将此地址设置为与 <wsa:ReplyTo> MAP 的地址元素相同的值。

    请注意，如果请求者构建的 MAP 不正确并导致验证失败，CICS 会将故障消息发送回请求者，而不是 <wsa:FaultTo> MAP 指定的地址。

  • 如果未指定<wsa:To> MAP的值， CICS 将地址设置为匿名URI： http://www.w3.org/2005/08/addressing/anonymous。 匿名 URI 表示请求将发送到 DFHWS-URI 容器中指定的地址；更多信息，请参阅 DFHWS-URI 容器。
  • 您可以在WSDL文档中显式定义<wsa:Action> MAPs，也可以让 CICS 自动生成它们。
  • CICS 会在运行时自动为期望响应的请求消息和响应消息的 <wsa:MessageID> MAP 设置唯一值。
  • <wsa:RelatesTo> MAP 是响应信息的必填项。 消息的关系类型是可选的，缺省为 http://www.w3.org/2005/08/addressing/reply。