java.rmi.activation

Класс ActivationGroup

java.lang. Объект

java.rmi.server. RemoteObject

java.rmi.server. RemoteServer

java.rmi.server. UnicastRemoteObject

java.rmi.activation. ActivationGroup

Все Реализованные Интерфейсы:

Сериализуемый, ActivationInstantiator, Удаленный

public abstract class ActivationGroup
extends UnicastRemoteObject
implements ActivationInstantiator

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

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

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

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

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

Когда создающийся, реализация по умолчанию ActivationGroup переопределит системные свойства со свойствами, которые требуют когда ActivationGroupDesc создавался, и установит a java.rmi.RMISecurityManager как менеджер по безопасности системы по умолчанию. Если Ваше приложение требует, чтобы определенные свойства были установлены, когда объекты активируются в группе, приложение должно создать специальное предложение Properties объект, содержащий эти свойства, затем создайте ActivationGroupDesc с Properties объект, и использование ActivationGroup.createGroup прежде, чем создать любого ActivationDescs (прежде, чем значение по умолчанию ActivationGroupDesc создается). Если Ваше приложение требует использования менеджера безопасности кроме java.rmi.RMISecurityManager, в списке свойств ActivativationGroupDescriptor можно установить java.security.manager свойство к имени менеджера безопасности требуется установить.

С тех пор:

1.2

См. Также:

ActivationInstantiator, ActivationGroupDesc, ActivationGroupID, Сериализированная Форма

Полевая Сводка

Поля java.rmi.server унаследованный от класса. RemoteObject

касательно

Сводка конструктора

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

Модификатор	Конструктор и Описание
protected	ActivationGroup(ActivationGroupID groupID) Создает группу активации с данным групповым идентификатором активации.

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

Методы

Модификатор и Тип	Метод и Описание
protected void	activeObject(ActivationID id, MarshalledObject<? extends Remote> mobj) Этот защищенный метод необходим для подклассов, чтобы сделать activeObject обратный вызов к монитору группы.
abstract void	activeObject(ActivationID id, Remote obj) Группа activeObject метод вызывают, когда объект экспортируется (любой Activatable объектная конструкция или явный звонок Activatable.exportObject.
static ActivationGroup	createGroup(ActivationGroupID id, ActivationGroupDesc desc, long incarnation) Создайте и установите группу активации для текущего VM.
static ActivationGroupID	currentGroupID() Возвращает текущий групповой идентификатор активации.
static ActivationSystem	getSystem() Возвращает систему активации для VM.
protected void	inactiveGroup() Этот защищенный метод необходим для подклассов, чтобы сделать inactiveGroup обратный вызов к монитору группы.
boolean	inactiveObject(ActivationID id) Группа inactiveObject метод вызывают косвенно через звонок Activatable.inactive метод.
static void	setSystem(ActivationSystem system) Установите систему активации для VM.

Методы java.rmi.server унаследованный от класса. UnicastRemoteObject

clone, exportObject, exportObject, exportObject, unexportObject

Методы java.rmi.server унаследованный от класса. RemoteServer

getClientHost, getLog, setLog

Методы java.rmi.server унаследованный от класса. RemoteObject

equals, getRef, hashCode, toString, toStub

Методы java.lang унаследованный от класса. Объект

finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, наследованные от интерфейса java.rmi.activation.ActivationInstantiator

newInstance

Деталь конструктора

ActivationGroup

protected ActivationGroup(ActivationGroupID groupID)
                   throws RemoteException

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

Параметры:

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

Броски:

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

С тех пор:

1.2

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

inactiveObject

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

Группа inactiveObject метод вызывают косвенно через звонок Activatable.inactive метод. Реализация удаленного объекта должна вызвать Activatable's inactive метод, когда тот объект деактивируется (объект считает, что это больше не активно). Если объект не вызывает Activatable.inactive когда это деактивируется, объект никогда не будет собираться "мусор", так как группа сохраняет сильные ссылки на объекты, которые это создает.

Группа inactiveObject со времени выполнения RMI метод неэкспортирует удаленный объект так, чтобы объект больше не мог получить входящие вызовы RMI. Объект будет только неэкспортироваться, если у объекта не будет никакого ожидания или выполнения вызовов. Подкласс ActivationGroup должен переопределить этот метод и неэкспортировать объект.

После удаления объекта со времени выполнения RMI группа должна сообщить ActivationMonitor (через монитор inactiveObject метод), что удаленный объект не является в настоящий момент активным так, чтобы удаленный объект был оживлен активатором по последующему запросу активации.

Этот метод просто сообщает монитору группы, что объект неактивен. Это до конкретного подкласса ActivationGroup, чтобы выполнить дополнительное требование неэкспорта объекта.

Параметры:

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

Возвраты:

истина, если объект был успешно деактивирован; иначе возвращает 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

Создайте и установите группу активации для текущего VM. Группа активации может только быть установлена, если она в настоящий момент не устанавливается. Группа активации устанавливается, используя createGroup метод, когда Activator инициирует воссоздание группы активации, чтобы выполнить поступление activate запросы. Группа должна сначала быть зарегистрирована в ActivationSystem прежде, чем это сможет быть создано через этот метод.

Групповой класс, определенный ActivationGroupDesc должен быть конкретный подкласс ActivationGroup и имейте общедоступного конструктора, который берет два параметра: ActivationGroupID для группы и MarshalledObject содержа данные инициализации группы (полученный из ActivationGroupDesc.

Если групповое имя класса, определенное в ActivationGroupDesc null, тогда этот метод будет вести себя как будто групповой дескриптор, содержавший имя группового класса реализации активации по умолчанию.

Отметьте, что, если Ваше приложение создает свою собственную группу активации, менеджер безопасности должен быть установлен для той группы. Иначе объекты не могут быть активированы в группе. java.rmi.RMISecurityManager устанавливается по умолчанию.

Если менеджер безопасности уже устанавливается в группе VM, этот метод первые вызовы менеджер безопасности checkSetFactory метод. Это могло привести к a SecurityException. Если Ваше приложение должно установить различного менеджера безопасности, следует гарантировать что файл политики, определенный группой ActivationGroupDesc предоставляет группе необходимые полномочия, чтобы установить нового менеджера безопасности. (Отметьте: Это будет необходимо, если Ваша группа загрузит и установит менеджера безопасности).

После того, как группа создается, ActivationSystem сообщается, что группа активна, вызывая activeGroup метод, который возвращается ActivationMonitor для группы. Приложение не должно вызвать activeGroup независимо, так как это заботится об этим методом.

Как только группа создается, последующие звонки currentGroupID метод возвратит идентификатор для этой группы, пока группа не станет неактивной.

Параметры:

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

desc - групповой дескриптор активации

incarnation - число воплощения группы (обнуляют на начальном создании группы),

Возвраты:

группа активации для VM

Броски:

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

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

С тех пор:

1.2

См. Также:

SecurityManager.checkSetFactory()

currentGroupID

public static ActivationGroupID currentGroupID()

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

Возвраты:

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

С тех пор:

1.2

setSystem

public static void setSystem(ActivationSystem system)
                      throws ActivationException

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

Если есть менеджер безопасности, этот метод первые вызовы менеджер безопасности checkSetFactory метод. Это могло привести к SecurityException.

Параметры:

system - отдалите ссылку на ActivationSystem

Броски:

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

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

С тех пор:

1.2

См. Также:

getSystem(), SecurityManager.checkSetFactory()

getSystem

public static ActivationSystem getSystem()
                                  throws ActivationException

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

Возвраты:

система активации для VM/group

Броски:

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

С тех пор:

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. Кроме того, текущая группа для VM, устанавливают в NULL.

Броски:

UnknownGroupException - если группа не регистрируется

RemoteException - если вызов, сообщающий сбоям монитора

С тех пор:

1.2