org.omg.CORBA.portable

インタフェース InvokeHandler

既知のすべてのサブインタフェース:

Tie

既知のすべての実装クラス:

BindingIteratorPOA, NamingContextExtPOA, NamingContextPOA, ServantActivatorPOA, ServantLocatorPOA

public interface InvokeHandler

このインタフェースは、着信呼び出しのディスパッチメカニズムを提供します。要求をサーバントにディスパッチするために、ORB によって呼び出されます。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
OutputStream	_invoke(String method, InputStream input, ResponseHandler handler) 要求をサーバントにディスパッチするために、ORB によって呼び出されます。

メソッドの詳細

_invoke

OutputStream _invoke(String method,
                   InputStream input,
                   ResponseHandler handler)
                     throws SystemException

要求をサーバントにディスパッチするために、ORB によって呼び出されます。 ORB は、メソッド名、整列化された引数が格納されている InputStream、および適切な応答を構築するためにサーバントが使用する ResponseHandler を渡します。 このメソッドでは CORBA SystemException 例外だけがスローされます。 このメソッドは、整列化された応答を格納する ResponseHandler によって作成される OutputStream を返す必要があります。 サーバントは、メソッド呼び出しの有効期間内に ResponseHandler への参照を保持する必要があります。 サーバントの動作は、次のように定義されます。

1. 正しいメソッドを定義し、InputStream からのパラメータを非整列化する。

2. メソッド実装を呼び出す。

3. ユーザー例外がない場合、ResponseHandler を使用して通常の応答を作成する。

4. ユーザー例外が発生した場合、ResponseHandler を使用して例外応答を作成する。

5. ResponseHandler によって返された OutputStream に応答を整列化する。

6. OutputStream を ORB へ返す。

パラメータ:

method - メソッド名。

input - 整列化された引数を格納する InputStream。

handler - 適切な応答を構築するためにサーバントが使用する ResponseHandler

戻り値:

整列化された応答を格納する ResponseHandler により作成された OutputStream

例外:

SystemException - CORBA システム例外のために呼び出しが失敗した場合。