Http 入站组件

要通过 HTTP 接收消息,您需要使用 HTTP 入站通道适配器或 HTTP 入站网关。 要支持 HTTP 入站适配器,需要将它们部署在 servlet 容器(如 Apache TomcatJetty)中。 最简单的方法是使用 Spring 的HttpRequestHandlerServlet,通过在web.xml文件:spring-doc.cadn.net.cn

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

请注意,Servlet 名称与 Bean 名称匹配。 有关更多信息,请参阅HttpRequestHandlerServletJavadocs 的 Java 文档。spring-doc.cadn.net.cn

如果你在 Spring MVC 应用程序中运行,那么上述显式 servlet 定义就不是必需的。 在这种情况下,网关的 Bean 名称可以与 URL 路径匹配,就像对 Spring MVC 控制器 Bean 所做的那样。 有关更多信息,请参阅 Web MVC 框架,它是 Spring 框架参考文档的一部分。spring-doc.cadn.net.cn

有关示例应用程序和相应的配置,请参阅 Spring 集成示例存储库。 它包含 HTTP 示例应用程序,该应用程序演示了 Spring 集成的 HTTP 支持。

以下示例 Bean 定义了一个 HTTP 入站端点:spring-doc.cadn.net.cn

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

HttpRequestHandlingMessagingGateway接受HttpMessageConverterinstances 否则依赖于 default 列表。 转换器允许自定义HttpServletRequestMessage. 默认转换器封装了简单的策略,例如,这些策略会创建一个Stringmessage 的POST内容类型开头的请求text. 有关完整详细信息,请参阅 Javadoc。 附加标志 (mergeWithDefaultConverters) 可以与 list 一起设置自定义HttpMessageConverter以在 Custom Converters(自定义转换器)之后添加 Default Converters(默认转换器)。 默认情况下,此标志设置为false,这意味着自定义转换器将替换默认列表。spring-doc.cadn.net.cn

消息转换过程使用(可选)requestPayloadType属性和传入的Content-Type页眉。 从版本 4.3 开始,如果请求没有内容类型标头,application/octet-stream假设,如RFC 2616. 以前,此类消息的正文被忽略。spring-doc.cadn.net.cn

Spring Integration 2.0 实现了多部分文件支持。 如果请求已包装为MultipartHttpServletRequest,当您使用默认转换器时,该请求将转换为Messagepayload 的MultiValueMap包含的值可以是字节数组、字符串或 Spring 的MultipartFile,具体取决于各个部分的内容类型。spring-doc.cadn.net.cn

HTTP 入站端点会找到一个MultipartResolver在上下文中,如果 bean 名称为multipartResolver(与 Spring 的DispatcherServlet). 如果它确实找到了该 bean,则会在入站请求映射器上启用对 multipart 文件的支持。 否则,当它尝试将 multipart 文件请求映射到 Spring 集成时,它将失败Message. 有关 Spring 对MultipartResolver,请参阅 Spring Reference Manual

如果您希望代理multipart/form-data对于另一台服务器,最好将其保持为 Raw 格式。 要处理这种情况,请不要添加multipartResolverbean 添加到上下文中。 将终端节点配置为预期byte[]request 中,自定义消息转换器以包含ByteArrayHttpMessageConverter,并禁用默认的 Multipart 转换器。 您可能需要一些其他转换器来回复。 以下示例显示了这种安排:spring-doc.cadn.net.cn

<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 解析的 'viewName' 来自定义此响应ViewResolver. 如果网关应该期望收到对Message中,您可以设置expectReplyflag(构造函数参数)使网关等待回复Message在创建 HTTP 响应之前。 下面的示例将网关配置为用作具有视图名称的 Spring MVC 控制器:spring-doc.cadn.net.cn

<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 方法,这些方法是POSTGET默认情况下。spring-doc.cadn.net.cn

回复消息在模型映射中可用。 默认情况下,该映射条目的键是 'reply',但您可以通过在终端节点的配置上设置 'replyKey' 属性来覆盖此默认值。spring-doc.cadn.net.cn

有效载荷验证

从版本 5.2 开始,HTTP 入站端点可以被提供Validator在发送到通道之前检查 payload。 此有效负载已经是 after 转换和提取的结果payloadExpression缩小与有价值数据相关的验证范围。 验证失败的处理与我们在 Spring MVC 错误处理中的处理完全相同。spring-doc.cadn.net.cn