Module  java.xml.ws
软件包  javax.xml.ws

Interface Dispatch<T>

  • 参数类型
    T - 消息或有效载荷的类型
    All Superinterfaces:
    BindingProvider


    public interface Dispatch<T>
    extends BindingProvider
    Dispatch接口为服务端点操作的动态调用提供支持。 javax.xml.ws.Service类作为创建Dispatch实例的工厂。
    从以下版本开始:
    1.6,JAX-WS 2.0
    • 方法详细信息

      • 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 - If there is any error in the configuration of the Dispatch instance or if an error occurs during the invocation.