org.omg.PortableServer

クラス _ServantLocatorStub

java.lang.Object

org.omg.CORBA.portable.ObjectImpl

org.omg.PortableServer._ServantLocatorStub

すべての実装されたインタフェース:

Serializable, Object, IDLEntity, ServantLocator, ServantLocatorOperations, ServantManager, ServantManagerOperations

public class _ServantLocatorStub
extends ObjectImpl
implements ServantLocator

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

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static Class	_opsClass

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
_ServantLocatorStub()

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
String[]	_ids() この ObjectImpl オブジェクトがサポートするリポジトリ識別子を含む文字列配列を取得します。
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 が呼び出される原因となった要求を処理するためのサーバントを取得する場合に使用されます。

クラス org.omg.CORBA.portable.ObjectImpl から継承されたメソッド

_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, hashCode, toString

クラス java.lang.Object から継承されたメソッド

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

インタフェース org.omg.CORBA.Object から継承されたメソッド

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

フィールドの詳細

_opsClass

public static final Class _opsClass

コンストラクタの詳細

_ServantLocatorStub

public _ServantLocatorStub()

メソッドの詳細

preinvoke

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

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

定義:

preinvoke、インタフェース: ServantLocatorOperations

パラメータ:

oid - リクエストの対象となったオブジェクトに関連付けられたオブジェクト ID。

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

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

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

戻り値:

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

例外:

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

postinvoke

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

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

定義:

postinvoke、インタフェース: ServantLocatorOperations

パラメータ:

oid - リクエストの対象となったオブジェクトに関連付けられたオブジェクト ID。

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

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

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

_ids

public String[] _ids()

次のクラスからコピーされた説明: ObjectImpl

この ObjectImpl オブジェクトがサポートするリポジトリ識別子を含む文字列配列を取得します。たとえばスタブの場合、このメソッドはスタブがサポートするすべてのインタフェースに関する情報を返します。

定義:

_ids、クラス: ObjectImpl

戻り値:

この ObjectImpl のインスタンスがサポートするすべてのリポジトリ識別子の配列