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 - オブジェクトに関連付けられるサーバントへの参照。