Класс ActivationDesc

public final class ActivationDesc
extends Object
implements Serializable

Описание активации содержит информацию, необходимую для активации объекта:

• идентификатор группы объекта,
• полное имя класса объекта,
• расположение кода объекта (местоположение класса), путь URL кодовой базы,
• режим перезапуска объекта, и
• "сериализованный" объект, который может содержать данные для инициализации объекта.

Описание, зарегистрированное в системе активации, может быть использовано для создания/активации объекта, указанного в описании. MarshalledObject в описании объекта передаётся как второй аргумент конструктору удалённого объекта для использования при повторной инициализации/активации.

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

ActivationDesc

public ActivationDesc(String className,
                      String location,
                      MarshalledObject<?> data)
               throws ActivationException

Параметры:

className - полное имя класса объекта с учётом пакета

location - местоположение кода объекта (откуда загружается класс)

data - данные инициализации (активации) объекта в сериализованной форме.

Исключения:

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

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

С:

1.2

ActivationDesc

public ActivationDesc(String className,
                      String location,
                      MarshalledObject<?> data,
                      boolean restart)
               throws ActivationException

Параметры:

className - полное имя класса объекта с учётом пакета

location - местоположение кода объекта (откуда загружается класс)

data - данные инициализации (активации) объекта в сериализованной форме.

restart - если true, объект перезапускается (реактивируется), когда либо активизатор, либо группа активации объекта перезапускаются после непредвиденной ошибки; если false, объект активируется только по требованию. Установка restart в true не заставляет объект, только что зарегистрированный, активироваться немедленно; начальная активация отложена.

Исключения:

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

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

С:

1.2

ActivationDesc

public ActivationDesc(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data)

Параметры:

groupID - идентификатор группы (полученный при регистрации методом ActivationSystem.registerGroup). Группа указывает на виртуальную машину, в которой должен быть активирован объект.

className - полное имя класса объекта с учётом пакета

location - местоположение кода объекта (откуда загружается класс)

data - данные инициализации (активации) объекта в сериализованной форме.

Исключения:

IllegalArgumentException - если groupID равно null

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

С:

1.2

ActivationDesc

public ActivationDesc(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data,
                      boolean restart)

Создаёт дескриптор объекта, имя класса которого className, который может быть загружен из кода location, и информация об инициализации которого содержится в data. Все объекты с одинаковым groupID активируются в одной и той же виртуальной машине Java.

Параметры:

groupID - идентификатор группы (полученный при регистрации методом ActivationSystem.registerGroup). Группа указывает на виртуальную машину, в которой должен быть активирован объект.

className - полное имя класса объекта с учётом пакета

location - местоположение кода объекта (откуда загружается класс)

data - данные инициализации (активации) объекта в сериализованной форме.

restart - если true, объект перезапускается (реактивируется), когда либо активизатор, либо группа активации объекта перезапускаются после непредвиденной ошибки; если false, объект активируется только по требованию. Установка restart в true не заставляет объект, только что зарегистрированный, активироваться немедленно; начальная активация отложена.

Исключения:

IllegalArgumentException - если groupID равно null

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

С:

1.2

Методы

getGroupID

public ActivationGroupID getGroupID()

Возвращает идентификатор группы для объекта, определённого этим дескриптором. Группа предоставляет способ агрегации объектов в одной виртуальной машине Java. RMI создаёт/активирует объекты с одинаковым groupID в одной и той же виртуальной машине.

Возвращает:

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

С:

1.2

getClassName

public String getClassName()

Возвращает имя класса для объекта, определённого этим дескриптором.

Возвращает:

имя класса

С:

1.2

getLocation

public String getLocation()

Возвращает местоположение кода для объекта, определённого этим дескриптором.

Возвращает:

местоположение кода

С:

1.2

getData

public MarshalledObject<?> getData()

Возвращает "сериализованный объект", содержащий данные инициализации/активации для объекта, определённого этим дескриптором.

Возвращает:

специфичные для объекта данные "инициализации"

С:

1.2

getRestartMode

public boolean getRestartMode()

Возвращает режим "перезапуска" объекта, связанного с этим дескриптором активации.

Возвращает:

true, если активабельный объект, связанный с этим дескриптором активации, перезапускается демоном активации, когда либо демон запускается, либо группа объекта перезапускается после непредвиденной ошибки; в противном случае возвращает false, что означает, что объект активируется только по требованию посредством вызова метода. Обратите внимание, что если режим перезапуска true, активизатор не заставляет объект, только что зарегистрированный, активироваться немедленно; начальная активация отложена.

С:

1.2

equals

public boolean equals(Object obj)

Сравнивает два дескриптора активации для проверки равенства содержимого.

Переопределяет:

equals в классе Object

Параметры:

obj - объект для сравнения

Возвращает:

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

С:

1.2

См. также:

Hashtable

hashCode

public int hashCode()

Возвращает одинаковый hashCode для похожих ActivationDesc.

Переопределяет:

hashCode в классе Object

Возвращает:

целое число

См. также:

Hashtable