|
| |
|
| javax.xml.ws.Dispatch
| Dispatch | | public interface Dispatch extends BindingProvider(Code) | | The Dispatch interface provides support
for the dynamic invocation of a service endpoint operations. The
javax.xml.ws.Service
interface acts as a factory for the creation of Dispatch
instances.
since:
JAX-WS 2.0 |
| Method Summary | |
| public T | invoke(T msg)
Invoke a service operation synchronously.
The client is responsible for ensuring that the msg object
when marshalled is formed according to the requirements of the protocol
binding in use.
Parameters:
msg - An object that will form the message or payload ofthe message used to invoke the operation. | | public Response<T> | invokeAsync(T msg)
Invoke a service operation asynchronously. | | public Future | invokeAsync(T msg, AsyncHandler<T> handler)
Invoke a service operation asynchronously. | | public void | invokeOneWay(T msg)
Invokes a service operation using the one-way
interaction mode. |
| invoke | | public T invoke(T msg)(Code) | | Invoke a service operation synchronously.
The client is responsible for ensuring that the msg object
when marshalled is formed according to the requirements of the protocol
binding in use.
Parameters:
msg - An object that will form the message or payload ofthe message used to invoke the operation. The response message or message payload to theoperation invocation.
throws:
WebServiceException - If a fault occurs during communication withthe service
throws:
WebServiceException - If there is any error in the configuration ofthe Dispatch instance |
| invokeAsync | | public Response<T> invokeAsync(T msg)(Code) | | Invoke a service operation asynchronously. The
method returns without waiting for the response to the operation
invocation, the results of the operation are obtained by polling the
returned Response.
The client is responsible for ensuring that the msg object
when marshalled is formed according to the requirements of the protocol
binding in use.
Parameters:
msg - An object that will form the message or payload ofthe message used to invoke the operation. The response message or message payload to theoperation invocation.
throws:
WebServiceException - If there is any error in the configuration ofthe Dispatch instance |
| invokeAsync | | public Future invokeAsync(T msg, AsyncHandler<T> handler)(Code) | | Invoke a service operation asynchronously. The
method returns without waiting for the response to the operation
invocation, the results of the operation are communicated to the client
via the passed in handler.
The client is responsible for ensuring that the msg object
when marshalled is formed according to the requirements of the protocol
binding in use.
Parameters:
msg - An object that will form the message or payload ofthe message used to invoke the operation.
Parameters:
handler - The handler object that will receive theresponse to the operation invocation. A Future object that may be used to check the statusof the operation invocation. This object MUST NOT be used to try toobtain the results of the operation - the object returned fromFuture<?>.get() is implementation dependentand any use of it will result in non-portable behaviour.
throws:
WebServiceException - If there is any error in the configuration ofthe Dispatch instance |
| invokeOneWay | | public void invokeOneWay(T msg)(Code) | | Invokes a service operation using the one-way
interaction mode. The operation invocation is logically non-blocking,
subject to the capabilities of the underlying protocol, no results
are returned. When
the protocol in use is SOAP/HTTP, this method MUST block until
an HTTP response code has been received or an error occurs.
The client is responsible for ensuring that the msg object
when marshalled is formed according to the requirements of the protocol
binding in use.
Parameters:
msg - An object that will form the message or payload ofthe message used to invoke the operation.
throws:
WebServiceException - If there is any error in the configuration ofthe Dispatch instance or if an error occurs during theinvocation. |
|
|
|