POAOperations (Java Platform SE 8 )

All Known Subinterfaces:

POA
```
public interface POAOperations
```
POA对象管理对象集合的实现。POA支持对象的名称空间，这是由对象的ID标识。波阿斯POA还提供一个名称空间。POA是创建为一个现有的早熟的孩子，形成一个层次从根POA。POA对象不能被出口到其他进程，或与外在的球体：object_to_string。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`void`	`activate_object_with_id(byte[] id, Servant p_servant)` 该操作在活动对象映射中输入指定对象标识和指定的服务之间的关联关系。
`byte[]`	`activate_object(Servant p_servant)` 此操作生成一个对象的身份证，并在活动对象映射中输入对象标识和指定的仆人。
`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为目标的早熟的孩子。
`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)` 这一操作导致objectid指定OID参数被停用。
`void`	`destroy(boolean etherealize_objects, boolean wait_for_completion)` 这个手术破坏了POA和所有后代POAs。
`POA`	`find_POA(String adapter_name, boolean activate_it)` 如果目标POA是具有指定名称的一个孩子早熟亲本（相对于目标POA），那孩子早熟返回。
`ServantManager`	`get_servant_manager()` 如果ServantRetentionPolicy是POA的保留，然后servantmanager论点（imgr）应当支持servantactivator接口。
`Servant`	`get_servant()` 该操作返回的POA关联的默认的仆人。
`Object`	`id_to_reference(byte[] oid)` 如果当前活动的对象具有指定的对象标识值，则返回用于激活该对象的信息的引用被返回。
`Servant`	`id_to_servant(byte[] oid)` 如果早熟有保留政策和指定objectid是主动对象图，该操作返回，活动对象图对象关联的仆人。
`byte[]`	`id()` 这将返回POA的独特身份的过程中，它创造了。
`byte[]`	`reference_to_id(Object reference)` 此操作返回由指定的引用封装的对象标识值。
`Servant`	`reference_to_servant(Object reference)` 如果早熟有保留政策和指定的对象是主动对象映射，该操作返回，活动对象图对象关联的仆人。
`byte[]`	`servant_to_id(Servant p_servant)` 此操作有四种可能的行为。
`Object`	`servant_to_reference(Servant p_servant)` 此操作要求保持政策的unique_id或implicit_activation政策如果调用一个操作被这个早熟的上下文之外。
`void`	`set_servant_manager(ServantManager imgr)` 此操作设置与POA关联的默认服务经理。
`void`	`set_servant(Servant p_servant)` 此操作寄存器指定的仆人与早熟禾作为默认的仆人。
`AdapterActivator`	`the_activator()` 这个属性标识的POA关联的适配器激活。
`void`	`the_activator(AdapterActivator newThe_activator)` 这个属性标识的POA关联的适配器激活。
`POA[]`	`the_children()` 此属性确定的早熟儿童POAs的当前设置。
`String`	`the_name()` 这个属性标识POA相对于它的父。
`POA`	`the_parent()` 这个属性标识的早熟亲本。
`POAManager`	`the_POAManager()` 这个属性标识与早熟有关的POA经理。

- 方法详细信息
  - create_POA
```
POA create_POA(String adapter_name,
               POAManager a_POAManager,
               Policy[] policies)
        throws AdapterAlreadyExists,
               InvalidPolicy
```
    此操作将创建一个新的POA为目标的早熟的孩子。
    
    参数
    
    adapter_name识别新的POA相对于其他波阿斯同母POA。
    
    a_POAManager -指定要与新的POA相关POA经理。
    
    policies -指定政策目标要与POA相关控制其行为。
    
    异常
    
    AdapterAlreadyExists -指定目标的行动纲领已经有了一个孩子的早熟与指定名称。
    
    InvalidPolicy -如果有任何的政策对象不是有效的ORB复活，或是冲突的，或要求行政行为没有实施。
  - find_POA
```
POA find_POA(String adapter_name,
             boolean activate_it)
      throws AdapterNonExistent
```
    如果目标POA是具有指定名称的一个孩子早熟亲本（相对于目标POA），那孩子早熟返回。
    
    参数
    
    adapter_name - POA的名字被发现。
    
    activate_it如果早熟与指定的名称不存在的activate_it参数的值为true，目标POA的adapteractivator，如果存在的话，则调用。
    
    结果
    
    POA如果存在或被adapteractivator活性。
    
    异常
    
    AdapterNonExistent
  - destroy
```
void destroy(boolean etherealize_objects,
             boolean wait_for_completion)
```
    这个手术破坏了POA和所有后代POAs。所有的后代波阿斯被毁（递归）在含有POA的破坏。POA如此破坏（即POA的名字）可以重新创建相同的过程后。
    
    参数
    
    etherealize_objects国旗表明是否对仆人经理气化运行需要调用。
    
    wait_for_completion国旗表明POA和它的孩子需要等待主动请求和气化来完成。
  - 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对象。
  - create_implicit_activation_policy
```
ImplicitActivationPolicy create_implicit_activation_policy(ImplicitActivationPolicyValue value)
```
    这些操作每个返回一个引用到具有指定值的策略对象。
    
    参数
    
    value政策类型
    
    结果
    
    implicitactivationpolicy对象。
  - create_servant_retention_policy
```
ServantRetentionPolicy create_servant_retention_policy(ServantRetentionPolicyValue value)
```
    这些操作每个返回一个引用到具有指定值的策略对象。
    
    参数
    
    value政策类型
    
    结果
    
    servantretentionpolicy对象。
  - create_request_processing_policy
```
RequestProcessingPolicy create_request_processing_policy(RequestProcessingPolicyValue value)
```
    这些操作每个返回一个引用到具有指定值的策略对象。
    
    参数
    
    value政策类型
    
    结果
    
    RequestProcessingPolicy对象。
  - the_name
```
String the_name()
```
    这个属性标识POA相对于它的父。这名被分配当POA创建。
  - the_parent
```
POA the_parent()
```
    这个属性标识的早熟亲本。这根POA母是空的。
  - the_children
```
POA[] the_children()
```
    此属性确定的早熟儿童POAs的当前设置。孩子问责制度设置包括只有早熟的孩子，而不是他们的后代。
  - the_POAManager
```
POAManager the_POAManager()
```
    这个属性标识与早熟有关的POA经理。
  - the_activator
```
AdapterActivator the_activator()
```
    这个属性标识的POA关联的适配器激活。
  - the_activator
```
void the_activator(AdapterActivator newThe_activator)
```
    这个属性标识的POA关联的适配器激活。
  - get_servant_manager
```
ServantManager get_servant_manager()
                            throws WrongPolicy
```
    如果ServantRetentionPolicy是POA的保留，然后servantmanager论点（imgr）应当支持servantactivator接口。一non_retain政策的servantmanager应当支持servantlocator接口。如果参数为零，或不支持所需的接口，提高了obj_adapter例外。
    
    结果
    
    servantmanager如果不存在与早熟或零相关。
    
    异常
    
    WrongPolicy提出如果没有指定use_servant_manager政策。
  - set_servant_manager
```
void set_servant_manager(ServantManager imgr)
                  throws WrongPolicy
```
    此操作设置与POA关联的默认服务经理。此操作可能只被调用一次在POA已创建。试图在一个已经设定的仆人经理将导致引发异常bad_inv_order。
    
    参数
    
    imgr仆人的经理作为一个默认的。
    
    异常
    
    WrongPolicy提出如果没有指定use_servant_manager政策。
  - get_servant
```
Servant get_servant()
             throws NoServant,
                    WrongPolicy
```
    该操作返回的POA关联的默认的仆人。
    
    结果
    
    p_servant默认的仆人用POA相关。
    
    异常
    
    NoServant提出如果没有默认的仆人与POA相关。
    
    WrongPolicy提出如果没有指定use_default_servant政策。
  - set_servant
```
void set_servant(Servant p_servant)
          throws WrongPolicy
```
    此操作寄存器指定的仆人与早熟禾作为默认的仆人。这个仆人将被用于所有的请求，没有仆人被发现在活动对象Map。
    
    参数
    
    p_servant仆人作为默认。
    
    异常
    
    WrongPolicy提出如果没有指定use_default_servant政策。
  - activate_object
```
byte[] activate_object(Servant p_servant)
                throws ServantAlreadyActive,
                       WrongPolicy
```
    此操作生成一个对象的身份证，并在活动对象映射中输入对象标识和指定的仆人。
    
    参数
    
    p_servant仆人是一个对象被激活有关。
    
    结果
    
    POA生成的对象ID。
    
    异常
    
    ServantAlreadyActive -如果早熟有unique_id政策和仆人已经在主动对象Map了。
    
    WrongPolicy提出如果system_id和保留政策不指定。
  - activate_object_with_id
```
void activate_object_with_id(byte[] id,
                             Servant p_servant)
                      throws ServantAlreadyActive,
                             ObjectAlreadyActive,
                             WrongPolicy
```
    该操作在活动对象映射中输入指定对象标识和指定的服务之间的关联关系。
    
    参数
    
    id -被激活的对象ID。
    
    p_servant仆人要与对象相关联的。
    
    异常
    
    ServantAlreadyActive提出如果早熟有unique_id政策和仆人已经在主动对象图。
    
    ObjectAlreadyActive提出如果对象在POA已经是活跃的。
    
    WrongPolicy提出如果没有指定保留政策是。
  - deactivate_object
```
void deactivate_object(byte[] oid)
                throws ObjectNotActive,
                       WrongPolicy
```
    这一操作导致objectid指定OID参数被停用。objectID已停用，继续处理请求之前，ObjectId有没有主动要求。停用objectid从活动物体Map删除时，所有请求，完成执行objectid。
    
    参数
    
    oid -要停用对象ID。
    
    异常
    
    ObjectNotActive -如果指定OID对象不在活动对象图。
    
    WrongPolicy提出如果没有指定保留政策是。
  - create_reference
```
Object create_reference(String intf)
                 throws WrongPolicy
```
    此操作将创建一个对象的引用，封装了一个POA生成对象ID值和指定的接口库的ID。
    
    参数
    
    intf -代表ID创建一个对象的引用。
    
    结果
    
    使用intF创建对象引用。
    
    异常
    
    WrongPolicy -如果没有指定system_id政策。
  - create_reference_with_id
```
Object create_reference_with_id(byte[] oid,
                                String intf)
```
    此操作将创建一个对象的引用，将指定的对象ID和接口库ID值。它不会导致激活发生。由此产生的参考可以传递给客户端，以便在这些引用的后续请求将导致对象被激活，如果必要的，或默认的仆人使用，取决于适用的政策。
    
    参数
    
    oid创建ObjRef对象ID
    
    intf -代表ID创建ObjRef
    
    结果
    
    使用OID和intF创建对象引用
    
    异常
    
    BAD_PARAM -如果早熟有system_id政策，它检测到的对象ID值不产生的系统或这早熟了。
  - servant_to_id
```
byte[] servant_to_id(Servant p_servant)
              throws ServantNotActive,
                     WrongPolicy
```
    此操作有四种可能的行为。1。如果早熟有unique_id政策和规定的仆人，仆人是活跃的，返回相关的对象ID。2。如果早熟有implicit_activation政策和POA的multiple_id政策或指定的仆人不活跃，仆人用POA生成的对象ID和仆人相关接口ID激活，和对象ID返回。三.如果早熟的use_default_servant政策，仆人指定为默认的仆人，和操作在执行默认的仆人请求上下文调用，并结合当前调用相关的对象id返回。4。否则，servantnotactive异常引发的。
    
    参数
    
    p_servant -仆人，涤丝返回对象。
    
    结果
    
    与仆人关联的对象标识。
    
    异常
    
    ServantNotActive如果上述规则和政策组合不符合。
    
    WrongPolicy -如果保留政策，无论是unique_id或implicit_activation政策use_default_servant政策或组合是不存在的。
  - servant_to_reference
```
Object servant_to_reference(Servant p_servant)
                     throws ServantNotActive,
                            WrongPolicy
```
    此操作要求保持政策的unique_id或implicit_activation政策如果调用一个操作被这个早熟的上下文之外。它有四种可能的行为。1。如果早熟既保留和unique_id政策和规定的人是主动的，一个对象的引用封装用于激活的仆人返回的信息。2。如果早熟既保留和implicit_activation政策和POA的multiple_id政策或指定的仆人不活跃，仆人用POA生成的对象ID和仆人相关接口ID激活，和相应的对象引用返回。三.如果在执行指定的仆人的请求的上下文中调用操作，则返回与当前调用相关联的引用。4。否则，servantnotactive异常引发的。
    
    参数
    
    p_servant仆人所需要获得的对象引用。
    
    结果
    
    与仆人关联的对象引用。
    
    异常
    
    WrongPolicy -如果操作不在执行指定的仆人和所需的政策要求的情况下调用是不存在的。
    
    ServantNotActive如果上述规定的政策和规定不符合。
  - reference_to_servant
```
Servant reference_to_servant(Object reference)
                      throws ObjectNotActive,
                             WrongPolicy,
                             WrongAdapter
```
    如果早熟有保留政策和指定的对象是主动对象映射，该操作返回，活动对象图对象关联的仆人。否则，如果早熟的use_default_servant政策和默认的仆人已经与POA注册，该操作返回默认的仆人。如果对象的引用是不是这早熟了，wrongadapter异常引发的。（与不一致问题poa.idl OMG。
    
    参数
    
    reference对象参考，仆人回来。
    
    结果
    
    与参考相关的仆人。
    
    异常
    
    WrongPolicy -如果没有保留政策或use_default_servant政策存在。
    
    ObjectNotActive如果仆人不在活动对象图（保留）或没有默认的仆人是注册（为use_default_policy）。
    
    WrongAdapter如果参考这并不早熟实例创建。
  - reference_to_id
```
byte[] reference_to_id(Object reference)
                throws WrongAdapter,
                       WrongPolicy
```
    此操作返回由指定的引用封装的对象标识值。这个操作是有效的只有当引用创建的POA的操作正在进行。引用的对象不必为该操作的成功进行活动。
    
    参数
    
    reference -对象引用的对象ID需要返回。
    
    结果
    
    封装在引用中的对象标识。
    
    异常
    
    WrongAdapter -如果参考并非由POA引用中指定了。
    
    WrongPolicy宣布允许未来的扩展。
  - id_to_servant
```
Servant id_to_servant(byte[] oid)
               throws ObjectNotActive,
                      WrongPolicy
```
    如果早熟有保留政策和指定objectid是主动对象图，该操作返回，活动对象图对象关联的仆人。否则，如果早熟的use_default_servant政策和默认的仆人已经与POA注册，该操作返回默认的仆人。
    
    参数
    
    oid对象ID为这仆人回来。
    
    结果
    
    仆人与OID。
    
    异常
    
    ObjectNotActive -如果ObjectId提出不在活动对象Map（保留政策），或没有默认的仆人是注册（为use_default_servant政策）。
    
    WrongPolicy -提高如果保留政策或use_default_servant政策是不存在的。
  - id_to_reference
```
Object id_to_reference(byte[] oid)
                throws ObjectNotActive,
                       WrongPolicy
```
    如果当前活动的对象具有指定的对象标识值，则返回用于激活该对象的信息的引用被返回。
    
    参数
    
    oid id的对象的引用返回。
    
    结果
    
    对象引用
    
    异常
    
    ObjectNotActive -如果在POA对象ID值是不活跃的。
    
    WrongPolicy如果保留政策是不存在的。
  - id
```
byte[] id()
```
    这将返回POA的独特身份的过程中，它创造了。它是使用便携式导弹拦截系统。
    这个ID是保证中的POA寿命的独特。执着的POAs，这意味着，如果一个POA是建立在相同的路径具有相同名字的另一个早熟，这些问责制度是相同的，因此，具有相同ID的瞬态POAs，每个POA是独特的。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface POAOperations

方法摘要

方法详细信息

create_POA

find_POA

destroy

create_thread_policy

create_lifespan_policy

create_id_uniqueness_policy

create_id_assignment_policy

create_implicit_activation_policy

create_servant_retention_policy

create_request_processing_policy

the_name

the_parent

the_children

the_POAManager

the_activator

the_activator

get_servant_manager

set_servant_manager

get_servant

set_servant

activate_object

activate_object_with_id

deactivate_object

create_reference

create_reference_with_id

servant_to_id

servant_to_reference

reference_to_servant

reference_to_id

id_to_servant

id_to_reference

id