4.13.2 PortableServer.ServantLocatorのメソッド
-
org.omg.PortableServer.Servant preinvoke(
byte[ ] oid,
org.omg.PortableServer.POA adapter,
String operation,
org.omg.PortableServer.ServantLocatorPackage.CookieHolder
the_cookie)
throws
ForwardRequest
このメソッドは,POAが現在アクティブの状態にないオブジェクトへのリクエストを受け取ったときに呼び出されます。このメソッドは,NON_RETAINポリシーとUSE_SERVANT_MANAGERポリシーがあることを前提とします。
可能な場合,ユーザが提供するサーバントマネージャは,oidに指定したオブジェクトに対応する適切なサーバントを探索・作成する必要があります。
また,このメソッドではForwardRequest例外を発生させることができます。ForwardRequest例外については,「4.15 PortableServer.ForwardRequest」を参照してください。
-
oid
到着したリクエストに対応するオブジェクトID
-
adapter
オブジェクトを活性化するPOA
-
operation
サーバントが返されるときにPOAが呼び出すオペレーションの名前
-
the_cookie
サーバントマネージャがあとでpostinvokeメソッドに設定して使用できる不特定の値
-
-
byte[ ] oid,
org.omg.PortableServer.POA adapter,
String operation,
Object the_cookie,
org.omg.PortableServer.Servant the_servant)
このメソッドは,サーバントがリクエストの実行を完了するときに呼び出されます。このメソッドは,POAにNON_RETAINポリシーとUSE_SERVANT_MANAGERポリシーがあることを前提とします。このメソッドは,オブジェクトに対するリクエストの一部とみなされます。つまり,このメソッドが正常終了したのにpostinvokeメソッドがシステム例外を出力した場合は,このメソッドの正常リターンは無効となり,リクエストは例外を発生して終了します。
POAが認識しているサーバントをデストラクトした場合,結果は不定です。
-
oid
到着したリクエストに対応するオブジェクトID
-
adapter
オブジェクトを活性化するPOA
-
operation
サーバントが返されるときにPOAが呼び出すオペレーションの名前
-
the_cookie
サーバントマネージャがpreinvokeメソッドに設定して使用できる不特定の値
-
the_servant
オブジェクトに対応するサーバント
-