メソッドの詳細

• invoke

  T invoke​(T msg)

  同期的にサービス操作を呼び出します。クライアントは、マーシャリング時に msg オブジェクトが、使用中のプロトコルバインディングの要件に従って形成されていることを確認する責任があります。

  パラメーター:

  msg - 操作を呼び出すために使用されるメッセージまたはメッセージのペイロードを形成するオブジェクト。

  戻り値:

  操作呼び出しに対するレスポンスメッセージまたはメッセージペイロード。

  例外:

  WebServiceException - サービスとの通信中に障害が発生した場合

  WebServiceException - Dispatch インスタンスの構成にエラーがある場合

• invokeAsync

  Response<T> invokeAsync​(T msg)

  非同期でサービス操作を呼び出します。メソッドは、操作呼び出しへのレスポンスを待たずに戻ります。操作の結果は、返された Response をポーリングすることによって取得されます。

  クライアントは、マーシャリング時に msg オブジェクトが、使用中のプロトコルバインディングの要件に従って形成されていることを確認する責任があります。

  パラメーター:

  msg - 操作を呼び出すために使用されるメッセージまたはメッセージのペイロードを形成するオブジェクト。

  戻り値:

  操作呼び出しに対するレスポンスメッセージまたはメッセージペイロード。

  例外:

  WebServiceException - Dispatch インスタンスの構成にエラーがある場合

• invokeAsync

  FutureSE<?> 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 インスタンスの構成にエラーがある場合、または呼び出し中にエラーが発生した場合。