Java org.omg.PortableServer 接口 POAOperations（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

org.omg.PortableServer
接口 POAOperations

所有已知子接口：

POA

---

public interface POAOperations

POA 对象管理对象集合的实现。POA 支持由 Object Id 标识的对象的名称空间。POA 也支持 POA 的名称空间。POA 都是作为现有 POA 的子 POA 创建的，这形成了始于根 POA 的分层结构。POA 对象不得输出到其他进程，也不得使用 ORB::object_to_string 具体化。

---

方法摘要
void	activate_object_with_id(byte[] id, Servant p_servant)           此操作将指定 Object Id 与指定 servant 之间的关联输入 Active Object Map。
byte[]	activate_object(Servant p_servant)           此操作生成一个 Object Id，并将该 Object Id 和指定的 servant 输入 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 的子 POA。
Object	create_reference_with_id(byte[] oid, String intf)           此操作创建一个对象引用，该引用封装指定的 Object Id 和接口存储库 Id 值。
Object	create_reference(String intf)           此操作创建一个对象引用，该引用封装 POA 生成的 Object 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，则返回该子 POA。
ServantManager	get_servant_manager()           如果 POA 的 ServantRetentionPolicy 为 RETAIN，则 ServantManager 参数 (imgr) 应该支持 ServantActivator 接口。
Servant	get_servant()           此操作返回与 POA 关联的默认 servant。
Object	id_to_reference(byte[] oid)           如果具有指定 Object Id 值的对象当前不是激活状态，则返回一个封装激活该对象时所用信息的引用。
Servant	id_to_servant(byte[] oid)           如果 POA 具有 RETAIN 策略并且指定的 ObjectId 存在于 Active Object Map 中，则此操作返回与 Active Object Map 中该对象关联的 servant。
byte[]	id()           此操作在 POA 的创建过程中返回该 POA 的唯一 id。
byte[]	reference_to_id(Object reference)           此操作返回指定引用封装的 Object Id 值。
Servant	reference_to_servant(Object reference)           如果 POA 具有 RETAIN 策略并且指定的对象存在于 Active Object Map 中，则此操作返回与 Active Object Map 中该对象关联的 servant。
byte[]	servant_to_id(Servant p_servant)           此操作有四种可能的行为。
Object	servant_to_reference(Servant p_servant)           如果在此 POA 指派的操作的上下文外调用此操作，则需要 RETAIN 策略以及 UNIQUE_ID 或 IMPLICIT_ACTIVATION 策略之一。
void	set_servant_manager(ServantManager imgr)           此操作设置与 POA 关联的默认 servant 管理器。
void	set_servant(Servant p_servant)           此操作在 POA 中将指定的 servant 注册为默认 servant。
AdapterActivator	the_activator()           此属性标识与 POA 关联的适配器激活器。
void	the_activator(AdapterActivator newThe_activator)           此属性标识与 POA 关联的适配器激活器。
POA[]	the_children()           此属性标识 POA 的所有子 POA 的当前设置。
String	the_name()           此属性标识相对于其父 POA 的 POA。
POA	the_parent()           此属性标识 POA 的父 POA。
POAManager	the_POAManager()           此属性标识与 POA 关联的 POA 管理器。

 

方法详细信息

create_POA

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

此操作创建一个新的 POA 作为目标 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，则返回该子 POA。

参数：

adapter_name - 要查找的 POA 名称。

activate_it - 如果不存在具有指定名称的 POA，且 activate_it 参数的值为 TRUE，则将调用目标 POA 的 AdapterActivator（如果有）。

返回：

POA，如果有或由 AdapterActivator 激活。

抛出：

AdapterNonExistent

---

destroy

void destroy(boolean etherealize_objects,
             boolean wait_for_completion)

此操作销毁 POA 及所有子代 POA。在销毁包含子代的 POA 前销毁（以递归形式）所有子代 POA。以此方式销毁的 POA（即具有其名称的 POA）以后可通过相同的过程重新创建。

参数：

etherealize_objects - 指示是否需要对 servant 管理器调用 etherealize 操作的标记。

wait_for_completion - 一个标记，指示 POA 及其子 POA 是否需要等待激活的请求和 etherealization 操作完成。

---

create_thread_policy

ThreadPolicy create_thread_policy(ThreadPolicyValue value)

每个这种操作都返回一个对具有指定值的策略对象的引用。

参数：

value - 策略类型

返回：

ThreadPolcy 对象

---

create_lifespan_policy

LifespanPolicy create_lifespan_policy(LifespanPolicyValue value)

每个这类操作都返回一个对具有指定值的策略对象的引用。

参数：

value - 策略类型

返回：

LifespanPolicy 对象

---

create_id_uniqueness_policy

IdUniquenessPolicy create_id_uniqueness_policy(IdUniquenessPolicyValue value)

每个这类操作都返回一个对具有指定值的策略对象的引用。

参数：

value - 策略类型

返回：

IdUniquenessPolicy 对象

---

create_id_assignment_policy

IdAssignmentPolicy create_id_assignment_policy(IdAssignmentPolicyValue value)

每个这类操作都返回一个对具有指定值的策略对象的引用。

参数：

value - 策略类型

返回：

IdAssignmentPolicy 对象