Интерфейс ActivationSystem

public interface ActivationSystem
extends Remote

Поля

SYSTEM_PORT

static final int SYSTEM_PORT

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

См. также:

Значения константных полей

Методы

registerObject

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

Параметры:

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)