JavaTM Platform
Standard Ed. 6

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 が呼び出される原因となった要求を処理するためのサーバントを取得する場合に使用されます。

定義:
インタフェース ServantLocatorOperations 内の preinvoke
パラメータ:
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)
このオペレーションは、サーバントが要求を完了したときに必ず呼び出されます。

定義:
インタフェース ServantLocatorOperations 内の postinvoke
パラメータ:
oid - 要求の対象となったオブジェクトに関連付けられた オブジェクト ID
adapter - オブジェクトがアクティブになっていた POA のオブジェクト参照
the_cookie - preinvoke によって設定された データを含む不透明な値
the_servant - オブジェクトに関連付けられる サーバントへの参照

_ids

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

定義:
クラス ObjectImpl 内の _ids
戻り値:
この ObjectImpl のインスタンスがサポートするすべての リポジトリ識別子の配列

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。