HTTP 出站组件

本节介绍 Spring Integration 的 HTTP 出站组件。

使用 HttpRequestExecutingMessageHandler

要配置 HttpRequestExecutingMessageHandler，编写类似如下的 Bean 定义：

<bean id="httpOutbound"
  class="org.springframework.integration.http.outbound.HttpRequestExecutingMessageHandler">
  <constructor-arg value="http://localhost:8080/example" />
  <property name="outputChannel" ref="responseChannel" />
</bean>

这个 Bean 定义通过委托给一个 RestTemplate 来运行 HTTP 请求。该模板又委托给一个 HttpMessageConverter 实例列表，以从 Message 负载生成 HTTP 请求体。您可以配置这些转换器以及要使用的 ClientHttpRequestFactory 实例，如下例所示：

<bean id="httpOutbound"
  class="org.springframework.integration.http.outbound.HttpRequestExecutingMessageHandler">
  <constructor-arg value="http://localhost:8080/example" />
  <property name="outputChannel" ref="responseChannel" />
  <property name="messageConverters" ref="messageConverterList" />
  <property name="requestFactory" ref="customRequestFactory" />
</bean>

默认情况下，HTTP 请求是使用 SimpleClientHttpRequestFactory 的一个实例生成的，该实例使用 JDK 的 HttpURLConnection。通过 CommonsClientHttpRequestFactory 也支持使用 Apache Commons HTTP Client，您可以注入它（如前所示）。

对于出站网关，网关生成的回复消息包含请求消息中存在的所有消息头。

使用 Cookies

出站网关上的 transfer-cookies 属性提供了基本的 cookie 支持。当设置为 true（默认为 false）时，从服务器响应中收到的 Set-Cookie 头部会转换为回复消息中的 Cookie。然后，此头部会用于后续的发送。这使得简单的有状态交互成为可能，例如以下情况：

…​→logonGateway→…​→doWorkGateway→…​→logoffGateway→…​

如果 transfer-cookies 为 false，收到的任何 Set-Cookie 头部将保留为回复消息中的 Set-Cookie，并在后续发送中被丢弃。

空响应体

HTTP 是一种请求-响应协议。然而，响应可能没有正文，只有头部。在这种情况下，HttpRequestExecutingMessageHandler 会生成一个回复 Message，其负载为 org.springframework.http.ResponseEntity，无论是否提供了 expected-response-type。根据 HTTP RFC 状态码定义，许多状态码要求响应不能包含消息体（例如，204 No Content）。还有一些情况是，对同一 URL 的调用可能返回或不返回响应体。例如，对某个 HTTP 资源的第一次请求返回内容，但第二次请求不返回（返回 304 Not Modified）。然而，在所有情况下，都会填充 http_statusCode 消息头部。这可以在 HTTP 出站网关之后的一些路由逻辑中使用。您也可以使用一个`` 将带有 ResponseEntity 的消息路由到与带有正文的响应所使用的流程不同的流程。
expected-response-type

除了前面关于空响应体的注意事项之外，如果响应确实包含正文，则必须提供适当的 expected-response-type 属性，否则您将再次收到没有正文的 ResponseEntity。expected-response-type 必须与（配置的或默认的）HttpMessageConverter 实例和响应中的 Content-Type 头部兼容。这可以是一个抽象类，甚至是接口（例如在使用 Java 序列化和 Content-Type: application/x-java-serialized-object 时使用 java.io.Serializable）。

从版本 5.5 开始，HttpRequestExecutingMessageHandler 暴露了一个 extractResponseBody 标志（默认为 true），用于仅返回响应体，或将整个 ResponseEntity 作为回复消息的负载返回，这与提供的 expectedResponseType 无关。如果 ResponseEntity 中没有正文，则忽略此标志，并返回整个 ResponseEntity。