JAX-WS
v2.1

javax.xml.ws
Interface BindingProvider

All Known Subinterfaces:
Dispatch<T>

public interface BindingProvider

The BindingProvider interface provides access to the protocol binding and associated context objects for request and response message processing.

Since:
JAX-WS 2.0
See Also:
Binding

Field Summary
static java.lang.String ENDPOINT_ADDRESS_PROPERTY
          Standard property: Target service endpoint address.
static java.lang.String PASSWORD_PROPERTY
          Standard property: Password for authentication.
static java.lang.String SESSION_MAINTAIN_PROPERTY
          Standard property: This boolean property is used by a service client to indicate whether or not it wants to participate in a session with a service endpoint.
static java.lang.String SOAPACTION_URI_PROPERTY
          Standard property for SOAPAction.
static java.lang.String SOAPACTION_USE_PROPERTY
          Standard property for SOAPAction.
static java.lang.String USERNAME_PROPERTY
          Standard property: User name for authentication.
 
Method Summary
 Binding getBinding()
          Get the Binding for this binding provider.
 W3CEndpointReference getEndpointReference()
          Returns the W3CEndpointReference associated with this BindingProvider instance.
<T extends EndpointReference>
T
getEndpointReference(java.lang.Class<T> clazz)
          Returns the EndpointReference associated with this BindingProvider instance.
 java.util.Map<java.lang.String,java.lang.Object> getRequestContext()
          Get the context that is used to initialize the message context for request messages.
 java.util.Map<java.lang.String,java.lang.Object> getResponseContext()
          Get the context that resulted from processing a response message.
 

Field Detail

USERNAME_PROPERTY

static final java.lang.String USERNAME_PROPERTY
Standard property: User name for authentication.

Type: java.lang.String

See Also:
Constant Field Values

PASSWORD_PROPERTY

static final java.lang.String PASSWORD_PROPERTY
Standard property: Password for authentication.

Type: java.lang.String

See Also:
Constant Field Values

ENDPOINT_ADDRESS_PROPERTY

static final java.lang.String ENDPOINT_ADDRESS_PROPERTY
Standard property: Target service endpoint address. The URI scheme for the endpoint address specification must correspond to the protocol/transport binding for the binding in use.

Type: java.lang.String

See Also:
Constant Field Values

SESSION_MAINTAIN_PROPERTY

static final java.lang.String SESSION_MAINTAIN_PROPERTY
Standard property: This boolean property is used by a service client to indicate whether or not it wants to participate in a session with a service endpoint. If this property is set to true, the service client indicates that it wants the session to be maintained. If set to false, the session is not maintained. The default value for this property is false.

Type: java.lang.Boolean

See Also:
Constant Field Values

SOAPACTION_USE_PROPERTY

static final java.lang.String SOAPACTION_USE_PROPERTY
Standard property for SOAPAction. This boolean property indicates whether or not SOAPAction is to be used. The default value of this property is false indicating that the SOAPAction is not used.

Type: java.lang.Boolean

See Also:
Constant Field Values

SOAPACTION_URI_PROPERTY

static final java.lang.String SOAPACTION_URI_PROPERTY
Standard property for SOAPAction. Indicates the SOAPAction URI if the javax.xml.ws.soap.http.soapaction.use property is set to true.

Type: java.lang.String

See Also:
Constant Field Values
Method Detail

getRequestContext

java.util.Map<java.lang.String,java.lang.Object> getRequestContext()
Get the context that is used to initialize the message context for request messages. Modifications to the request context do not affect the message context of either synchronous or asynchronous operations that have already been started.

Returns:
The context that is used in processing request messages.

getResponseContext

java.util.Map<java.lang.String,java.lang.Object> getResponseContext()
Get the context that resulted from processing a response message. The returned context is for the most recently completed synchronous operation. Subsequent synchronous operation invocations overwrite the response context. Asynchronous operations return their response context via the Response interface.

Returns:
The context that resulted from processing the latest response messages.

getBinding

Binding getBinding()
Get the Binding for this binding provider.

Returns:
The Binding for this binding provider.

getEndpointReference

W3CEndpointReference getEndpointReference()
Returns the W3CEndpointReference associated with this BindingProvider instance.

The returned W3CEndpointReference must contain the embedded WSDL in the wsa:Metadata element if this WSDL is available. It must also contain the wsaw:ServiceName elements and the wsaw:EndpointName attribute on the wsaw:ServiceName for BindingProviders created from Services that contained that information. The wsaw:InterfaceName may also be present.

Returns:
W3CEndpointReference of this instance.
Throws:
java.lang.UnsupportedOperationException - If this BindingProvider uses the XML/HTTP binding.
Since:
JAX-WS 2.1

getEndpointReference

<T extends EndpointReference> T getEndpointReference(java.lang.Class<T> clazz)
Returns the EndpointReference associated with this BindingProvider instance. The instance returned will be of type clazz.

The returned EndpointReference must contain the embedded WSDL in the wsa:Metadata element if the WSDL is available. It must also contain the wsaw:ServiceName elements and the wsaw:EndpointName attribute on the wsaw:ServiceName for BindingProviders created from Services that contained that information. The wsaw:InterfaceName may also be present.

Returns:
EndpointReference of this instance. Must be of type clazz.
Throws:
WebServiceException - If the Class clazz is not supported by this implementation.
java.lang.UnsupportedOperationException - If this BindingProvider uses the XML/HTTP binding.
Since:
JAX-WS 2.1

JAX-WS
v2.1


Comments to: jsr224-spec-comments@sun.com
More information at: http://java.sun.com/xml/jax-ws

Copyright © 2006 by Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, U.S.A. All Rights Reserved.