12.2. 配置一个 Consumer
12.2.1. HTTP 消费者端点的机制
HTTP 消费者端点可以指定多个 HTTP 连接属性，包括端点是否自动接受重定向响应，端点是否可以使用块，端点是否请求 keep-alive，以及端点如何与代理交互。除了 HTTP 连接属性外，HTTP 使用者端点还可以指定它如何进行保护。
可以使用两种机制配置消费者端点：
12.2.2. 使用配置
命名空间
用于配置 HTTP 消费者端点的元素在命名空间 http://cxf.apache.org/transports/http/configuration 中定义。它通常被引用使用前缀 http-conf。要使用 HTTP 配置元素，您必须将 例 12.4 “HTTP Consumer 配置命名空间” 中显示的行添加到端点配置文件的 beans 元素中。另外，您必须将配置元素的命名空间添加到 xsi:schemaLocation 属性中。
例 12.4. HTTP Consumer 配置命名空间
<beans ...
xmlns:http-conf="http://cxf.apache.org/transports/http/configuration"
...
xsi:schemaLocation="...
http://cxf.apache.org/transports/http/configuration
http://cxf.apache.org/schemas/configuration/http-conf.xsd
...">Undertow 运行时或 Netty 运行时
您可以使用 http-conf 命名空间中的元素来配置 Undertow 运行时或 Netty 运行时。
conduit 元素
您可以使用 http-conf:conduit 元素及其子项配置 HTTP 使用者端点。http-conf:conduit 元素采用单个属性，名称，用于指定与端点对应的 WSDL 端口 元素。name 属性的值采用 portQName'.http-conduit' 形式。例 12.5 “http-conf:conduit Element” 显示 http-conf:conduit 元素，用于为由 WSDL 片段 < port binding="widgetSOAPBinding" name="widgetSOAPPort > 指定的端点添加配置（当端点目标命名空间为 http://widgets.widgetvendor.net 时）。
例 12.5. http-conf:conduit Element
...
<http-conf:conduit name="{http://widgets/widgetvendor.net}widgetSOAPPort.http-conduit">
...
</http-conf:conduit>
...
http-conf:conduit 元素具有指定配置信息的子元素。它们在 表 12.1 “用于配置 HTTP 消费者端点的元素” 中进行了描述。
| 元素 | 描述 |
|---|---|
|
| 指定 HTTP 连接属性，如超时、保留请求、内容类型等。请参阅 “client 元素”一节。 |
|
指定用于配置端点使用的基本验证方法的参数。首选的方法是提供 | |
| 指定用于针对传出 HTTP 代理服务器配置基本身份验证的参数。 | |
| 指定用来配置 SSL/TLS 的参数。 | |
| 指定提供端点使用的基本身份验证信息的 bean 引用或类名称，可以是抢占，或响应 401 HTTP 质询。 | |
|
指定在传输任何信息前，检查 HTTP (S) |
client 元素
http-conf:client 元素用于配置消费者端点的 HTTP 连接的非安全属性。其属性（如 表 12.2 “HTTP Consumer 配置属性” 所述）指定连接的属性。
| 属性 | 描述 |
|---|---|
|
指定消费者在超时前尝试建立连接的时间（以毫秒为单位）。默认值为
| |
|
指定消费者在超时前等待响应的时间（以毫秒为单位）。默认值为
| |
|
指定消费者是否自动遵循服务器发出的重定向。默认值为 | |
|
指定消费者重新传输请求以满足重定向的次数。默认值为 | |
|
指定消费者是否使用块发送请求。默认值为 如果以下之一为 true，则无法使用块：
在这两种情况下，都会忽略 | |
|
指定消费者为处理准备的介质类型。该值用作 HTTP | |
|
指定消费者选择接收响应的语言（例如，美国英语）。该值用作 HTTP 语言标签由 Standards (ISO)的国际组织规范，通常通过组合语言代码（由 ISO-639 标准和国家代码决定）决定，由 ISO-3166 标准，由连字符分开。例如，en-US 代表美国英语。 | |
|
指定消费者准备处理的内容编码。内容编码标签由互联网分配号授权机构(IANA)规范。该值用作 HTTP | |
|
指定消息正文中发送的数据的介质类型。介质类型使用多用途互联网邮件扩展(MIME)类型来指定。该值用作 HTTP
对于 Web 服务，这应设置为 | |
|
指定正在调用请求的资源的互联网主机和端口号。该值用作 HTTP 通常不需要此属性。只有某些 DNS 场景或应用程序设计才需要它。例如，它指示客户端为集群优先选择的主机（即，虚拟服务器映射到同一互联网协议(IP)地址）。 | |
| 指定在每次请求/响应对话框后是否要保持特定的连接打开或关闭。有效值有两个：
| |
| 指定关于必须遵循链中涉及的缓存的行为指令，该指令由消费者到服务提供商的请求组成。请参阅 第 12.2.4 节 “消费者缓存控制指令”。 | |
| 指定要随所有请求发送的静态 Cookie。 | |
| 指定请求源自的浏览器的信息。在 World Wide Web consortium (W3C)的 HTTP 规范中，这也称为 user-agent。有些服务器根据发送请求的客户端进行优化。 | |
|
指定指示消费者在特定服务上发出请求的资源 URL。该值用作 HTTP 当请求是浏览器用户点击超链接而不是键入 URL 时，会使用此 HTTP 属性。这允许服务器根据前面的任务流优化处理，并为日志、优化缓存、跟踪过时或输入的链接等目的生成到资源的后端列表。但是，它通常不在 Web 服务应用程序中使用。
如果 | |
| 指定通过单独的 provider→consumer 连接接收响应的分离端点的 URL。有关使用分离端点的更多信息，请参阅 第 12.6 节 “以 Decoupled 模式使用 HTTP 传输”。 您必须配置使用者端点和服务提供商端点，以使用 WS-Addressing 来使分离的端点正常工作。 | |
| 指定路由请求的代理服务器的 URL。 | |
| 指定路由请求的代理服务器的端口号。 | |
| 指定用于路由请求的代理服务器的类型。有效值为：
|
示例
例 12.6 “HTTP 消费者端点配置” 显示 HTTP 消费者端点的配置，该端点希望在请求之间保持与提供程序的连接，该端点将在每次调用后重新传输请求，且无法使用块流。
例 12.6. HTTP 消费者端点配置
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:http-conf="http://cxf.apache.org/transports/http/configuration"
xsi:schemaLocation="http://cxf.apache.org/transports/http/configuration
http://cxf.apache.org/schemas/configuration/http-conf.xsd
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<http-conf:conduit name="{http://apache.org/hello_world_soap_http}SoapPort.http-conduit">
<http-conf:client Connection="Keep-Alive"
MaxRetransmits="1"
AllowChunking="false" />
</http-conf:conduit>
</beans>更多信息
有关 HTTP conduits 的详情，请参考 第 16 章 conduits。
12.2.3. 使用 WSDL
命名空间
用于配置 HTTP 消费者端点的 WSDL 扩展元素在命名空间 http://cxf.apache.org/transports/http/configuration 中定义。它通常被引用使用前缀 http-conf。要使用 HTTP 配置元素，您必须将 例 12.7 “HTTP Consumer WSDL 元素的命名空间” 中显示的行添加到端点的 WSDL 文档中的 定义 元素中。
例 12.7. HTTP Consumer WSDL 元素的命名空间
<definitions ...
xmlns:http-conf="http://cxf.apache.org/transports/http/configuration"Undertow 运行时或 Netty 运行时
您可以使用 http-conf 命名空间中的元素来配置 Undertow 运行时或 Netty 运行时。
client 元素
http-conf:client 元素用于在 WSDL 文档中指定 HTTP 使用者的连接属性。http-conf:client 元素是 WSDL 端口 元素的子级。它的属性与配置文件中使用的 client 元素相同。这些属性在 表 12.2 “HTTP Consumer 配置属性” 中进行了描述。
示例
例 12.8 “WSDL 配置 HTTP 消费者端点” 显示一个 WSDL 片段，它将配置 HTTP 使用者端点来指定它不与缓存交互。
例 12.8. WSDL 配置 HTTP 消费者端点
<service ... >
<port ... >
<soap:address ... />
<http-conf:client CacheControl="no-cache" />
</port>
</service>12.2.4. 消费者缓存控制指令
表 12.3 “http-conf:client Cache Control Directives” 列出 HTTP 使用者支持的缓存控制指令。
| 指令 | 行为 |
|---|---|
| no-cache | 缓存不能在不首先重新评估该服务器的情况下，使用特定的响应来满足后续请求。如果使用这个值指定特定的响应标头字段，则限制仅适用于响应中的标头字段。如果没有指定响应标头字段，则限制适用于整个响应。 |
| no-store | 缓存不得存储响应的任何部分或调用它的请求的任何部分。 |
| max-age | 消费者可以接受其年龄不超过指定时间（以秒为单位）的响应。 |
| max-stale | 消费者可以接受超过其过期时间的响应。如果一个值被分配给 max-stale，它代表响应的过期时间超过秒数，消费者仍然可以接受该响应。如果没有分配值，则消费者可以接受任何年龄的过时的响应。 |
| min-fresh | 消费者希望获得至少指定秒数的最新响应。 |
| no-transform | 缓存不得修改内容在提供程序和消费者之间响应中的介质类型或位置。 |
| only-if-cached | 缓存应仅返回当前存储在缓存中的响应，而不返回需要重新加载或重新验证的响应。 |
| cache-extension | 指定其他缓存指令的额外扩展。扩展可以是信息或行为。在标准指令的上下文中指定扩展指令，以便不了解扩展指令的应用程序可以遵循 standard 指令强制的行为。 |
