java.rmi.activation

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

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

Удаленный

public interface ActivationSystem
extends Remote

ActivationSystem обеспечивает средство для того, чтобы оно зарегистрировало группы, и "activatable" возражает, чтобы быть активированным в пределах тех групп. 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, и получите идентификатор активации для activatable удаленного объекта.
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, и получите идентификатор активации для activatable удаленного объекта. 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 - instantiator группы

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

завершение работы

void shutdown()
              throws RemoteException

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

Броски:

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

С тех пор:

1.2

setActivationDesc

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

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

Параметры:

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

desc - дескриптор активации для объекта activatable

Возвраты:

предыдущее значение дескриптора активации

Броски:

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 - идентификатор активации для объекта activatable

Возвраты:

дескриптор активации

Броски:

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)