Http Inbound Components

要通过 HTTP 接收消息，您需要使用 HTTP 入站通道适配器或 HTTP 入站网关。为了支持 HTTP 入站适配器，它们需要部署在 servlet 容器中，例如 Apache Tomcat 或 Jetty。执行此操作最简单的方法是使用 Spring 的 HttpRequestHandlerServlet，方法是在 web.xml 文件中提供以下 servlet 定义：

<servlet>
    <servlet-name>inboundGateway</servlet-name>
    <servlet-class>o.s.web.context.support.HttpRequestHandlerServlet</servlet-class>
</servlet>

请注意，servlet 名称与 bean 名称相匹配。有关详细信息，请参见 `HttpRequestHandlerServlet`Javadoc。 如果您在 Spring MVC 应用程序中运行，则无需上述显式 Servlet 定义。在这种情况下，可以将您的网关的 bean 名称与 URL 路径进行匹配，就像针对 Spring MVC 控制器 bean 所做的那样。有关更多信息，请参阅 Spring 框架参考文档一部分的 Web MVC framework。

有关示例应用程序和相应配置，请参阅 Spring Integration Samples 存储库。它包含 HTTP sample 应用程序，展示了 Spring Integration 的 HTTP 支持。

以下示例 bean 定义了一个 HTTP 入站端点：

<bean id="httpInbound"
  class="org.springframework.integration.http.inbound.HttpRequestHandlingMessagingGateway">
  <property name="requestChannel" ref="httpRequestChannel" />
  <property name="replyChannel" ref="httpReplyChannel" />
</bean>

HttpRequestHandlingMessagingGateway 接受 HttpMessageConverter 实例的列表，否则依赖于默认列表。转换器允许自定义从 HttpServletRequest 到 Message 的映射。默认转换器封装了简单的策略，例如为内容类型以 text 开头的 POST 请求创建 String 消息。有关详细信息，请参见 Javadoc。一个附加标志 (mergeWithDefaultConverters) 可以与自定义 HttpMessageConverter 的列表一同设置，以便在自定义转换器之后添加默认转换器。默认情况下，此标志设置为 false，这意味着自定义转换器将替换默认列表。 消息转换过程使用（可选） requestPayloadType 属性​​和传入的 Content-Type 头。从 4.3 版本开始，如果请求没有内容类型头，则假设是 application/octet-stream，如`RFC 2616` 推荐的那样。以前，这种消息的主体被忽略。 Spring Integration 2.0 实现了多部分文件支持。如果你在使用默认转换器时将请求包装为 MultipartHttpServletRequest，则该请求将被转换为`Message` 负载，MultiValueMap`包含根据各个部分的内容类型可能为字节数组、字符串或 Spring的 `MultipartFile 实例的值。

如果上下文中存在`MultipartResolver`的 bean 名称是 multipartResolver （Spring 的 DispatcherServlet 预期的名称），则 HTTP 入站端点将找到该 bean。如果它找到该 bean，则启用入站请求映射器中的多部分文件支持。否则，当它尝试将多部分文件请求映射到 Spring Integration Message 时，它会失败。有关 Spring 对 MultipartResolver 的支持的更多信息，请参阅 Spring Reference Manual。

如果您希望将 multipart/form-data`代理到另一个服务器，则最好将其保留为原始形式。为了处理这种情况，不要将 `multipartResolver`bean 添加到上下文中。将端点配置为期待一个 `byte[]`请求，自定义消息转换器以包括 `ByteArrayHttpMessageConverter，并禁用默认的多部件转换器。您可能需要一些其他转换器才能回复。以下示例演示了此类安排：

<int-http:inbound-gateway
                  channel="receiveChannel"
                  path="/inboundAdapter.htm"
                  request-payload-type="byte[]"
                  message-converters="converters"
                  merge-with-default-converters="false"
                  supported-methods="POST" />

<util:list id="converters">
    <beans:bean class="org.springframework.http.converter.ByteArrayHttpMessageConverter" />
    <beans:bean class="org.springframework.http.converter.StringHttpMessageConverter" />
    <beans:bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter" />
</util:list>

当您向客户端发送响应时，您可以通过多种方式自定义网关的行为。默认情况下，网关通过发送回 200 状态代码来确认收到请求。可以通过向 Spring MVC ViewResolver 提供要解析的 viewName 来自定义此响应。如果网关应该期待对 Message 的答复，则可以设置 expectReply 标志（构造函数参数）以使网关在创建 HTTP 响应之前等待答复 Message。以下示例将网关配置为具有视 图库的 Spring MVC 控制器：

<bean id="httpInbound"
  class="org.springframework.integration.http.inbound.HttpRequestHandlingController">
  <constructor-arg value="true" /> <!-- indicates that a reply is expected -->
  <property name="requestChannel" ref="httpRequestChannel" />
  <property name="replyChannel" ref="httpReplyChannel" />
  <property name="viewName" value="jsonView" />
  <property name="supportedMethodNames" >
    <list>
      <value>GET</value>
      <value>DELETE</value>
    </list>
  </property>
</bean>

由于 constructor-arg 的值为 true，它会等待答复。前面的示例还说明了如何自定义网关接受的 HTTP 方法，默认情况下为 POST 和 GET。 回复消息可在模型图中获得。默认情况下，该映射条目的键为 reply，但您可以通过设置端点配置中的 replyKey 属性来覆盖此默认值。

Payload Validation

从 5.2 版开始，HTTP 入站端点可以提供 `Validator`来检查负载，然后再发送到通道。此负载已经在 `payloadExpression`之后转换和提取的结果，以缩小与有价值数据有关的验证范围。验证失败处理与 Spring MVC Error Handling中的完全相同。