java.rmi.activation

Класс Activatable

java.lang. Объект

java.rmi.server. RemoteObject

java.rmi.server. RemoteServer

java.rmi.activation. Activatable

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

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

public abstract class Activatable
extends RemoteServer

Activatable класс оказывает поддержку для удаленных объектов, которые требуют персистентного доступа в течение долгого времени, и это может быть активировано системой.

Для конструкторов и статичный exportObject методы, тупик для экспортируемого удаленного объекта получаются как описано в UnicastRemoteObject.

Попытка сериализировать явно экземпляр этого класса перестанет работать.

С тех пор:

1.2

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

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

касательно

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

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

Модификатор	Конструктор и Описание
protected	Activatable(ActivationID id, int port) Конструктор имел обыкновение активировать/экспортировать объект на указанном порту.
protected	Activatable(ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) Конструктор имел обыкновение активировать/экспортировать объект на указанном порту.
protected	Activatable(String location, MarshalledObject<?> data, boolean restart, int port) Создает activatable удаленный объект, регистрируя дескриптор активации (с указанным расположением, данными, и режимом перезапуска) для этого объекта, и экспортируя объект с указанным портом.
protected	Activatable(String location, MarshalledObject<?> data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) Создает activatable удаленный объект, регистрируя дескриптор активации (с указанным расположением, данными, и режимом перезапуска) для этого объекта, и экспортируя объект с указанным портом, и определенные фабрики сокета клиента и сервера.

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

Методы

Модификатор и Тип	Метод и Описание
static Remote	exportObject(Remote obj, ActivationID id, int port) Экспортируйте activatable удаленный объект во время выполнения RMI, чтобы сделать объект доступным, чтобы получить входящие вызовы.
static Remote	exportObject(Remote obj, ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) Экспортируйте activatable удаленный объект во время выполнения RMI, чтобы сделать объект доступным, чтобы получить входящие вызовы.
static ActivationID	exportObject(Remote obj, String location, MarshalledObject<?> data, boolean restart, int port) Регистрирует дескриптор активации (в указанном расположении, данных, и режиме перезапуска) для указанного объекта, и экспорта, который возражает с указанным портом.
static ActivationID	exportObject(Remote obj, String location, MarshalledObject<?> data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) Регистрирует дескриптор активации (в указанном расположении, данных, и режиме перезапуска) для указанного объекта, и экспорта, который возражает с указанным портом, и указанными фабриками сокета клиента и сервера.
protected ActivationID	getID() Возвращает идентификатор активации объекта.
static boolean	inactive(ActivationID id) Сообщает системе что объект с соответствующей активацией id в настоящий момент неактивно.
static Remote	register(ActivationDesc desc) Зарегистрируйте объектный дескриптор для activatable удаленного объекта так, чтобы был, может быть активирован по требованию.
static boolean	unexportObject(Remote obj, boolean force) Удалите удаленный объект, obj, со времени выполнения RMI.
static void	unregister(ActivationID id) Отменяет предыдущую регистрацию для дескриптора активации, связанного с id.

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

getClientHost, getLog, setLog

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

equals, getRef, hashCode, toString, toStub

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

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

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

Activatable

protected Activatable(String location,
           MarshalledObject<?> data,
           boolean restart,
           int port)
               throws ActivationException,
                      RemoteException

Создает activatable удаленный объект, регистрируя дескриптор активации (с указанным расположением, данными, и режимом перезапуска) для этого объекта, и экспортируя объект с указанным портом.

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

Этот метод вызывает exportObject метод с этим объектом, и указанное расположение, данные, перезапускает режим, и порт. Последующие звонки getID() возвратит идентификатор активации, возвращенный из звонка exportObject.

Параметры:

location - расположение для классов для этого объекта

data - данные инициализации объекта

port - порт, на котором экспортируется объект (анонимный порт используется если port=0),

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

Броски:

ActivationException - если объектная регистрация перестала работать.

RemoteException - если любой из следующих сбоев: a), регистрирующий объект в системе активации или b), экспортирующем объект во время выполнения RMI.

С тех пор:

1.2

Activatable

protected Activatable(String location,
           MarshalledObject<?> data,
           boolean restart,
           int port,
           RMIClientSocketFactory csf,
           RMIServerSocketFactory ssf)
               throws ActivationException,
                      RemoteException

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

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

Этот метод вызывает exportObject метод с этим объектом, и указанное расположение, данные, перезапускает режим, порт, и фабрики сокета клиента и сервера. Последующие звонки getID() возвратит идентификатор активации, возвращенный из звонка exportObject.

Параметры:

location - расположение для классов для этого объекта

data - данные инициализации объекта

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

port - порт, на котором экспортируется объект (анонимный порт используется если port=0),

csf - фабрика сокета клиентской стороны для того, чтобы сделать звонки в удаленный объект

ssf - фабрика сокета серверной стороны для того, чтобы прием в соответствии с удаленными вызовами

Броски:

ActivationException - если объектная регистрация перестала работать.

RemoteException - если любой из следующих сбоев: a), регистрирующий объект в системе активации или b), экспортирующем объект во время выполнения RMI.

С тех пор:

1.2

Activatable

protected Activatable(ActivationID id,
           int port)
               throws RemoteException

Конструктор имел обыкновение активировать/экспортировать объект на указанном порту. У "activatable" удаленного объекта должен быть конструктор, который берет два параметра:

• идентификатор активации объекта (ActivationID), и
• данные инициализации объекта (a MarshalledObject).

Конкретный подкласс этого класса должен вызвать этого конструктора, когда это активируется через двух конструкторов параметра, описанных выше. Как побочный эффект конструкции, удаленный объект "экспортируется" во время выполнения RMI (на указанном port) и доступно, чтобы принять входящие вызовы от клиентов.

Параметры:

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

port - номер порта, на котором экспортируется объект

Броски:

RemoteException - экспортируя объект в сбои времени выполнения RMI

С тех пор:

1.2

Activatable

protected Activatable(ActivationID id,
           int port,
           RMIClientSocketFactory csf,
           RMIServerSocketFactory ssf)
               throws RemoteException

Конструктор имел обыкновение активировать/экспортировать объект на указанном порту. У "activatable" удаленного объекта должен быть конструктор, который берет два параметра:

• идентификатор активации объекта (ActivationID), и
• данные инициализации объекта (a MarshalledObject).

Конкретный подкласс этого класса должен вызвать этого конструктора, когда это активируется через двух конструкторов параметра, описанных выше. Как побочный эффект конструкции, удаленный объект "экспортируется" во время выполнения RMI (на указанном port) и доступно, чтобы принять входящие вызовы от клиентов.

Параметры:

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

port - номер порта, на котором экспортируется объект

csf - фабрика сокета клиентской стороны для того, чтобы сделать звонки в удаленный объект

ssf - фабрика сокета серверной стороны для того, чтобы прием в соответствии с удаленными вызовами

Броски:

RemoteException - экспортируя объект в сбои времени выполнения RMI

С тех пор:

1.2

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

getID

protected ActivationID getID()

Возвращает идентификатор активации объекта. Метод защищается так, чтобы только подклассы могли получить идентификатор объекта.

Возвраты:

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

С тех пор:

1.2

регистр

public static Remote register(ActivationDesc desc)
                       throws UnknownGroupException,
                              ActivationException,
                              RemoteException

Зарегистрируйте объектный дескриптор для activatable удаленного объекта так, чтобы был, может быть активирован по требованию.

Параметры:

desc - дескриптор объекта

Возвраты:

тупик для activatable удаленного объекта

Броски:

UnknownGroupException - если групповой идентификатор в desc не регистрируется в системе активации

ActivationException - если система активации не работает

RemoteException - если удаленный вызов перестал работать

С тех пор:

1.2

неактивный

public static boolean inactive(ActivationID id)
                        throws UnknownObjectException,
                               ActivationException,
                               RemoteException

Сообщает системе что объект с соответствующей активацией id в настоящий момент неактивно. Если объект является в настоящий момент активным, объект "неэкспортируется" со времени выполнения RMI (только если нет никакого ожидания, или происходящий вызывает) так, что это больше не может получить входящие вызовы. Этот вызов сообщает ActivationGroup этого VM, что объект неактивен, который, поочередно, сообщает его ActivationMonitor. Если этот вызов завершается успешно, последующее активируются, запрос к активатору вызовет объект оживить. Работа может все еще успешно выполниться, если объект считают активным, но уже неэкспортировал себя.

Параметры:

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

Возвраты:

у истины, если работа успешно выполняется (работа успешно выполнится, если объект в в настоящий момент известный быть активным и будет или уже неэкспортироваться или будет в настоящий момент экспортироваться и нет никаких ожидающих/выполняющихся вызовов); false возвращается, если у объекта есть ожидающие/выполняющиеся вызовы, когда это не может быть деактивировано

Броски:

UnknownObjectException - если объект не известен (это может уже быть неактивно),

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

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

С тех пор:

1.2

нерегистр

public static void unregister(ActivationID id)
                       throws UnknownObjectException,
                              ActivationException,
                              RemoteException

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

Параметры:

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

Броски:

UnknownObjectException - если объект (id) неизвестно

ActivationException - если система активации не работает

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

С тех пор:

1.2

exportObject

public static ActivationID exportObject(Remote obj,
                        String location,
                        MarshalledObject<?> data,
                        boolean restart,
                        int port)
                                 throws ActivationException,
                                        RemoteException

Регистрирует дескриптор активации (в указанном расположении, данных, и режиме перезапуска) для указанного объекта, и экспорта, который возражает с указанным портом.

Отметьте: Используя этот метод (так же как Activatable конструкторы, которые и регистрируют и экспортируют activatable удаленный объект) строго обескураживается, потому что действия регистрации и экспорта удаленного объекта, как гарантируют, не будут атомарными. Вместо этого приложение должно зарегистрировать дескриптор активации и экспортировать удаленный объект отдельно, так, чтобы исключения могли быть обработаны должным образом.

Этот метод вызывает exportObject метод с указанным объектом, расположением, данными, перезапускает режим, и порт, и null и для фабрик сокета клиента и сервера, и для затем возвращает получающийся идентификатор активации.

Параметры:

obj - экспортируемый объект

location - участок кода объекта

data - данные начальной загрузки объекта

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

port - порт, на котором экспортируется объект (анонимный порт используется если port=0),

Возвраты:

идентификатор активации, полученный из регистрации дескриптора, desc, с системой активации неправильная группа

Броски:

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

RemoteException - если объектная регистрация или сбои экспорта

С тех пор:

1.2

exportObject

public static ActivationID exportObject(Remote obj,
                        String location,
                        MarshalledObject<?> data,
                        boolean restart,
                        int port,
                        RMIClientSocketFactory csf,
                        RMIServerSocketFactory ssf)
                                 throws ActivationException,
                                        RemoteException

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

Отметьте: Используя этот метод (так же как Activatable конструкторы, которые и регистрируют и экспортируют activatable удаленный объект) строго обескураживается, потому что действия регистрации и экспорта удаленного объекта, как гарантируют, не будут атомарными. Вместо этого приложение должно зарегистрировать дескриптор активации и экспортировать удаленный объект отдельно, так, чтобы исключения могли быть обработаны должным образом.

Этот метод первые регистры дескриптор активации для указанного объекта следующим образом. Это получает систему активации, вызывая метод ActivationGroup.getSystem. Этот метод тогда получает ActivationID для объекта, вызывая систему активации registerObject метод с ActivationDesc созданный с именем класса указанного объекта, и указанным расположением, данными, и режимом перезапуска. Если исключение происходит, получая систему активации или регистрируя дескриптор активации, то исключение выдается к вызывающей стороне.

Затем, этот метод экспортирует объект, вызывая exportObject метод с указанным удаленным объектом, идентификатор активации, полученный из регистрации, указанного порта, и указанного клиента и сервера, снабжает фабрики сокетом. Если исключение происходит, экспортируя объект, этот метод пытается незарегистрировать идентификатор активации (полученный из регистрации), вызывая систему активации unregisterObject метод с идентификатором активации. Если исключение происходит, нерегистрируя идентификатор, то исключение игнорируется, и исходное исключение, которое произошло, экспортируя объект, выдается к вызывающей стороне.

Наконец, этот метод вызывает activeObject метод на группе активации в этом VM с идентификатором активации и указанным удаленным объектом, и возвратами идентификатор активации к вызывающей стороне.

Параметры:

obj - экспортируемый объект

location - участок кода объекта

data - данные начальной загрузки объекта

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

port - порт, на котором экспортируется объект (анонимный порт используется если port=0),

csf - фабрика сокета клиентской стороны для того, чтобы сделать звонки в удаленный объект

ssf - фабрика сокета серверной стороны для того, чтобы прием в соответствии с удаленными вызовами

Возвраты:

идентификатор активации, полученный из регистрации дескриптора с системой активации

Броски:

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

RemoteException - если объектная регистрация или сбои экспорта

С тех пор:

1.2

exportObject

public static Remote exportObject(Remote obj,
                  ActivationID id,
                  int port)
                           throws RemoteException

Экспортируйте activatable удаленный объект во время выполнения RMI, чтобы сделать объект доступным, чтобы получить входящие вызовы. Объект экспортируется на анонимном порту, если port нуль.

Во время активации, этого exportObject метод должен быть вызван явно объектом "activatable", который не расширяется Activatable класс. Нет никакой потребности в объектах, которые действительно расширяются Activatable класс, чтобы вызвать этот метод непосредственно, потому что объект экспортируется во время конструкции.

Параметры:

obj - реализация удаленного объекта

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

port - порт, на котором экспортируется объект (анонимный порт используется если port=0),

Возвраты:

тупик для activatable удаленного объекта

Броски:

RemoteException - если объект экспортирует сбои

С тех пор:

1.2

exportObject

public static Remote exportObject(Remote obj,
                  ActivationID id,
                  int port,
                  RMIClientSocketFactory csf,
                  RMIServerSocketFactory ssf)
                           throws RemoteException

Экспортируйте activatable удаленный объект во время выполнения RMI, чтобы сделать объект доступным, чтобы получить входящие вызовы. Объект экспортируется на анонимном порту, если port нуль.

Во время активации, этого exportObject метод должен быть вызван явно объектом "activatable", который не расширяется Activatable класс. Нет никакой потребности в объектах, которые действительно расширяются Activatable класс, чтобы вызвать этот метод непосредственно, потому что объект экспортируется во время конструкции.

Параметры:

obj - реализация удаленного объекта

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

port - порт, на котором экспортируется объект (анонимный порт используется если port=0),

csf - фабрика сокета клиентской стороны для того, чтобы сделать звонки в удаленный объект

ssf - фабрика сокета серверной стороны для того, чтобы прием в соответствии с удаленными вызовами

Возвраты:

тупик для activatable удаленного объекта

Броски:

RemoteException - если объект экспортирует сбои

С тех пор:

1.2

unexportObject

public static boolean unexportObject(Remote obj,
                     boolean force)
                              throws NoSuchObjectException

Удалите удаленный объект, obj, со времени выполнения RMI. В случае успеха объект больше не может принять входящие вызовы RMI. Если параметр силы является истиной, объект насильственно неэкспортируется, даже если там ожидают, призывает к удаленному объекту, или у удаленного объекта все еще есть происходящие вызовы. Если параметр силы является ложью, объект только неэкспортируется, если нет никакого ожидания, или происходящий призывает к объекту.

Параметры:

obj - удаленный объект, который будет неэкспортирован

force - если это правда, неэкспортирует объект, даже если там ожидают, или происходящий вызывает; если ложь, только неэкспортирует объект, если нет никакого ожидания, или происходящий вызывает

Возвраты:

истина, если работа успешна, ложна иначе

Броски:

NoSuchObjectException - если удаленный объект в настоящий момент не экспортируется

С тех пор:

1.2