|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
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 マネージャーを識別します。 |
メソッドの詳細 |
---|
POA create_POA(String adapter_name, POAManager a_POAManager, Policy[] policies) throws AdapterAlreadyExists, InvalidPolicy
adapter_name
- 同じ親 POA を持つ他の POA を 基準にして新しい POA を識別するa_POAManager
- 新しい POA に関連付けられる POA マネージャーを示すpolicies
- POA に関連付けて、その動作を 制御するためのポリシーオブジェクトを示す
AdapterAlreadyExists
- ターゲット POA が 指定された名前を持つ子 POA をすでに 保有していることを示す
InvalidPolicy
- ポリシーオブジェクトの どれかが ORB に有効でないか、 競合しているか、実行されていない 管理アクションを必要としている場合に スローされるPOA find_POA(String adapter_name, boolean activate_it) throws AdapterNonExistent
adapter_name
- 検索対象の POA 名activate_it
- 指定された名前を持つ POA が 存在しないときに、activate_it パラメータの値が TRUE である場合は、ターゲット POA の AdapterActivator (存在する場合) が 呼び出される
AdapterNonExistent
void destroy(boolean etherealize_objects, boolean wait_for_completion)
etherealize_objects
- サーバントマネージャーに対する etherealize オペレーションを呼び出す必要があるかどうかを 示すフラグwait_for_completion
- POA とその子 POA が 起動要求と霊化 (etherealization) が完了するまで 待機する必要があるかどうかを示すフラグThreadPolicy create_thread_policy(ThreadPolicyValue value)
value
- ポリシー型
LifespanPolicy create_lifespan_policy(LifespanPolicyValue value)
value
- ポリシー型
IdUniquenessPolicy create_id_uniqueness_policy(IdUniquenessPolicyValue value)
value
- ポリシー型
IdAssignmentPolicy create_id_assignment_policy(IdAssignmentPolicyValue value)
value
- ポリシー型
ImplicitActivationPolicy create_implicit_activation_policy(ImplicitActivationPolicyValue value)
value
- ポリシー型
ServantRetentionPolicy create_servant_retention_policy(ServantRetentionPolicyValue value)
value
- ポリシー型
RequestProcessingPolicy create_request_processing_policy(RequestProcessingPolicyValue value)
value
- ポリシー型
String the_name()
POA the_parent()
POA[] the_children()
POAManager the_POAManager()
AdapterActivator the_activator()
void the_activator(AdapterActivator newThe_activator)
ServantManager get_servant_manager() throws WrongPolicy
WrongPolicy
- USE_SERVANT_MANAGER ポリシーが 指定されていない場合にスローされるvoid set_servant_manager(ServantManager imgr) throws WrongPolicy
imgr
- デフォルトとして使用されるサーバントマネージャー
WrongPolicy
- USE_SERVANT_MANAGER ポリシーが 指定されていない場合にスローされるServant get_servant() throws NoServant, WrongPolicy
NoServant
- POA に関連付けられたデフォルトの サーバントがない場合にスローされる
WrongPolicy
- USE_DEFAULT_SERVANT ポリシーが ポリシーが指定されていない場合にスローされるvoid set_servant(Servant p_servant) throws WrongPolicy
p_servant
- デフォルトとして使用されるサーバント
WrongPolicy
- USE_DEFAULT_SERVANT ポリシーが ポリシーが指定されていない場合にスローされるbyte[] activate_object(Servant p_servant) throws ServantAlreadyActive, WrongPolicy
p_servant
- 起動するオブジェクトに 関連付けられるサーバント
ServantAlreadyActive
- POA に UNIQUE_ID ポリシーが指定されているときに、 サーバントが Active Object Map にすでに 格納されている場合にスローされる
WrongPolicy
- SYSTEM_ID と RETAIN ポリシーが 指定されていない場合にスローされるvoid activate_object_with_id(byte[] id, Servant p_servant) throws ServantAlreadyActive, ObjectAlreadyActive, WrongPolicy
id
- 起動するオブジェクトのオブジェクト IDp_servant
- オブジェクトに関連付けられる サーバント
ServantAlreadyActive
- POA に UNIQUE_ID ポリシーが指定されているときに、 サーバントが Active Object Map にすでに 格納されている場合にスローされる
ObjectAlreadyActive
- オブジェクトが POA 内ですでに アクティブになっている場合にスローされる
WrongPolicy
- RETAIN ポリシーが指定されて いない場合にスローされるvoid deactivate_object(byte[] oid) throws ObjectNotActive, WrongPolicy
oid
- 終了するオブジェクトのオブジェクト ID
ObjectNotActive
- 指定された oid を 持つオブジェクトが Active Object Map にない 場合
WrongPolicy
- RETAIN ポリシーが指定されて いない場合にスローされるObject create_reference(String intf) throws WrongPolicy
intf
- オブジェクト参照を作成するためのリポジトリ ID
WrongPolicy
- SYSTEM_ID ポリシーが指定されて いない場合Object create_reference_with_id(byte[] oid, String intf)
oid
- objref を作成するためのオブジェクト IDintf
- objref を作成するためのリポジトリ ID
BAD_PARAM
- POA に SYSTEM_ID ポリシーが 指定されているときに、システムによって またはこの POA に対してオブジェクト ID 値が 生成されなかった場合にスローされるbyte[] servant_to_id(Servant p_servant) throws ServantNotActive, WrongPolicy
p_servant
- オブジェクト ID が返されるサーバント
ServantNotActive
- 上記の規則とポリシーの 組み合わせが満たされない場合
WrongPolicy
- USE_DEFAULT_SERVANT ポリシーが指定されていない場合、 あるいは RETAIN ポリシーと、 UNIQUE_ID または IMPLICIT_ACTIVATION ポリシーの 組み合わせが指定されていない場合Object servant_to_reference(Servant p_servant) throws ServantNotActive, WrongPolicy
p_servant
- オブジェクト参照を取得する 必要があるサーバント
WrongPolicy
- 指定されたサーバントに対する要求を 実行しているとき以外にこのオペレーションが 呼び出されるときに、必要なポリシーが 指定されていない場合
ServantNotActive
- 上記のポリシーと規則が 満たされない場合Servant reference_to_servant(Object reference) throws ObjectNotActive, WrongPolicy, WrongAdapter
reference
- サーバントが返される オブジェクト参照
WrongPolicy
- RETAIN ポリシーと USE_DEFAULT_SERVANT ポリシーの どちらも指定されていない場合
ObjectNotActive
- サーバントが Active Object Map に 存在しないか (RETAIN の場合)、 デフォルトのサーバントが登録されていない (USE_DEFAULT_SERVANT の場合) 場合
WrongAdapter
- この POA インスタンスによって オブジェクト参照が作成されなかった場合byte[] reference_to_id(Object reference) throws WrongAdapter, WrongPolicy
reference
- オブジェクト ID が返される 必要のあるオブジェクト参照
WrongAdapter
- オブジェクト参照が そこに指定された POA によって 作成されなかった場合
WrongPolicy
- 今後の機能拡張に備えて 宣言されているServant id_to_servant(byte[] oid) throws ObjectNotActive, WrongPolicy
oid
- サーバントが返される オブジェクト ID
ObjectNotActive
- ObjectId が Active Object Map に 存在しないか (RETAIN ポリシーの場合)、 デフォルトのサーバントが登録されていない (USE_DEFAULT_SERVANT ポリシーの場合) 場合
WrongPolicy
- RETAIN ポリシーと USE_DEFAULT_SERVANT ポリシーの どちらも指定されていない場合Object id_to_reference(byte[] oid) throws ObjectNotActive, WrongPolicy
oid
- オブジェクト参照が返される オブジェクトの ID
ObjectNotActive
- オブジェクト ID 値が POA で アクティブになっていない場合
WrongPolicy
- RETAIN ポリシーが ない場合byte[] id()
この ID は、そのプロセスにおける POA の有効期間に対して一意であることが保証されています。持続的な POA の場合、別の POA と同じ名前で同じパスに作成された POA は同一であるため、ID も同じになります。 一時的な POA の場合、それぞれの POA が一意になります。
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。