public interface POAOperations
修飾子と型 | メソッドと説明 |
---|---|
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
- 起動するオブジェクトのオブジェクト ID。p_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 を作成するためのリポジトリ IDBAD_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_POLICY の場合) 場合。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 が一意になります。
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.