|
对于最新的稳定版本，请使用 Spring Integration 6.5.1！ |
Http 入站组件
要通过 HTTP 接收消息，您需要使用 HTTP 入站通道适配器或 HTTP 入站网关。
为了支持 HTTP 入站适配器，需要将它们部署在 Servlet 容器（例如 Apache Tomcat 或 Jetty）中。
最简单的方法是使用 Spring 的HttpRequestHandlerServlet，通过在web.xml文件：
<servlet>
<servlet-name>inboundGateway</servlet-name>
<servlet-class>o.s.web.context.support.HttpRequestHandlerServlet</servlet-class>
</servlet>请注意，servlet 名称与 bean 名称匹配。
有关更多信息，请参阅HttpRequestHandlerServletJavadocs。
如果您在 Spring MVC 应用程序中运行，则不需要上述显式 servlet 定义。 在这种情况下，网关的 bean 名称可以与 URL 路径进行匹配，就像 Spring MVC Controller bean 一样。 有关更多信息，请参阅 Web MVC 框架，它是 Spring Framework 参考文档的一部分。
| 有关示例应用程序和相应的配置，请参阅 Spring Integration 示例存储库。 它包含 HTTP 示例应用程序，演示了 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接受HttpMessageConverterinstances 或 else 依赖于默认列表。
转换器允许从HttpServletRequest自Message.
默认转换器封装了简单的策略，例如，这些策略创建了一个String消息POST请求，其中内容类型开头为text.
有关完整详细信息，请参阅 Javadoc。
附加标志 （mergeWithDefaultConverters） 可以与自定义列表一起设置HttpMessageConverter在自定义转换器之后添加默认转换器。
默认情况下，此标志设置为false，这意味着自定义转换器将替换默认列表。
消息转换过程使用（可选）requestPayloadType属性和传入的Content-Type页眉。
从 4.3 版开始，如果请求没有内容类型标头，application/octet-stream被假定，如建议的那样RFC 2616.
以前，此类消息的正文被忽略。
Spring Integration 2.0 实现了多部分文件支持。
如果请求已包装为MultipartHttpServletRequest，当您使用默认转换器时，该请求将转换为Message有效负载，即MultiValueMap包含可能是字节数组、字符串或 Spring 的MultipartFile，具体取决于各个部分的内容类型。
HTTP 入站端点找到一个MultipartResolver在上下文中，如果一个 bean 名称为multipartResolver（与 Spring 的DispatcherServlet).
如果它确实找到了该 bean，那么将在入站请求映射器上启用对多部分文件的支持。
否则，当它尝试将多部分文件请求映射到 Spring Integration 时，它会失败Message.
有关 Spring 对MultipartResolver，请参阅 Spring 参考手册。 |
|
如果您希望代理 |
向客户端发送响应时，可以通过多种方式自定义网关的行为。
默认情况下，网关通过发送200状态代码返回。
可以通过提供要由 Spring MVC 解析的“viewName”来自定义此响应ViewResolver.
如果网关应该期望对Message，您可以将expectReplyflag（构造函数参数）使网关等待回复Message在创建 HTTP 响应之前。
以下示例将网关配置为用作具有视图名称的 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”属性来覆盖此默认值。
有效负载验证
从版本 5.2 开始，可以为 HTTP 入站端点提供Validator在发送到通道之前检查有效负载。
此有效负载已经是转换和提取的结果payloadExpression缩小有关有价值数据的验证范围。
验证失败处理与我们在 Spring MVC 错误处理中的处理完全相同。