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, 2014, Oracle and/or its affiliates. All rights reserved.