Интерфейс ActivationSystem

Все суперинтерфейсы:: Remote

public interface ActivationSystem
extends Remote

Интерфейс ActivationSystem предоставляет способ регистрации групп и «активируемых» объектов для активации в этих группах. ActivationSystem тесно взаимодействует с Activator, который активирует зарегистрированные объекты через ActivationSystem, и с ActivationMonitor, который получает информацию об активных и неактивных объектах и группах.

С:: 1.2
См. также:: Activator, ActivationMonitor

Поля

Модификатор и тип	Поле	Описание
`static int`	`SYSTEM_PORT`	Порт для поиска системы активации.

Методы

Модификатор и тип	Метод	Описание
`ActivationMonitor`	`activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation)`	Обработчик для уведомления системы активации о том, что группа теперь активна.
`ActivationDesc`	`getActivationDesc(ActivationID id)`	Возвращает дескриптор активации для объекта с идентификатором активации `id`.
`ActivationGroupDesc`	`getActivationGroupDesc(ActivationGroupID id)`	Возвращает дескриптор группы активации для группы с идентификатором группы активации `id`.
`ActivationGroupID`	`registerGroup(ActivationGroupDesc desc)`	Зарегистрировать группу активации.
`ActivationID`	`registerObject(ActivationDesc desc)`	Метод `registerObject` используется для регистрации дескриптора активации `desc` и получения идентификатора активации для активируемого удаленного объекта.
`ActivationDesc`	`setActivationDesc(ActivationID id, ActivationDesc desc)`	Устанавливает дескриптор активации `desc` для объекта с идентификатором активации `id`.
`ActivationGroupDesc`	`setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc)`	Устанавливает дескриптор группы активации `desc` для объекта с идентификатором группы активации `id`.
`void`	`shutdown()`	Выключение системы активации.
`void`	`unregisterGroup(ActivationGroupID id)`	Удалить группу активации.
`void`	`unregisterObject(ActivationID id)`	Удаляет идентификатор активации и связанный с ним дескриптор, ранее зарегистрированные в `ActivationSystem`; объект больше не может быть активирован через идентификатор активации объекта.

Поля

SYSTEM_PORT

static final int SYSTEM_PORT

Порт для поиска системы активации.

См. также:: Значения константных полей

Методы

registerObject

ActivationID registerObject(ActivationDesc desc)
                     throws ActivationException,
                            UnknownGroupException,
                            RemoteException

Метод registerObject используется для регистрации описателя активации, desc, и получения идентификатора активации для активируемого удалённого объекта. Метод ActivationSystem создаёт ActivationID (идентификатор активации) для объекта, указанного в описателе, desc, и записывает в устойчивое хранилище описатель активации и его связанный идентификатор для последующего использования. Когда система Activator получает запрос activate для определённого идентификатора, она ищет описатель активации (зарегистрированный ранее) для указанного идентификатора и использует эту информацию для активации объекта.

Параметры:: desc - описатель активации объекта
Возвращает:: идентификатор активации, который может быть использован для активации объекта
Исключения:: ActivationException - если регистрация завершилась неудачно (например, ошибка обновления базы данных и т. п.).; UnknownGroupException - если группа, на которую ссылается desc, не зарегистрирована в этой системе.; RemoteException - если вызов удалённого метода завершился неудачно.
С версии:: 1.2

unregisterObject

void unregisterObject(ActivationID id)
               throws ActivationException,
                      UnknownObjectException,
                      RemoteException

Удаляет идентификатор активации и связанный с ним описатель, ранее зарегистрированные в системе ActivationSystem; объект больше не может быть активирован с помощью его идентификатора активации.

Параметры:: id - идентификатор активации объекта (из предыдущей регистрации)
Исключения:: ActivationException - если удаление завершилось неудачно (например, ошибка обновления базы данных и т. п.).; UnknownObjectException - если объект неизвестен (не зарегистрирован).; RemoteException - если вызов удалённого метода завершился неудачно.
С версии:: 1.2

registerGroup

ActivationGroupID registerGroup(ActivationGroupDesc desc)
                         throws ActivationException,
                                RemoteException

Регистрирует группу активации. Группа активации должна быть зарегистрирована в системе ActivationSystem перед тем, как в ней можно будет регистрировать объекты.

Параметры:: desc - описатель группы
Возвращает:: идентификатор группы
Исключения:: ActivationException - если регистрация группы завершилась неудачно.; RemoteException - если вызов удалённого метода завершился неудачно.
С версии:: 1.2

activeGroup

ActivationMonitor activeGroup(ActivationGroupID id,
                              ActivationInstantiator group,
                              long incarnation)
                       throws UnknownGroupException,
                              ActivationException,
                              RemoteException

Обратный вызов для информирования системы активации о том, что группа теперь активна. Этот вызов делается внутри методом ActivationGroup.createGroup для информирования ActivationSystem о том, что группа теперь активна.

Параметры:: id - идентификатор группы активации; group - инициализатор группы; incarnation - номер инкарнации группы
Возвращает:: монитор для группы активации
Исключения:: UnknownGroupException - если группа не зарегистрирована.; ActivationException - если группа для указанного id уже активна и эта группа не равна указанной group или у этой группы другой incarnation чем у указанной group.; RemoteException - если вызов удалённого метода завершился неудачно.
С версии:: 1.2

unregisterGroup

void unregisterGroup(ActivationGroupID id)
              throws ActivationException,
                     UnknownGroupException,
                     RemoteException

Удаляет группу активации. Группа активации делает этот обратный вызов для информирования активизатора о том, что группа должна быть удалена (уничтожена). Если этот вызов завершается успешно, объекты больше не могут быть зарегистрированы или активированы в рамках группы. Вся информация о группе и связанных с ней объектах удаляется из системы.

Параметры:: id - идентификатор группы активации
Исключения:: ActivationException - если удаление завершилось неудачно (например, ошибка обновления базы данных и т. п.).; UnknownGroupException - если группа не зарегистрирована.; RemoteException - если вызов удалённого метода завершился неудачно.
С версии:: 1.2

shutdown

void shutdown()
       throws RemoteException

Выключение системы активации. Уничтожает все группы, созданные демоном активации, и завершает работу демона активации.

Исключения:: RemoteException - если не удалось связаться с/выключить демоном активации.
С версии:: 1.2

setActivationDesc

ActivationDesc setActivationDesc(ActivationID id,
                                 ActivationDesc desc)
                          throws ActivationException,
                                 UnknownObjectException,
                                 UnknownGroupException,
                                 RemoteException

Устанавливает описатель активации, desc, для объекта с идентификатором активации, id. Изменения вступят в силу при последующей активации объекта.

Параметры:: id - идентификатор активации активируемого объекта; desc - описатель активации активируемого объекта
Возвращает:: предыдущее значение описателя активации
Исключения:: UnknownGroupException - группа, связанная с desc, не является зарегистрированной группой.; UnknownObjectException - активация id не зарегистрирована.; ActivationException - общая ошибка (например, невозможно обновить журнал).; RemoteException - если вызов удалённого метода завершился неудачно.
С версии:: 1.2
См. также:: getActivationDesc(java.rmi.activation.ActivationID)

setActivationGroupDesc

ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id,
                                           ActivationGroupDesc desc)
                                    throws ActivationException,
                                           UnknownGroupException,
                                           RemoteException

Устанавливает описатель группы активации, desc, для объекта с идентификатором группы активации, id. Изменения вступят в силу при последующей активации группы.

Параметры:: id - идентификатор группы активации для группы активации; desc - описатель группы активации для группы активации
Возвращает:: предыдущее значение описателя группы активации
Исключения:: UnknownGroupException - группа, связанная с id, не является зарегистрированной группой.; ActivationException - общая ошибка (например, невозможно обновить журнал).; RemoteException - если вызов удалённого метода завершился неудачно.
С версии:: 1.2
См. также:: getActivationGroupDesc(java.rmi.activation.ActivationGroupID)

getActivationDesc

ActivationDesc getActivationDesc(ActivationID id)
                          throws ActivationException,
                                 UnknownObjectException,
                                 RemoteException

Возвращает описатель активации для объекта с идентификатором активации, id.

Параметры:: id - идентификатор активации активируемого объекта
Возвращает:: описатель активации
Исключения:: UnknownObjectException - если id не зарегистрирована.; ActivationException - общая ошибка.; RemoteException - если вызов удалённого метода завершился неудачно.
С версии:: 1.2
См. также:: setActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc)

getActivationGroupDesc

ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id)
                                    throws ActivationException,
                                           UnknownGroupException,
                                           RemoteException

Возвращает описатель группы активации для группы с идентификатором группы активации, id.

Параметры:: id - идентификатор группы активации для группы
Возвращает:: описатель группы активации
Исключения:: UnknownGroupException - если id не зарегистрирована.; ActivationException - общая ошибка.; RemoteException - если вызов удалённого метода завершился неудачно.
С версии:: 1.2
См. также:: setActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc)

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.rmi/java/rmi/activation/ActivationSystem.html