跳到主要内容

HTTP 头映射

QWen Plus 中英对照 HTTP Header Mappings

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"/>
xml

适配器和网关使用 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>
xml

如果你需要做 DefaultHttpHeaderMapper 不支持的事情，你可以直接实现 HeaderMapper 策略接口，并提供对你实现的引用。