javax.xml.ws

Interface BindingProvider

All Known Subinterfaces:

Dispatch

public interface BindingProvider

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

从以下版本开始：

JAX-WS 2

另请参见：

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() 返回与此 BindingProvider实例关联的 EndpointReference。
<T extends EndpointReference> T	getEndpointReference(类<T> clazz) 返回 EndpointReference这个 BindingProvider实例关联。
Map<String,Object>	getRequestContext() 获取用于初始化请求消息的消息上下文的上下文。
Map<String,Object>	getResponseContext() 获取处理响应消息所导致的上下文。

Field Detail

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属性的值是用于SOAPAction值。此属性的默认值是 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标准属性。指示SOAPAction URI如果 javax.xml.ws.soap.http.soapaction.use属性设置为 true。如果WS-Addressing是启用的，这个值也将用于WS-Addressing行动标头的值。如果未设置此属性，默认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是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。实例返回将 clazz型。

参数

clazz指定 EndpointReference类型必须返回。

结果

与此 BindingProvider实例关联的目标端点endpointreference。必须是类型 clazz。

异常

WebServiceException -如果类 clazz不是由实施支持。

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

从以下版本开始：

JAX-WS 2.1