JavaTM Platform
Standard Ed. 6

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 实例时出现任何错误,或者在调用过程中发生错误。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策