Класс ActivationDesc

Все реализованные интерфейсы:
Serializable
public final class ActivationDesc
extends Object
implements Serializable

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

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

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

С тех пор:
1.2
См. также:
Activatable, Сериализованная форма

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

Конструктор Описание
ActivationDesc​(String className, String location, MarshalledObject<?> data)

Создает описание объекта для объекта, имя класса которого className, который может быть загружен из кода location и чья информация об инициализации data.

ActivationDesc​(String className, String location, MarshalledObject<?> data, boolean restart)

Создает описание объекта для объекта, имя класса которого className, который может быть загружен из кода location и чья информация об инициализации data.

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

Создает описание объекта для объекта, имя класса которого className который может быть загружен из кода location и чья информация об инициализации data.

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

Создает описание объекта для объекта, имя класса которого className который может быть загружен из кода location и чья информация об инициализации data.

Методы

Модификатор и тип Метод Описание
boolean equals​(Object obj)

Сравнивает два описания активации на равенство по содержимому.
String getClassName()

Возвращает имя класса для объекта, указанного в этом описании.
MarshalledObject<?> getData()

Возвращает «маршализованный объект», содержащий данные инициализации/активации для объекта, указанного в этом описании.
ActivationGroupID getGroupID()

Возвращает идентификатор группы для объекта, указанного в этом описании.
String getLocation()

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

Возвращает «режим» перезапуска объекта, связанного с этим описанием активации.
int hashCode()

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

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

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

ActivationDesc

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

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

Обратите внимание, что объекты, задаваемые дескриптором, созданным с помощью этого конструктора, будут активированы только по требованию (по умолчанию режим перезапуска — false). Если активируемый объект требует службы перезапуска, используйте один из конструкторов ActivationDesc, принимающих булевый параметр, restart.

Этот конструктор выбросит исключение ActivationException, если для этой виртуальной машины нет текущей группы активации. Для создания ActivationGroup используйте метод ActivationGroup.createGroup.

Параметры:
className — полное имя класса объекта с учётом пакетов
location — расположение кода объекта (откуда загружается класс)
data — данные инициализации (активации) объекта в маршализованной форме.
Исключения:
ActivationException — если текущей группы нет
UnsupportedOperationException — если и только если активация не поддерживается данной реализацией
С тех пор:
1.2

ActivationDesc

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

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

Этот конструктор выбросит исключение ActivationException, если для этой виртуальной машины нет текущей группы активации. Для создания ActivationGroup используйте метод ActivationGroup.createGroup.

Параметры:
className — полное имя класса объекта с учётом пакетов
location — расположение кода объекта (откуда загружается класс)
data — данные инициализации (активации) объекта в маршализованной форме.
restart — если true, объект перезапускается (реактивируется), когда перезапускается активатор или группа активации объекта после непредвиденного сбоя; если false, объект активируется только по требованию. Указание restart как true не принуждает к начальной немедленной активации нового зарегистрированного объекта; начальная активация отложена.
Исключения:
ActivationException — если текущей группы нет
UnsupportedOperationException — если и только если активация не поддерживается данной реализацией
С тех пор:
1.2

ActivationDesc

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

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

Обратите внимание, что объекты, задаваемые дескриптором, созданным с помощью этого конструктора, будут активированы только по требованию (по умолчанию режим перезапуска — false). Если активируемый объект требует службы перезапуска, используйте один из конструкторов ActivationDesc, принимающих булевый параметр, restart.

Параметры:
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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.rmi/java/rmi/activation/ActivationDesc.html

Spec-Zone .ru
спецификации, руководства, описания, API