17.2. 配置 Consumer 端点
概述
JAX-WS 消费者端点使用 jaxws:client 元素进行配置。元素的属性提供了创建消费者所需的基本信息。
要将其他功能（如 WS-RM）添加到添加到 jaxws:client 元素的使用者。子元素也用于配置端点的日志记录行为，并将其他属性注入到端点的实施中。
基本配置属性
表 17.4 “用于配置 JAX-WS Consumer 的属性” 中描述的属性提供了配置 JAX-WS 消费者所需的基本信息。您只需要为您要配置的特定属性提供值。大多数属性都有可识别的默认值，或者它们依赖于端点合同提供的信息。
| 属性 | 描述 |
|---|---|
| 指定消费者发出请求的端点的 HTTP 地址。这个值覆盖合同中设定的值。 | |
| 指定消费者使用的消息绑定 ID。第 23 章 Apache CXF Binding ID 中提供了有效绑定 ID 列表。 | |
| 指定 Spring bean 配置总线管理端点的 ID。 | |
|
指定消费者发出请求的服务的 | |
|
指定消费者发出请求的服务的 | |
| 指定用于简单用户名/密码身份验证的用户名。 | |
| 指定用于简单用户名/密码验证的密码。 | |
| 指定服务端点接口(SEI)的名称。 | |
| 指定端点的 WSDL 合同的位置。WSDL 合同的位置相对于部署客户端的文件夹。 | |
|
指定消费者发出请求的服务的 | |
|
指定 bean 是否为抽象 bean。abstract Bean 充当拥塞 Bean 定义且没有实例化的父项。默认值为 | |
| 指定在端点实例化前端点要实例化的 Bean 列表。 | |
|
指定使用了 Apache CXF API（如
默认值为
将其设置为
|
除了 表 17.4 “用于配置 JAX-WS Consumer 的属性” 中列出的属性，可能需要使用多个 xmlns:shortName 属性来声明 endpointName 和 serviceName 属性使用的命名空间。
添加功能
要为消费者添加功能或执行高级配置，您必须将子元素添加到配置中。
子元素允许您进行以下操作：
表 17.5 “配置消费者端点的元素” 描述可用于配置 JAX-WS 消费者的子元素。
| 元素 | 描述 |
|---|---|
|
指定 bean 配置端点使用的消息绑定。使用 | |
|
指定实施端点使用的数据绑定的类。您使用嵌入式 bean 定义来指定此值。实施 JAXB 数据源的类是 | |
| 指定 Beans 列表，用于配置 Apache CXF 的高级功能。您可以提供 bean 引用列表或嵌入式 Bean 列表。 | |
| 指定用于处理消息的 JAX-WS Handler 实施列表。有关 JAX-WS Handler 实现的更多信息，请参阅 第 43 章 编写处理程序。 | |
| 指定进程入站响应的拦截器列表。更多信息请参阅 第 VII 部分 “开发 Apache CXF Interceptors”。 | |
| 指定处理入站错误信息的拦截器列表。更多信息请参阅 第 VII 部分 “开发 Apache CXF Interceptors”。 | |
| 指定处理出站请求的拦截器列表。更多信息请参阅 第 VII 部分 “开发 Apache CXF Interceptors”。 | |
| 指定处理出站错误信息的拦截器列表。更多信息请参阅 第 VII 部分 “开发 Apache CXF Interceptors”。 | |
| 指定传递给端点的属性映射。 | |
|
指定一个 org.apache.cxf.endpoint.ConduitSelector 实现，供客户端使用。ConduitSelector 实施将覆盖用来选择用于处理出站请求的 | |
[a]
SOAP 绑定使用 soap: SOApBinding bean 进行配置。
| |
示例
例 17.5 “简单消费者配置” 显示了简单的使用者配置。
例 17.5. 简单消费者配置
<beans ...
xmlns:jaxws="http://cxf.apache.org/jaxws"
...
schemaLocation="...
http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd
...">
<jaxws:client id="bookClient"
serviceClass="org.apache.cxf.demo.BookClientImpl"
address="http://localhost:8080/books"/>
...
</beans>在 JAX-WS 消费者上启用架构验证
要在 JAX-WS 使用者上启用架构验证，请在 jaxws:properties 子元素中设置 schema-validation-enabled 属性，例如：
<jaxws:client name="{http://apache.org/hello_world_soap_http}SoapPort"
createdFromAPI="true">
<jaxws:properties>
<entry key="schema-validation-enabled" value="BOTH" />
</jaxws:properties>
</jaxws:client>
有关 schema-validation-enabled 属性的允许值列表，请参阅 第 24.3.4.7 节 “架构验证类型值”。
