Класс ActivationGroup

public abstract class ActivationGroup
extends UnicastRemoteObject
implements ActivationInstantiator

Группа ActivationGroup отвечает за создание новых экземпляров "активируемых" объектов в своей группе, уведомляя свой ActivationMonitor о том, когда объекты становятся активными или неактивными, или вся группа становится неактивной.

Группа ActivationGroup изначально создаётся несколькими способами:

• в качестве побочного эффекта создания ActivationDesc без явного указания ActivationGroupID для первого активируемого объекта в группе, или
• через метод ActivationGroup.createGroup
• в качестве побочного эффекта активации первого объекта в группе, чья ActivationGroupDesc была только зарегистрирована.

Только активизатор может пересоздать ActivationGroup. Активизатор по мере необходимости запускает отдельный виртуальную машину (например, как дочерний процесс) для каждой зарегистрированной группы активации и направляет запросы активации в соответствующую группу. Способ запуска виртуальных машин зависит от реализации. Группа активации создается через статический метод ActivationGroup.createGroup. Метод createGroup имеет два требования к создаваемой группе: 1) группа должна быть конкретным подклассом ActivationGroup, и 2) группа должна иметь конструктор, принимающий два аргумента:

• идентификатор группы ActivationGroupID, и
• данные инициализации группы (в виде java.rmi.MarshalledObject).

При создании, по умолчанию ActivationGroup переопределит системные свойства свойствами, запрошенными при создании её ActivationGroupDesc, и установит SecurityManager в качестве системного менеджера безопасности по умолчанию. Если ваше приложение требует установки определенных свойств при активации объектов в группе, приложение должно создать специальный объект Properties содержащий эти свойства, затем создать ActivationGroupDesc с объектом Properties, и использовать ActivationGroup.createGroup перед созданием каких-либо ActivationDesc (перед созданием по умолчанию ActivationGroupDesc). Если ваше приложение требует использования менеджера безопасности отличного от SecurityManager, в свойствах ActivativationGroupDescriptor можно установить свойство java.security.manager с именем менеджера безопасности, который вы хотите установить.

Конструкторы

ActivationGroup

protected ActivationGroup(ActivationGroupID groupID)
                   throws RemoteException

Создаёт группу активации с заданным идентификатором группы активации. Группа экспортируется как java.rmi.server.UnicastRemoteObject.

Параметры:

groupID - идентификатор группы

Исключения:

RemoteException - если эту группу нельзя было экспортировать

UnsupportedOperationException - если и только если активация не поддерживается данной реализацией

С:

1.2

Методы

inactiveObject

public boolean inactiveObject(ActivationID id)
                       throws ActivationException,
                              UnknownObjectException,
                              RemoteException

Параметры:

id - идентификатор активации объекта

Возвращает:

true, если объект был успешно деактивирован; в противном случае возвращает false.

Исключения:

UnknownObjectException - если объект неизвестен (возможно, уже неактивен)

RemoteException - если вызов уведомления монитора завершился ошибкой

ActivationException - если группа неактивна

С:

1.2

activeObject

public abstract void activeObject(ActivationID id,
                                  Remote obj)
                           throws ActivationException,
                                  UnknownObjectException,
                                  RemoteException

Метод activeObject группы вызывается, когда объект экспортируется (либо при создании объекта Activatable или явном вызове Activatable.exportObject). Группа должна уведомить свой ActivationMonitor о том, что объект активен (через метод activeObject монитора), если этого ещё не было сделано.

Параметры:

id - идентификатор объекта

obj - реализация удалённого объекта

Исключения:

UnknownObjectException - если объект не зарегистрирован

RemoteException - если вызов уведомления монитора завершился ошибкой

ActivationException - если группа неактивна

С:

1.2

createGroup

public static ActivationGroup createGroup(ActivationGroupID id,
                                          ActivationGroupDesc desc,
                                          long incarnation)
                                   throws ActivationException

Параметры:

id - идентификатор группы активации

desc - описание группы активации

incarnation - номер инкарнации группы (ноль при первоначальном создании группы)

Возвращает:

группа активации для виртуальной машины

Исключения:

ActivationException - если группа уже существует или произошла ошибка при создании группы

SecurityException - если разрешение на создание группы отказано. (Примечание: реализация диспетчера безопасности checkSetFactory требует разрешения RuntimePermission "setFactory")

UnsupportedOperationException - если и только если активация не поддерживается данной реализацией

См. также:

SecurityManager.checkSetFactory()

currentGroupID

public static ActivationGroupID currentGroupID()

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

Возвращает:

идентификатор группы активации

Исключения:

UnsupportedOperationException - если и только если активация не поддерживается данной реализацией

С:

1.2

setSystem

public static void setSystem(ActivationSystem system)
                      throws ActivationException

Параметры:

system - удалённая ссылка на ActivationSystem

Исключения:

ActivationException - если система активации уже установлена

SecurityException - если разрешение на установку системы активации отказано. (Примечание: реализация диспетчера безопасности checkSetFactory требует разрешения RuntimePermission "setFactory")

UnsupportedOperationException - если и только если активация не поддерживается данной реализацией

С:

1.2

См. также:

getSystem(), SecurityManager.checkSetFactory()

getSystem

public static ActivationSystem getSystem()
                                  throws ActivationException

Возвращает систему активации для виртуальной машины. Система активации может быть установлена методом setSystem . Если система активации не установлена с помощью метода setSystem, то метод getSystem пытается получить ссылку на ActivationSystem, выполнив поиск имени "java.rmi.activation.ActivationSystem" в реестре активизатора. По умолчанию номер порта, используемый для поиска системы активации, определён в ActivationSystem.SYSTEM_PORT. Этот порт может быть изменён путём установки свойства java.rmi.activation.port.

Возвращает:

система активации для виртуальной машины/группы

Исключения:

ActivationException - если система активации не может быть получена или не привязана (означает, что она не запущена)

UnsupportedOperationException - если и только если активация не поддерживается данной реализацией

С:

1.2

См. также:

setSystem(java.rmi.activation.ActivationSystem)

activeObject

protected void activeObject(ActivationID id,
                            MarshalledObject<? extends Remote> mobj)
                     throws ActivationException,
                            UnknownObjectException,
                            RemoteException

Этот защищённый метод необходим подклассам для вызова обратного вызова activeObject монитору группы. Вызов просто передаётся монитору ActivationMonitor группы.

Параметры:

id - идентификатор объекта

mobj - сериализованный объект, содержащий заглушку удалённого объекта

Исключения:

UnknownObjectException - если объект не зарегистрирован

RemoteException - если вызов уведомления монитора завершился ошибкой

ActivationException - если произошла ошибка активации

С:

1.2

inactiveGroup

protected void inactiveGroup()
                      throws UnknownGroupException,
                             RemoteException

Этот защищённый метод необходим подклассам для вызова обратного вызова inactiveGroup монитору группы. Вызов просто передаётся монитору ActivationMonitor группы. Кроме того, текущая группа для виртуальной машины устанавливается в null.

Исключения:

UnknownGroupException - если группа не зарегистрирована

RemoteException - если вызов уведомления монитора завершился ошибкой

С:

1.2