javax.xml.ws

Interface Dispatch<T>

All Superinterfaces:

BindingProvider

public interface Dispatch<T>
extends BindingProvider

Dispatch接口为动态调用服务端点操作提供支持。 javax.xml.ws.Service类用作创建Dispatch实例的工厂。

从以下版本开始：

JAX-WS 2.0

Field Summary

Fields inherited from interface javax.xml.ws.BindingProvider

ENDPOINT_ADDRESS_PROPERTY, PASSWORD_PROPERTY, SESSION_MAINTAIN_PROPERTY, SOAPACTION_URI_PROPERTY, SOAPACTION_USE_PROPERTY, USERNAME_PROPERTY

方法摘要

Modifier and Type	Method and Description
T	invoke(T msg) 同步调用服务操作。
Response<T>	invokeAsync(T msg) 异步调用服务操作。
Future<?>	invokeAsync(T msg, AsyncHandler<T> handler) 异步调用服务操作。
void	invokeOneWay(T msg) 使用单向交互模式调用服务操作。

Methods inherited from interface javax.xml.ws.BindingProvider

getBinding, getEndpointReference, getEndpointReference, getRequestContext, getResponseContext

方法详细信息

invoke

T invoke(T msg)

同步调用服务操作。 根据使用协议绑定的要求，客户端负责确保msg对象。

参数

msg - 将形成用于调用操作的消息的消息或有效负载的对象。

结果

响应消息或消息有效载荷到操作调用。

异常

WebServiceException - 如果在与服务通信期间发生故障

WebServiceException - 如果 Dispatch实例的配置有任何错误

invokeAsync

Response<T> invokeAsync(T msg)

异步调用服务操作。 该方法返回而不等待对操作调用的响应，操作的结果通过轮询返回的Response 。

根据使用协议绑定的要求，客户端负责确保msg对象。

参数

msg - 将形成用于调用操作的消息或消息的有效内容的对象。

结果

响应消息或消息有效载荷到操作调用。

异常

WebServiceException - 如果 Dispatch实例的配置有任何错误

invokeAsync

Future<?> invokeAsync(T msg,
                      AsyncHandler<T> handler)

异步调用服务操作。 无需等待响应于所述操作调用该方法返回，操作的结果通过在传递传送到客户端handler 。

根据使用协议绑定的要求，客户端负责确保msg对象。

参数

msg - 将形成用于调用操作的消息或消息的有效内容的对象。

handler - 将接收对操作调用的响应的处理程序对象。

结果

甲Future可用于检查操作调用的状态对象。 该对象绝对不能用于尝试获取操作的结果 - 从Future<?>.get()返回的对象是依赖于实现的，并且任何使用它将导致非便携式行为。

异常

WebServiceException - 如果 Dispatch实例的配置有任何错误

invokeOneWay

void invokeOneWay(T msg)

使用单向交互模式调用服务操作。 操作调用在逻辑上是非阻塞的，受底层协议的功能的限制，不会返回任何结果。 当使用的协议是SOAP / HTTP时，该方法必须阻塞，直到接收到HTTP响应代码或发生错误。

根据使用协议绑定的要求，客户端负责确保msg对象。

参数

msg - 将形成用于调用操作的消息或消息的有效内容的对象。

异常

WebServiceException - 如果 Dispatch实例的配置有任何错误或调用期间发生错误。