HTTP 头映射
Spring Integration 为 HTTP 请求和 HTTP 响应提供 HTTP 头映射支持。
默认情况下,所有标准的 HTTP 头都会从消息映射到 HTTP 请求或响应头,无需额外配置。但是,如果您需要进一步定制,可以利用命名空间支持提供额外的配置。您可以提供一个逗号分隔的头名称列表,并且可以使用 '*' 字符作为通配符来包含简单的模式。提供此类值会覆盖默认行为。基本上,这意味着您在此时完全控制了映射。但是,如果您想包含所有标准的 HTTP 头,可以使用快捷模式:HTTP_REQUEST_HEADERS
和 HTTP_RESPONSE_HEADERS
。下面的列表显示了两个示例(第一个使用了通配符)
<int-http:outbound-gateway id="httpGateway"
url="http://localhost/test2"
mapped-request-headers="thing1, thing2"
mapped-response-headers="X-*, HTTP_RESPONSE_HEADERS"
channel="someChannel"/>
<int-http:outbound-channel-adapter id="httpAdapter"
url="http://localhost/test2"
mapped-request-headers="thing1, thing2, HTTP_REQUEST_HEADERS"
channel="someChannel"/>
适配器和网关使用 DefaultHttpHeaderMapper
,它现在为入站和出站适配器提供了两个静态工厂方法,以便可以应用正确的方向(根据需要将 HTTP 请求和响应映射入或出)。
如果您需要进一步定制,还可以独立配置一个 DefaultHttpHeaderMapper
,并通过 header-mapper
属性将其注入到适配器中。
在 5.0 版本之前,DefaultHttpHeaderMapper
用户定义的非标准 HTTP 头的默认前缀是 X-
。5.0 版本将默认前缀更改为空字符串。根据 RFC-6648,现在不鼓励使用此类前缀。您仍然可以通过设置 DefaultHttpHeaderMapper.setUserDefinedHeaderPrefix()
属性来定制此选项。以下示例为一个 HTTP 网关配置了头映射器
<int-http:outbound-gateway id="httpGateway"
url="http://localhost/test2"
header-mapper="headerMapper"
channel="someChannel"/>
<bean id="headerMapper" class="o.s.i.http.support.DefaultHttpHeaderMapper">
<property name="inboundHeaderNames" value="thing1*, *thing2, thing3"/>
<property name="outboundHeaderNames" value="a*b, d"/>
</bean>
如果您需要做一些 DefaultHttpHeaderMapper
不支持的事情,可以直接实现 HeaderMapper
策略接口并提供对您实现的引用。