Red Hat Training

A Red Hat training course is available for Red Hat Fuse

12.6. 在拒绝模式中使用 HTTP 传输

概述

在普通的 HTTP 请求/响应情况下,将使用相同的 HTTP 连接发送请求和响应。服务提供商处理请求,并通过包含相应 HTTP 状态代码和响应内容的响应。如果请求成功,HTTP 状态代码被设置为 200。

在一些实例中,比如使用 WS-RM,或者当请求执行时会延长时间执行时,最好分离请求和响应消息。在这种情况下,服务提供商通过收到请求的 HTTP 连接后端将消费者发送 202 Accepted 响应到消费者。然后,它会使用新的分离的服务器→client HTTP 连接处理请求,并将响应发回到消费者。使用者运行时收到传入请求,并将其与适当的请求相关联,然后再返回到应用代码。

配置分离的交互

以分离模式使用 HTTP 传输需要进行以下操作:

  1. 将使用者配置为使用 WS-Addressing。

    请参阅 “配置端点以使用 WS-Addressing”一节

  2. 将使用者配置为使用分离的端点。

    请参阅 “配置使用者”一节

  3. 配置消费者与 交互的任何服务提供商,以使用 WS-Addressing。

    请参阅 “配置端点以使用 WS-Addressing”一节

配置端点以使用 WS-Addressing

指定消费者以及使用 WS-Addressing 的任何服务提供商。

您可以通过以下两种方式之一指定端点使用 WS-Addressing:

  • wswa:UsingAddressing 元素添加到端点的 WSDL 端口 元素中,如 例 12.18 “使用 WSDL 激活 WS-Address” 所示。

    例 12.18. 使用 WSDL 激活 WS-Address

    ...
    <service name="WidgetSOAPService">
      <port name="WidgetSOAPPort" binding="tns:WidgetSOAPBinding">
        <soap:address="http://widgetvendor.net/widgetSeller" />
        <wswa:UsingAddressing xmlns:wswa="http://www.w3.org/2005/02/addressing/wsdl"/>
      </port>
    </service>
    ...
  • 将 WS-Addressing 策略添加到端点的 WSDL 端口 元素中,如 例 12.19 “使用策略激活 WS-Addressing” 所示。

    例 12.19. 使用策略激活 WS-Addressing

    ...
    <service name="WidgetSOAPService">
      <port name="WidgetSOAPPort" binding="tns:WidgetSOAPBinding">
        <soap:address="http://widgetvendor.net/widgetSeller" />
        <wsp:Policy xmlns:wsp="http://www.w3.org/2006/07/ws-policy"> <wsam:Addressing xmlns:wsam="http://www.w3.org/2007/02/addressing/metadata"> <wsp:Policy/> </wsam:Addressing> </wsp:Policy>
      </port>
    </service>
    ...
注意

WS-Addressing 策略取代 wswa:UsingAddressing WSDL 元素。

配置使用者

使用 http-conf:conduit 元素的 DecoupledEndpoint 属性将消费者端点配置为使用分离的端点。

例 12.20 “将消费者配置为使用 Decoupled HTTP 端点” 显示设置 例 12.18 “使用 WSDL 激活 WS-Address” 中定义的端点的配置,以使用分离的端点。现在,消费者在 http://widgetvendor.net/widgetSellerInbox 接收所有响应。

例 12.20. 将消费者配置为使用 Decoupled HTTP 端点

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:http="http://cxf.apache.org/transports/http/configuration"
       xsi:schemaLocation="http://cxf.apache.org/transports/http/configuration
                             http://cxf.apache.org/schemas/configuration/http-conf.xsd
                           http://www.springframework.org/schema/beans
                             http://www.springframework.org/schema/beans/spring-beans.xsd">

  <http:conduit name="{http://widgetvendor.net/services}WidgetSOAPPort.http-conduit">
    <http:client DecoupledEndpoint="http://widgetvendor.net:9999/decoupled_endpoint" />
  </http:conduit>
</beans>

如何处理消息

在分离模式中使用 HTTP 传输会增加处理 HTTP 消息的复杂层。虽然在应用中的实施级别代码增加了复杂性是透明的,但了解调试原因的原因可能很重要。

图 12.1 “中用于已拒绝的 HTTP 传输的消息流” 显示在分离模式中使用 HTTP 时的消息流。

图 12.1. 中用于已拒绝的 HTTP 传输的消息流

分离的消息交换有十五步。

请求会启动以下过程:

  1. 使用者实施调用操作,并且生成请求消息。
  2. WS-Addressing 层将 WS-A 标头添加到消息。

    当在消费者配置中指定分离端点时,分离的端点的地址将放入 WS-A ReplyTo 标头中。

  3. 消息发送到服务提供程序。
  4. 服务提供商接收消息。
  5. 来自消费者的请求消息被分配到供应商的 WS-A 层。
  6. 因为 WS-A ReplyTo 标头没有设置为 anonymous,因此该提供程序将 HTTP 状态代码发回为 202,确认已收到该请求。
  7. HTTP 层使用原始连接的 back-channel 将 202 Accepted 消息发回到使用者。
  8. 使用者接收了用于发送原始消息的 HTTP 连接的 202 Accepted reply。

    当消费者收到 202 Accepted 回复时,HTTP 连接会关闭。

  9. 该请求将传递到处理请求的服务提供商的实施。
  10. 当响应就绪时,它将被分配给 WS-A 层。
  11. WS-A 层将 WS-Addressing 标头添加到响应消息。
  12. HTTP 传输将响应发送到消费者的分离端点。
  13. 消费者的分离端点从服务提供商接收响应。
  14. 响应被分配到消费者的 WS-A 层,使用 WS-AlatesTo 标头将其与正确的请求关联。
  15. 相关响应返回给客户端实施,调用调用将被取消阻塞。