javax.xml.ws
接口 Dispatch<T>

所有超级接口：

BindingProvider

public interface Dispatch<T>
     

      extends 
      BindingProvider
     

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

从以下版本开始：

JAX-WS 2.0

字段摘要

从接口 javax.xml.ws.BindingProvider 继承的字段

ENDPOINT_ADDRESS_PROPERTY, PASSWORD_PROPERTY, SESSION_MAINTAIN_PROPERTY, SOAPACTION_URI_PROPERTY, SOAPACTION_USE_PROPERTY, USERNAME_PROPERTY

方法摘要

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

从接口 javax.xml.ws.BindingProvider 继承的方法

getBinding, 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)

异步调用服务操作。该方法无需等待对操作调用的响应即可返回，操作的结果可以通过传入的处理程序与客户端进行通信。 客户端负责确保在编组 msg 对象时根据所用协议绑定的要求形成它们。

参数：

msg - 一个对象，将形成用来调用操作的消息或消息负载。

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

返回：

一个 Future 对象，可以用来检查操作调用的状态。此对象不得用来尝试获得操作的结果 - 从 Future<?>.get() 返回的对象与实现有关，并且使用该对象将导致不可移植的行为。

抛出：

WebServiceException - 如果在配置 Dispatch 实例时出现任何错误

invokeOneWay

void invokeOneWay(T msg)

使用单向交互模式调用服务操作。该操作调用逻辑上是非阻塞的，受到底层协议功能的限制，不返回结果。当使用的协议为 SOAP/HTTP 时，在收到 HTTP 响应代码或发生错误前，此方法必须阻塞。 客户端负责确保在编组 msg 对象时根据所用协议绑定的要求形成它们。

参数：

msg - 一个对象，将形成用于调用操作的消息或消息负载。

抛出：

WebServiceException - 如果在配置 Dispatch 实例时出现任何错误，或者在调用过程中发生错误。