org.omg.PortableServer
インタフェース ServantLocatorOperations

すべてのスーパーインタフェース:

ServantManagerOperations

既知のサブインタフェースの一覧:

ServantLocator

既知の実装クラスの一覧:

_ServantLocatorStub, ServantLocatorPOA

public interface ServantLocatorOperations
extends ServantManagerOperations

POA に NON_RETAIN ポリシーが指定されているときは、サーバントマネージャーとして ServantLocator が使用されます。POA はこのサーバントマネージャーが返すサーバントが 1 つの要求だけに使用されることを認識しているため、サーバントマネージャーのオペレーションに補足情報を提供でき、サーバントマネージャーのオペレーションのペアは連携して ServantActivator とは異なる処理を実行できる場合があります。POA が preinvoke によって返されたサーバントに対するオペレーション呼び出しを実行した直後に ServantLocator インタフェースを使用したときは、そのサーバントに対して postinvoke を呼び出し、特に ObjectId 値と Servant 値をパラメータとして渡します。この機能を使用すると、POA に関連付けられているオブジェクトに対するすべての要求を確実にサーバントマネージャーで調整できます。

メソッドの概要

void	postinvoke(byte[] oid, POA adapter, String operation, Object the_cookie, Servant the_servant) このオペレーションは、サーバントが要求を完了したときに必ず呼び出されます。
Servant	preinvoke(byte[] oid, POA adapter, String operation, CookieHolder the_cookie) このオペレーションは、preinvoke が呼び出される原因となった要求を処理するためのサーバントを取得する場合に使用されます。

メソッドの詳細

preinvoke

Servant preinvoke(byte[] oid,
                  POA adapter,
                  String operation,
                  CookieHolder the_cookie)
                  throws ForwardRequest

このオペレーションは、preinvoke が呼び出される原因となった要求を処理するためのサーバントを取得する場合に使用されます。

パラメータ:

oid - 要求の対象となったオブジェクトに関連付けられた オブジェクト ID

adapter - オブジェクトが起動される POA のオブジェクト参照

operation - オペレーションの名前

the_cookie - postinvoke の呼び出し時に使用される サーバントマネージャーによって設定できる 不透明な値

戻り値:

着信要求を処理するためのサーバント

例外:

ForwardRequest - 現在の要求と それに続く要求をその例外の forward_reference メンバーに示された オブジェクトに配信する責任があることを ORB に通知する

postinvoke

void postinvoke(byte[] oid,
                POA adapter,
                String operation,
                Object the_cookie,
                Servant the_servant)

このオペレーションは、サーバントが要求を完了したときに必ず呼び出されます。

パラメータ:

oid - 要求の対象となったオブジェクトに関連付けられた オブジェクト ID

adapter - オブジェクトがアクティブになっていた POA のオブジェクト参照

the_cookie - preinvoke によって設定された データを含む不透明な値

the_servant - オブジェクトに関連付けられる サーバントへの参照