javax.xml.ws

Interface BindingProvider

All Known Subinterfaces:

Dispatch <T>

public interface BindingProvider

BindingProvider接口提供对协议绑定和相关联的上下文对象的访问以用于请求和响应消息处理。

从以下版本开始：

JAX-WS 2.0

另请参见：

Binding

Field Summary

Fields

Modifier and Type	Field and Description
static String	ENDPOINT_ADDRESS_PROPERTY 标准属性：目标服务端点地址。
static String	PASSWORD_PROPERTY 标准属性：验证密码。
static String	SESSION_MAINTAIN_PROPERTY 标准属性：此布尔属性由服务客户端用于指示是否要参与与服务端点的会话。
static String	SOAPACTION_URI_PROPERTY SOAPAction的标准属性。
static String	SOAPACTION_USE_PROPERTY SOAPAction的标准属性。
static String	USERNAME_PROPERTY 标准属性：认证用户名。

方法摘要

Modifier and Type	Method and Description
Binding	getBinding() 获取此绑定提供程序的绑定。
EndpointReference	getEndpointReference() 返回 EndpointReference与此相关 BindingProvider实例。
<T extends EndpointReference> T	getEndpointReference(类<T> clazz) 返回 EndpointReference与此相关 BindingProvider实例。
Map<String,Object>	getRequestContext() 获取用于初始化请求消息的消息上下文的上下文。
Map<String,Object>	getResponseContext() 获取处理响应消息产生的上下文。

字段详细信息

USERNAME_PROPERTY

static final String USERNAME_PROPERTY

标准属性：认证用户名。

类型： java.lang.String

另请参见：

Constant Field Values

PASSWORD_PROPERTY

static final String PASSWORD_PROPERTY

标准属性：验证密码。

类型： java.lang.String

另请参见：

Constant Field Values

ENDPOINT_ADDRESS_PROPERTY

static final String ENDPOINT_ADDRESS_PROPERTY

标准属性：目标服务端点地址。 端点地址规范的URI方案必须对应于正在使用的绑定的协议/传输绑定。

类型： java.lang.String

另请参见：

Constant Field Values

SESSION_MAINTAIN_PROPERTY

static final String SESSION_MAINTAIN_PROPERTY

标准属性：此布尔属性由服务客户端用于指示是否要参与与服务端点的会话。 如果此属性设置为true ，则服务客户端指示它要维护会话。 如果设置为false ，则会话不被维护。 此属性的默认值为false 。

类型： java.lang.Boolean

另请参见：

Constant Field Values

SOAPACTION_USE_PROPERTY

static final String SOAPACTION_USE_PROPERTY

SOAPAction的标准属性。 此布尔属性指示javax.xml.ws.soap.http.soapaction.uri属性的值是否用于javax.xml.ws.soap.http.soapaction.uri的值。 此属性的默认值是false表明javax.xml.ws.soap.http.soapaction.uri属性不用于SOAPAction的价值，但是，如果WS-Addressing的启用，默认值是true 。

类型： java.lang.Boolean

另请参见：

Constant Field Values

SOAPACTION_URI_PROPERTY

static final String SOAPACTION_URI_PROPERTY

SOAPAction的标准属性。 如果javax.xml.ws.soap.http.soapaction.use属性设置为true则指示SOAPAction URI。 如果启用了WS-Addressing，则该值也将用于WS-Addressing Action头的值。 如果未设置此属性，将发送默认的SOAPAction和WS-Addressing操作。

类型： java.lang.String

另请参见：

Constant Field Values

方法详细信息

getRequestContext

Map<String,Object> getRequestContext()

获取用于初始化请求消息的消息上下文的上下文。 对请求上下文的修改不会影响已经启动的同步或异步操作的消息上下文。

结果

用于处理请求消息的上下文。

getResponseContext

Map<String,Object> getResponseContext()

获取处理响应消息产生的上下文。 返回的上下文是最近完成的同步操作。 随后的同步操作调用将覆盖响应上下文。 异步操作通过响应界面返回其响应上下文。

结果

处理最新回应讯息产生的上下文。

getBinding

Binding getBinding()

获取此绑定提供程序的绑定。

结果

此绑定提供程序的绑定。

getEndpointReference

EndpointReference getEndpointReference()

返回与此BindingProvider实例EndpointReference联的BindingProvider 。

如果此bindingProvider的绑定是SOAP1.1 / HTTP或SOAP1.2 / HTTP，则必须返回一个W3CEndpointReference 。

结果

与此 BindingProvider实例相关联的目标端点的EndpointReference。

异常

UnsupportedOperationException - 如果这 BindingProvider使用XML / HTTP绑定。

从以下版本开始：

JAX-WS 2.1

另请参见：

W3CEndpointReference

getEndpointReference

<T extends EndpointReference> T getEndpointReference(类<T> clazz)

返回与此BindingProvider实例EndpointReference联的BindingProvider 。 返回的实例将为clazz 。

参数

clazz - 指定必须返回的类型 EndpointReference 。

结果

与此BindingProvider实例相关联的目标端点的EndpointReference。 必须是clazz 。

异常

WebServiceException - 如果此 clazz不支持Class clazz。

UnsupportedOperationException - 如果这 BindingProvider使用XML / HTTP绑定。

从以下版本开始：

JAX-WS 2.1