POAOperations (Платформа Java SE 7)

Все Известные Подынтерфейсы:

POA
```
public interface POAOperations
```
Объект POA управляет реализацией набора объектов. POA поддерживает пространство имен для объектов, которые идентифицируются Объектными Идентификаторами. POA также обеспечивает пространство имен для POAs. POA создается как дочерний элемент существующего POA, который формирует иерархию, запускающуюся с корневого POA. Объект POA не должен быть экспортирован в другие процессы, или воплощен с ШАРОМ:: object_to_string.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`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 как дочерний элемент целевого POA.
`Объект`	`create_reference_with_id(byte[] oid, String intf)` Эта работа создает ссылку на объект, которая инкапсулирует указанный Объектный Идентификатор и интерфейсные Значения идентификаторов репозитария.
`Объект`	`create_reference(String intf)` Эта работа создает ссылку на объект, которая инкапсулирует POA-сгенерированное Объектное Значение идентификатора и указанный интерфейсный идентификатор репозитария.
`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 с указанным именем (относительно целевого POA), тот дочерний POA возвращается.
`ServantManager`	`get_servant_manager()` Если ServantRetentionPolicy POA, СОХРАНЯЮТ, то параметр ServantManager (imgr) должен поддерживать интерфейс ServantActivator.
`Слуга`	`get_servant()` Эта работа возвращает слугу по умолчанию, связанного с POA.
`Объект`	`id_to_reference(byte[] oid)` Если объект с указанным Объектным Значением идентификатора является в настоящий момент активным, ссылка, инкапсулирующая информацию, используемую, чтобы активировать объект, возвращается.
`Слуга`	`id_to_servant(byte[] oid)` Если у POA есть СОХРАНИТЬ политика, и указанный ObjectId находится в Активной Объектной Карте, эта работа возвращает слугу, связанного с тем объектом в Активной Объектной Карте.
`byte[]`	`id()` Это возвращает уникальный идентификатор POA в процессе, в котором это создается.
`byte[]`	`reference_to_id(Object reference)` Эта работа возвращает Объектное Значение идентификатора, инкапсулировавшее указанной ссылкой.
`Слуга`	`reference_to_servant(Object reference)` Если у POA есть СОХРАНИТЬ политика, и указанный объект присутствует в Активной Объектной Карте, эта работа возвращает слугу, связанного с тем объектом в Активной Объектной Карте.
`byte[]`	`servant_to_id(Servant p_servant)` У этой работы есть четыре возможных поведения.
`Объект`	`servant_to_reference(Servant p_servant)` Эта работа требует СОХРАНИТЬ политики и или UNIQUE_ID или политики IMPLICIT_ACTIVATION если вызвано вне контекста работы, диспетчеризированной этим POA.
`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()` Этот атрибут идентифицирует текущий набор всего дочернего POAs POA.
`Строка`	`the_name()` Этот атрибут идентифицирует POA относительно своего родителя.
`POA`	`the_parent()` Этот атрибут идентифицирует родителя POA.
`POAManager`	`the_POAManager()` Этот атрибут идентифицирует менеджера POA, связанного с POA.

- Деталь метода
  - create_POA
```
POA create_POA(String adapter_name,
             POAManager a_POAManager,
             Policy[] policies)
               throws AdapterAlreadyExists,
                      InvalidPolicy
```
    Эта работа создает новый POA как дочерний элемент целевого POA.
    
    Параметры:
    adapter_name - идентифицирует новый POA относительно другого POAs с тем же самым родительским POA.
    a_POAManager - определяет менеджера POA, чтобы быть связанным с новым POA.
    policies - определяет, что политика возражает, чтобы быть связанной с POA, чтобы управлять его поведением.
    
    Броски:
    
    AdapterAlreadyExists - определяет, что у целевого POA уже есть дочерний POA с указанным именем.
    
    InvalidPolicy - повышается, если какой-либо из объектов политики не допустим для ШАРА, или находится в конфликте, или требует административного действия, которое не было выполнено.
  - find_POA
```
POA find_POA(String adapter_name,
           boolean activate_it)
             throws AdapterNonExistent
```
    Если целевой POA является родителем дочернего POA с указанным именем (относительно целевого POA), тот дочерний POA возвращается.
    
    Параметры:
    adapter_name - POA называют, чтобы быть найденными.
    activate_it - если POA с указанным именем не существует, и значение activate_it параметра ПРАВДА, AdapterActivator целевого POA, если Вы существуете, вызывается.
    
    Возвраты:
    POA, если Вы существуете или активируетесь AdapterActivator.
    
    Броски:
    
    AdapterNonExistent
  - уничтожить
```
void destroy(boolean etherealize_objects,
           boolean wait_for_completion)
```
    Эта работа уничтожает POA и весь порожденный POAs. Все порожденные POAs уничтожаются (рекурсивно) перед разрушением содержания POA. POA, таким образом, уничтоженный (то есть, POA с его именем), могут быть воссозданы позже в том же самом процессе.
    
    Параметры:
    etherealize_objects - флаг, чтобы указать, нужно ли etherealize работу на менеджере слуги вызвать.
    wait_for_completion - флаг, чтобы указать, должны ли 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.
  - 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. Родитель корневого POA является нулем.
  - the_children
```
POA[] the_children()
```
    Этот атрибут идентифицирует текущий набор всего дочернего POAs POA. Набор дочернего POAs включает только непосредственные дочерние элементы POA, и не их потомков.
  - the_POAManager
```
POAManager the_POAManager()
```
    Этот атрибут идентифицирует менеджера POA, связанного с 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 связался с POA или нулем, если ни один не существует.
    
    Броски:
    
    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
```
    Эта работа регистрирует указанного слугу в POA как слуга по умолчанию. Этот слуга будет использоваться для всех запросов, для которых никакой слуга не находится в Активной Объектной Карте.
    
    Параметры:
    p_servant - слуга, который будет использоваться в качестве значения по умолчанию.
    
    Броски:
    
    WrongPolicy - повышенный, если политика USE_DEFAULT_SERVANT не определяется.
  - activate_object
```
byte[] activate_object(Servant p_servant)
                       throws ServantAlreadyActive,
                              WrongPolicy
```
    Эта работа генерирует Объектный Идентификатор и вводит Объектный Идентификатор и указанного слугу в Активной Объектной Карте.
    
    Параметры:
    p_servant - слуга, который будет связан с объектом, который будет активирован.
    
    Возвраты:
    POA сгенерированный объектный идентификатор.
    
    Броски:
    
    ServantAlreadyActive - повышается, если у POA есть политика UNIQUE_ID, и слуга уже, находится в Активной Объектной Карте.
    
    WrongPolicy - повышенный, если SYSTEM_ID и СОХРАНЯЮТ политики, не определяются.
  - activate_object_with_id
```
void activate_object_with_id(byte[] id,
                           Servant p_servant)
                             throws ServantAlreadyActive,
                                    ObjectAlreadyActive,
                                    WrongPolicy
```
    Эта работа вводит ассоциацию между указанным Объектным Идентификатором и указанным слугой в Активной Объектной Карте.
    
    Параметры:
    id - объектный идентификатор для объекта, который будет активирован.
    p_servant - слуга, который будет связан с объектом.
    
    Броски:
    
    ServantAlreadyActive - повышенный, если у POA есть политика UNIQUE_ID и слуга, уже находится в Активной Объектной Карте.
    
    ObjectAlreadyActive - повышенный, если объект является уже активным в POA.
    
    WrongPolicy - повышенный, если СОХРАНИТЬ политика, не определяется.
  - deactivate_object
```
void deactivate_object(byte[] oid)
                       throws ObjectNotActive,
                              WrongPolicy
```
    Эта работа заставляет ObjectId, определенный в параметре oid быть деактивированным. ObjectId, который был деактивирован, продолжает обрабатывать запросы, пока нет никаких активных запросов на тот ObjectId. Деактивированный ObjectId удаляется из Активной Объектной Карты, когда все запросы, выполняющиеся для того, который завершили ObjectId.
    
    Параметры:
    oid - Объектный Идентификатор для объекта, который будет деактивирован.
    
    Броски:
    
    ObjectNotActive - если объект с указанным oid не находится в Активной Объектной Карте.
    
    WrongPolicy - повышенный, если СОХРАНИТЬ политика, не определяется.
  - create_reference
```
Object create_reference(String intf)
                        throws WrongPolicy
```
    Эта работа создает ссылку на объект, которая инкапсулирует POA-сгенерированное Объектное Значение идентификатора и указанный интерфейсный идентификатор репозитария.
    
    Параметры:
    intf - идентификатор репутации для того, чтобы создать ссылку на объект.
    
    Возвраты:
    ссылка на объект создала использование intf.
    
    Броски:
    
    WrongPolicy - если политика SYSTEM_ID не определяется.
  - create_reference_with_id
```
Object create_reference_with_id(byte[] oid,
                              String intf)
```
    Эта работа создает ссылку на объект, которая инкапсулирует указанный Объектный Идентификатор и интерфейсные Значения идентификаторов репозитария. Это не заставляет активацию иметь место. Получающуюся ссылку можно передать клиентам, так, чтобы последующие запросы на тех ссылках заставили объект быть активированным в случае необходимости, или слуга по умолчанию, используемый, в зависимости от применимых политик.
    
    Параметры:
    oid - объектный идентификатор для того, чтобы создать objref
    intf - идентификатор репутации для того, чтобы создать objref
    
    Возвраты:
    ссылка на объект, создаваемая, используя oid и intf
    
    Броски:
    
    BAD_PARAM - повышается, если у POA есть политика SYSTEM_ID, и это обнаруживает, что Объектное Значение идентификатора не было сгенерировано системой или для этого POA.
  - servant_to_id
```
byte[] servant_to_id(Servant p_servant)
                     throws ServantNotActive,
                            WrongPolicy
```
    У этой работы есть четыре возможных поведения. 1. Если у POA есть политика UNIQUE_ID, и указанный слуга активен, Объектный Идентификатор, связанный с тем слугой, возвращается. 2. Если у POA есть политика IMPLICIT_ACTIVATION, и у или POA есть политика MULTIPLE_ID или указанный слуга, не является активным, слуга активируется, используя POA-сгенерированный Объектный Идентификатор и Интерфейсный Идентификатор, связанный со слугой, и что Объектный Идентификатор возвращается. 3. Если у POA есть политика USE_DEFAULT_SERVANT, определенный слуга является слугой по умолчанию, и работа вызывается в контексте выполнения запроса на слуге по умолчанию, то ObjectId, связанный с текущим вызовом, возвращается. 4. Иначе, исключение ServantNotActive повышается.
    
    Параметры:
    p_servant - слуга, для которого возвратился объект disi.
    
    Возвраты:
    объектный идентификатор связался со слугой.
    
    Броски:
    
    ServantNotActive - если вышеупомянутая комбинация правил и политики не встречается.
    
    WrongPolicy - если политика USE_DEFAULT_SERVANT или комбинация СОХРАНИТЬ политики и или UNIQUE_ID или политики IMPLICIT_ACTIVATION не присутствуют.
  - servant_to_reference
```
Object servant_to_reference(Servant p_servant)
                            throws ServantNotActive,
                                   WrongPolicy
```
    Эта работа требует СОХРАНИТЬ политики и или UNIQUE_ID или политики IMPLICIT_ACTIVATION если вызвано вне контекста работы, диспетчеризированной этим POA. У этого есть четыре возможных поведения. 1. Если у POA есть и СОХРАНЕНИЕ и политика UNIQUE_ID, и указанный слуга активен, ссылка на объект, инкапсулирующая информацию, используемую, чтобы активировать слугу, возвращается. 2. Если у POA есть и СОХРАНЕНИЕ и политика IMPLICIT_ACTIVATION, и у или POA есть политика MULTIPLE_ID или указанный слуга, не является активным, слуга активируется, используя POA-сгенерированный Объектный Идентификатор и Интерфейсный Идентификатор, связанный со слугой, и соответствующая ссылка на объект возвращается. 3. Если работа была вызвана в контексте выполнения запроса на указанном слуге, ссылка, связанная с текущим вызовом, возвращается. 4. Иначе, исключение ServantNotActive повышается.
    
    Параметры:
    p_servant - слуга, для которого должна быть получена ссылка на объект.
    
    Возвраты:
    ссылка на объект связалась со слугой.
    
    Броски:
    
    WrongPolicy - если работа не вызывается в контексте выполнения запроса на указанном слуге, и необходимые политики не присутствуют.
    
    ServantNotActive - если вышеупомянутые указанные политики и правила не встречаются.
  - reference_to_servant
```
Servant reference_to_servant(Object reference)
                             throws ObjectNotActive,
                                    WrongPolicy,
                                    WrongAdapter
```
    Если у POA есть СОХРАНИТЬ политика, и указанный объект присутствует в Активной Объектной Карте, эта работа возвращает слугу, связанного с тем объектом в Активной Объектной Карте. Иначе, если у POA есть политика USE_DEFAULT_SERVANT, и слуга по умолчанию был зарегистрирован в POA, эта работа возвращает слугу по умолчанию. Если ссылка на объект не создавалась этим POA, исключение WrongAdapter повышается. (Проблема OMG о несогласованности с POA.IDL.
    
    Параметры:
    reference - ссылка на объект, для которой возвращается слуга.
    
    Возвраты:
    слуга связался со ссылкой.
    
    Броски:
    
    WrongPolicy - если ни один СОХРАНИТЬ политика или политика USE_DEFAULT_SERVANT не присутствует.
    
    ObjectNotActive - если слуга не присутствует в Активной Объектной Карте (для, СОХРАНЯЮТ), или никакой слуга по умолчанию не регистрируется (для USE_DEFAULT_POLICY).
    
    WrongAdapter - если ссылка не создавалась этим экземпляром POA.
  - reference_to_id
```
byte[] reference_to_id(Object reference)
                       throws WrongAdapter,
                              WrongPolicy
```
    Эта работа возвращает Объектное Значение идентификатора, инкапсулировавшее указанной ссылкой. Эта работа допустима, только если ссылка создавалась POA, на котором выполняется работа. Объект, обозначенный ссылкой, не должен быть активным для этой работы, чтобы успешно выполниться.
    
    Параметры:
    reference - ссылка на объект, из которой должен быть возвращен объектный идентификатор.
    
    Возвраты:
    объектный идентификатор инкапсулируется в ссылке.
    
    Броски:
    
    WrongAdapter - если ссылка не создавалась POA, определенным в ссылке.
    
    WrongPolicy - объявленный позволить будущие расширения.
  - id_to_servant
```
Servant id_to_servant(byte[] oid)
                      throws ObjectNotActive,
                             WrongPolicy
```
    Если у POA есть СОХРАНИТЬ политика, и указанный ObjectId находится в Активной Объектной Карте, эта работа возвращает слугу, связанного с тем объектом в Активной Объектной Карте. Иначе, если у POA есть политика USE_DEFAULT_SERVANT, и слуга по умолчанию был зарегистрирован в POA, эта работа возвращает слугу по умолчанию.
    
    Параметры:
    oid - объектный идентификатор для, который возвращается слуга.
    
    Возвраты:
    слуга связался с oid.
    
    Броски:
    
    ObjectNotActive - повышается, если ObjectId, не находится в Активной Объектной Карте (для, СОХРАНЯЮТ политику), или никакой слуга по умолчанию не регистрируется (для политики USE_DEFAULT_SERVANT).
    
    WrongPolicy - повышается, если СОХРАНИТЬ политика или политика USE_DEFAULT_SERVANT не присутствуют.
  - id_to_reference
```
Object id_to_reference(byte[] oid)
                       throws ObjectNotActive,
                              WrongPolicy
```
    Если объект с указанным Объектным Значением идентификатора является в настоящий момент активным, ссылка, инкапсулирующая информацию, используемую, чтобы активировать объект, возвращается.
    
    Параметры:
    oid - идентификатор объекта, для которого возвращается ссылка.
    
    Возвраты:
    ссылка на объект
    
    Броски:
    
    ObjectNotActive - если Объектное Значение идентификатора не является активным в POA.
    
    WrongPolicy - если СОХРАНИТЬ политика не присутствует.
  - идентификатор
```
byte[] id()
```
    Это возвращает уникальный идентификатор POA в процессе, в котором это создается. Это для использования переносимыми перехватчиками.
    Этот идентификатор гарантируется уникальный для продолжительности жизни POA в процессе. Для персистентного POAs это означает, что, если POA создается в том же самом пути с тем же самым именем как другой POA, эти POAs идентичны и, поэтому, имеют тот же самый идентификатор. Для переходного POAs каждый POA уникален.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный POAOperations

Сводка метода

Деталь метода

create_POA

find_POA

уничтожить

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

идентификатор