42.3. 在 Consumer Implementation 中使用上下文
概述
消费者实施可通过 BindingProvider 接口访问上下文信息。BindingProvider 实例在两个独立上下文中包含上下文信息:
只有放置在消息上下文的应用程序范围内的信息才可以被消费者实施访问。
获取上下文
使用 javax.xml.ws.BindingProvider 接口获取上下文。BindingProvider 接口有两个获取上下文的方法:
getRequestContext()
例 42.7 “getRequestContext ()
方法” 中显示的getRequestContext ()
方法将请求上下文返回为Map
对象。返回的Map
对象可用于直接操作上下文的内容。例 42.7.
getRequestContext ()
方法Map<String, Object>
;getRequestContext
getResponseContext()
例 42.8 “getResponseContext ()
方法” 中显示的getResponseContext ()
将响应上下文返回为Map
对象。返回的Map
对象的内容反映了响应上下文内容的状态,来自当前线程中进行的远程服务的最新成功请求。例 42.8.
getResponseContext ()
方法Map<String, Object>
;getResponseContext
由于代理对象实现 BindingProvider 接口,因此可以通过广播代理对象来获取 BindingProvider 对象。从 BindingProvider 对象获取的上下文仅对用于创建它的代理对象调用的操作有效。
例 42.9 “获取 Consumer 的 Request 上下文” 显示获取代理请求上下文的代码。
例 42.9. 获取 Consumer 的 Request 上下文
// Proxy widgetProxy obtained previously BindingProvider bp = (BindingProvider)widgetProxy; Map<String, Object> requestContext = bp.getRequestContext();
从上下文读取属性
消费者上下文存储在 java.util.Map<String, Object>
对象中。映射的键是 String
对象和包含任意对象的值。使用 java.util.Map.get ()
访问响应上下文属性映射中的条目。
要检索特定的上下文属性 ContextPropertyName,请使用 例 42.10 “读取响应上下文属性” 中显示的代码。
例 42.10. 读取响应上下文属性
// Invoke an operation. port.SomeOperation(); // Read response context property. java.util.Map<String, Object> responseContext = ((javax.xml.ws.BindingProvider)port).getResponseContext(); PropertyType propValue = (PropertyType) responseContext.get(ContextPropertyName);
在上下文中设置属性
消费者上下文是存储在 java.util.Map<String, Object
> 对象中的哈希映射。映射的键是 String
对象和值,它们是任意对象。要在上下文中设置属性,请使用 java.util.Map.put ()
方法。
虽然您可以在请求上下文和响应上下文中设置属性,但只有对请求上下文所做的更改对消息处理产生任何影响。当每个远程调用在当前线程上完成时,响应上下文中的属性将被重置。
例 42.11 “设置请求上下文属性” 中显示的代码通过设置 BindingProvider.ENDPOINT_ADDRESS_PROPERTY 的值来更改目标服务提供商的地址。
例 42.11. 设置请求上下文属性
// Set request context property. java.util.Map<String, Object> requestContext = ((javax.xml.ws.BindingProvider)port).getRequestContext(); requestContext.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, "http://localhost:8080/widgets"); // Invoke an operation. port.SomeOperation();
在请求上下文中设置属性后,将其值用于后续所有远程调用。您可以更改值,然后使用更改的值。
支持的上下文
Apache CXF 在消费者实现中支持以下上下文属性:
属性名称 | 描述 |
---|---|
| |
ENDPOINT_ADDRESS_PROPERTY |
指定目标服务的地址。该值存储为 |
USERNAME_PROPERTY[a] |
指定用于 HTTP 基本身份验证的用户名。该值存储为 |
PASSWORD_PROPERTY[b] |
指定用于 HTTP 基本身份验证的密码。该值存储为 |
SESSION_MAINTAIN_PROPERTY[c] |
指定客户端是否希望维护会话信息。该值作为 |
| |
CLIENT_ADDRESSING_PROPERTIES |
指定消费者用来联系所需服务提供商的 WS-寻址信息。该值存储为 |
| |
JMS_CLIENT_REQUEST_HEADERS | 包含消息的 JMS 标头。如需更多信息,请参阅 第 42.4 节 “使用 JMS 消息属性”。 |
[a]
此属性被 HTTP 安全设置中定义的用户名覆盖。
[b]
此属性被 HTTP 安全设置中定义的密码覆盖。
[c]
Apache CXF 忽略此属性。
|