- 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.- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Standard property: Target service endpoint address.static final String
Standard property: Password for authentication.static final String
Standard property: This boolean property is used by a service client to indicate whether it wants to participate in a session with a service endpoint.static final String
Standard property for SOAPAction.static final String
Standard property for SOAPAction.static final String
Standard property: User name for authentication. -
Method Summary
Modifier and TypeMethodDescriptionGet the Binding for this binding provider.Returns theEndpointReference
associated with thisBindingProvider
instance.<T extends EndpointReference>
TgetEndpointReference
(Class<T> clazz) Returns theEndpointReference
associated with thisBindingProvider
instance.Get the context that is used to initialize the message context for request messages.Get the context that resulted from processing a response message.
-
Field Details
-
USERNAME_PROPERTY
Standard property: User name for authentication.Type:
java.lang.String
- See Also:
-
PASSWORD_PROPERTY
Standard property: Password for authentication.Type:
java.lang.String
- See Also:
-
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:
-
SESSION_MAINTAIN_PROPERTY
Standard property: This boolean property is used by a service client to indicate whether it wants to participate in a session with a service endpoint. If this property is set totrue
, the service client indicates that it wants the session to be maintained. If set tofalse
, the session is not maintained. The default value for this property isfalse
.Type:
java.lang.Boolean
- See Also:
-
SOAPACTION_USE_PROPERTY
Standard property for SOAPAction. This boolean property indicates whether the value of thejakarta.xml.ws.soap.http.soapaction.uri
property is used for the value of the SOAPAction. The default value of this property isfalse
indicating that thejakarta.xml.ws.soap.http.soapaction.uri
property is not used for the value of the SOAPAction, however, if WS-Addressing is enabled, the default value istrue
.Type:
java.lang.Boolean
- See Also:
-
SOAPACTION_URI_PROPERTY
Standard property for SOAPAction. Indicates the SOAPAction URI if thejakarta.xml.ws.soap.http.soapaction.use
property is set totrue
. If WS-Addressing is enabled, this value will also be used for the value of the WS-Addressing Action header. If this property is not set, the default SOAPAction and WS-Addressing Action will be sent.Type:
java.lang.String
- See Also:
-
-
Method Details
-
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
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
EndpointReference getEndpointReference()Returns theEndpointReference
associated with thisBindingProvider
instance.If the Binding for this
bindingProvider
is either SOAP1.1/HTTP or SOAP1.2/HTTP, then aW3CEndpointReference
MUST be returned.- Returns:
- EndpointReference of the target endpoint associated with this
BindingProvider
instance. - Throws:
UnsupportedOperationException
- If thisBindingProvider
uses the XML/HTTP binding.- See Also:
-
getEndpointReference
Returns theEndpointReference
associated with thisBindingProvider
instance. The instance returned will be of typeclazz
.- Type Parameters:
T
- the type ofEndpointReference
- Parameters:
clazz
- Specifies the type ofEndpointReference
that MUST be returned.- Returns:
- EndpointReference of the target endpoint associated with this
BindingProvider
instance. MUST be of typeclazz
. - Throws:
WebServiceException
- If the Classclazz
is not supported by this implementation.UnsupportedOperationException
- If thisBindingProvider
uses the XML/HTTP binding.
-