javax.xml.ws.spi

クラス Invoker

java.lang.Object

javax.xml.ws.spi.Invoker

public abstract class Invoker
extends Object

Invoker は、アプリケーション終端実装への呼び出しの詳細を非表示にします。コンテナは Invoker の実装を JAX-WS ランタイムに渡し、JAX-WS ランタイムは invoke(java.lang.reflect.Method, java.lang.Object...) を呼び出して Web サービスを呼び出します。最終的には、Invoker は端点インスタンス上で Web サービスの実際の呼び出しを行います。 また、コンテナは、提供された WebServiceContext を注入し、javax.annotation.PostConstruct があればそれを終端実装で呼び出します。

導入されたバージョン:

JAX-WS 2.2

関連項目:

Provider.createEndpoint(String, Class, Invoker, WebServiceFeature...)

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
Invoker()

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract void	inject(WebServiceContext webServiceContext) JAX-WS ランタイムはこのメソッドを呼び出すことで、端点インスタンスに WebServiceContext を注入するようコンテナに要求します。
abstract Object	invoke(Method m, Object... args) JAX-WS ランタイムはこのメソッドを呼び出すことで、端点インスタンスで実際の Web サービス呼び出しを行います。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

Invoker

public Invoker()

メソッドの詳細

inject

public abstract void inject(WebServiceContext webServiceContext)
                     throws IllegalAccessException,
                            IllegalArgumentException,
                            InvocationTargetException

JAX-WS ランタイムはこのメソッドを呼び出すことで、端点インスタンスに WebServiceContext を注入するようコンテナに要求します。WebServiceContext オブジェクトは、要求に対応するために同時使用されているスレッドの数に関係なく、スレッドローカル情報を使用し、実際の端点の呼び出し中に正しい情報を返します。

パラメータ:

webServiceContext - MessageContext のホルダー

例外:

IllegalAccessException - リフレクション API によって実行された注入でこの例外がスローされる場合

IllegalArgumentException - リフレクション API によって実行された注入でこの例外がスローされる場合

InvocationTargetException - リフレクション API によって実行された注入でこの例外がスローされる場合

invoke

public abstract Object invoke(Method m,
            Object... args)
                       throws IllegalAccessException,
                              IllegalArgumentException,
                              InvocationTargetException

JAX-WS ランタイムはこのメソッドを呼び出すことで、端点インスタンスで実際の Web サービス呼び出しを行います。注入された WebServiceContext.getMessageContext() によって、この呼び出しに対して正しい情報が提供されます。

パラメータ:

m - サービスで呼び出されるメソッド

args - メソッド引数

戻り値:

メソッドの戻り値

例外:

IllegalAccessException - リフレクション API によって実行された呼び出しでこの例外がスローされる場合

IllegalArgumentException - リフレクション API によって実行された呼び出しでこの例外がスローされる場合

InvocationTargetException - リフレクション API によって実行された呼び出しでこの例外がスローされる場合

関連項目:

Method.invoke(java.lang.Object, java.lang.Object...)