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 實例時出現任何錯誤，或者在調用過程中發生錯誤。