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システム例外のために呼出しが失敗した場合。