POAOperations (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

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

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

public interface POAOperations

POA オブジェクトは、オブジェクトのコレクションの実装を管理します。POA は、オブジェクト ID によって識別されるオブジェクトの名前空間をサポートします。また、POA の名前空間も提供します。POA は既存の POA の子として作成され、それによってルート POA で始まる階層が形成されます。POA オブジェクトは、他のプロセスにエクスポートしたり、ORB::object_to_string を使用して外部化したりしないでください。

メソッドの概要
`void`	`activate_object_with_id(byte[] id, Servant p_servant)` このオペレーションは、指定されたオブジェクト ID と指定されたサーバントとの関連付けを Active Object Map に入れます。
`byte[]`	`activate_object(Servant p_servant)` このオペレーションは、オブジェクト ID を生成し、そのオブジェクト ID と指定されたサーバントを Active Object Map に入れます。
`IdAssignmentPolicy`	`create_id_assignment_policy(IdAssignmentPolicyValue value)` これらのオペレーションはそれぞれ、指定された値を持つポリシーオブジェクトへの参照を返します。
`IdUniquenessPolicy`	`create_id_uniqueness_policy(IdUniquenessPolicyValue value)` これらのオペレーションはそれぞれ、指定された値を持つポリシーオブジェクトへの参照を返します。
`ImplicitActivationPolicy`	`create_implicit_activation_policy(ImplicitActivationPolicyValue value)` これらのオペレーションはそれぞれ、指定された値を持つポリシーオブジェクトへの参照を返します。
`LifespanPolicy`	`create_lifespan_policy(LifespanPolicyValue value)` これらのオペレーションはそれぞれ、指定された値を持つポリシーオブジェクトへの参照を返します。
`POA`	`create_POA(String adapter_name, POAManager a_POAManager, Policy[] policies)` このオペレーションは、新しい POA をターゲット POA の子として作成します。
`Object`	`create_reference_with_id(byte[] oid, String intf)` この操作は、指定されたオブジェクト ID とインタフェースリポジトリ ID の値をカプセル化するオブジェクト参照を作成します。
`Object`	`create_reference(String intf)` このオペレーションは、POA によって生成されたオブジェクト ID 値と指定されたインタフェースリポジトリ ID をカプセル化するオブジェクト参照を作成します。
`RequestProcessingPolicy`	`create_request_processing_policy(RequestProcessingPolicyValue value)` これらのオペレーションはそれぞれ、指定された値を持つポリシーオブジェクトへの参照を返します。
`ServantRetentionPolicy`	`create_servant_retention_policy(ServantRetentionPolicyValue value)` これらのオペレーションはそれぞれ、指定された値を持つポリシーオブジェクトへの参照を返します。
`ThreadPolicy`	`create_thread_policy(ThreadPolicyValue value)` これらのオペレーションはそれぞれ、指定された値を持つポリシーオブジェクトへの参照を返します。
`void`	`deactivate_object(byte[] oid)` この操作によって、oid パラメータに指定された ObjectId が終了します。
`void`	`destroy(boolean etherealize_objects, boolean wait_for_completion)` この操作は、POA とその下位 POA をすべて破棄します。
`POA`	`find_POA(String adapter_name, boolean activate_it)` ターゲット POA が指定された名前 (ターゲット POA を基準にしている) を持つ子 POA の親である場合は、その子 POA が返されます。
`ServantManager`	`get_servant_manager()` POA の ServantRetentionPolicy が RETAIN の場合、ServantManager 引数 (imgr) は ServantActivator インタフェースをサポートします。
`Servant`	`get_servant()` このオペレーションは、POA に関連付けられたデフォルトのサーバントを返します。
`Object`	`id_to_reference(byte[] oid)` 指定されたオブジェクト ID を持つオブジェクトが現在アクティブになっている場合は、そのオブジェクトを起動するための情報をカプセル化しているオブジェクト参照が返されます。
`Servant`	`id_to_servant(byte[] oid)` POA に RETAIN ポリシーが設定されていて、指定された ObjectId が Active Object Map に含まれている場合は、Active Object Map 内の当該オブジェクトに関連付けられたサーバントを返します。
`byte[]`	`id()` POA が作成される過程で、POA の一意の ID を返します。
`byte[]`	`reference_to_id(Object reference)` この操作は、指定されたオブジェクト参照によってカプセル化されたオブジェクト ID 値を返します。
`Servant`	`reference_to_servant(Object reference)` POA に RETAIN ポリシーが設定されていて、指定されたオブジェクトが Active Object Map に含まれている場合は、Active Object Map 内の当該オブジェクトに関連付けられたサーバントを返します。
`byte[]`	`servant_to_id(Servant p_servant)` この操作には、次の 4 つの動作が考えられます。
`Object`	`servant_to_reference(Servant p_servant)` この POA によって操作がディスパッチされるとき以外にこの操作が呼び出される場合は、RETAIN ポリシーと、UNIQUE_ID または IMPLICIT_ACTIVATION ポリシーのどちらかが必要となります。
`void`	`set_servant_manager(ServantManager imgr)` この操作は、POA に関連付けられたデフォルトのサーバントマネージャーを設定します。
`void`	`set_servant(Servant p_servant)` この操作は、指定されたサーバントをデフォルトのサーバントとして POA に登録します。
`AdapterActivator`	`the_activator()` この属性は、POA に関連付けられたアダプタアクティベータを識別します。
`void`	`the_activator(AdapterActivator newThe_activator)` この属性は、POA に関連付けられたアダプタアクティベータを識別します。
`POA[]`	`the_children()` この属性は、POA のすべての子 POA から成る現在の子 POA のセットを識別します。
`String`	`the_name()` この属性は、POA を、その親を基準にして識別します。
`POA`	`the_parent()` この属性は、POA の親を識別します。
`POAManager`	`the_POAManager()` この属性は、POA に関連付けられた POA マネージャーを識別します。

メソッドの詳細

create_POA

POA create_POA(String adapter_name,
               POAManager a_POAManager,
               Policy[] policies)
               throws AdapterAlreadyExists,
                      InvalidPolicy

このオペレーションは、新しい POA をターゲット POA の子として作成します。

パラメータ:: adapter_name - 同じ親 POA を持つ他の POA を基準にして新しい POA を識別する; a_POAManager - 新しい POA に関連付けられる POA マネージャーを示す; policies - POA に関連付けて、その動作を制御するためのポリシーオブジェクトを示す
例外:: AdapterAlreadyExists - ターゲット POA が指定された名前を持つ子 POA をすでに保有していることを示す; InvalidPolicy - ポリシーオブジェクトのどれかが ORB に有効でないか、競合しているか、実行されていない管理アクションを必要としている場合にスローされる

find_POA

POA find_POA(String adapter_name,
             boolean activate_it)
             throws AdapterNonExistent

ターゲット POA が指定された名前 (ターゲット POA を基準にしている) を持つ子 POA の親である場合は、その子 POA が返されます。

パラメータ:: adapter_name - 検索対象の POA 名; activate_it - 指定された名前を持つ POA が存在しないときに、activate_it パラメータの値が TRUE である場合は、ターゲット POA の AdapterActivator (存在する場合) が呼び出される
戻り値:: POA が存在するか、AdapterActivator によって起動されている場合はその POA
例外:: AdapterNonExistent

destroy

void destroy(boolean etherealize_objects,
             boolean wait_for_completion)

この操作は、POA とその下位 POA をすべて破棄します。下位 POA がすべて破棄されてから (再帰的に)、それらを包含していた POA が破棄されます。そのようにして破棄された POA (つまり、その名前を持つ POA) は、同じプロセス内にあとで再作成できます。

パラメータ:: etherealize_objects - サーバントマネージャーに対する etherealize オペレーションを呼び出す必要があるかどうかを示すフラグ; wait_for_completion - POA とその子 POA が起動要求と霊化 (etherealization) が完了するまで待機する必要があるかどうかを示すフラグ