javax.xml.ws

Interface Dispatch<T>

All Superinterfaces:

BindingProvider

public interface Dispatch<T>
extends BindingProvider

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

从以下版本开始：

JAX-WS 2

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实例配置或如果在调用发生错误的任何错误。