Интерфейс RemoteRef

Все суперинтерфейсы:: Externalizable, Serializable

Все известные подинтерфейсы:: ServerRef

public interface RemoteRef extends Externalizable

RemoteRef представляет собой дескриптор удаленного объекта. RemoteStub использует удалённую ссылку для выполнения вызова удалённого метода удалённого объекта.

С тех пор:

1.1

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`packagePrefix`	Инициализирует префикс пакета сервера: предполагает, что реализация классов ссылок сервера (например, UnicastRef, UnicastServerRef) находится в пакете, определённом префиксом.
`static final long`	`serialVersionUID`	Устарело. Поле `serialVersionUID` в интерфейсе неэффективно.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`done(RemoteCall call)`	Устарело. Сводки стиля 1.2 больше не используют этот метод.
`String`	`getRefClass(ObjectOutput out)`	Возвращает имя класса типа ссылки, который необходимо сериализовать в поток 'out'.
`Object`	`invoke(Remote obj, Method method, Object[] params, long opnum)`	Вызов метода.
`void`	`invoke(RemoteCall call)`	Устарело. Сводки стиля 1.2 больше не используют этот метод.
`RemoteCall`	`newCall(RemoteObject obj, Operation[] op, int opnum, long hash)`	Устарело. Сводки стиля 1.2 больше не используют этот метод.
`boolean`	`remoteEquals(RemoteRef obj)`	Сравнивает два удалённых объекта на равенство.
`int`	`remoteHashCode()`	Возвращает хеш-код для удалённого объекта.
`String`	`remoteToString()`	Возвращает строку, представляющую ссылку этого удалённого объекта.

Методы, объявленные в интерфейсе java.io.Externalizable

readExternal, writeExternal

Подробное описание полей

serialVersionUID

@Deprecated static final long serialVersionUID

Устарело.

Поле serialVersionUID в интерфейсе неэффективно. Не использовать; замены нет.

указывает на совместимость с JDK 1.1.x версией класса.

См. также:

packagePrefix

static final String packagePrefix

Инициализирует префикс пакета сервера: предполагается, что реализация классов ссылок сервера (например, UnicastRef, UnicastServerRef) находится в пакете, определённом префиксом.

См. также:

Подробное описание методов

invoke

Object invoke(Remote obj, Method method, Object[] params, long opnum) throws Exception

Вызов метода. Этот способ делегирования вызова метода на ссылку позволяет ссылке позаботиться о настройке соединения с удалённым хостом, сериализации представления метода и параметров, а затем передать вызов метода удалённому хосту. Этот метод либо возвращает результат вызова метода на удалённом объекте, находящемся на удалённом хосте, либо выбрасывает RemoteException, если вызов не удался, или исключение прикладного уровня, если удалённый вызов сгенерировал исключение.

Параметры:: obj - объект, содержащий RemoteRef (например, RemoteStub для объекта).; method - вызываемый метод; params - список параметров; opnum - хэш, который может быть использован для представления метода
Возвращает:: результат вызова удалённого метода
Исключения:: Exception - если возникло какое-либо исключение во время вызова удалённого метода
С:: 1.2

newCall

@Deprecated RemoteCall newCall(RemoteObject obj, Operation[] op, int opnum, long hash) throws RemoteException

Устарело.

Образцы стиля 1.2 больше не используют этот метод. Вместо использования последовательности вызовов методов на удалённой ссылке объекта (newCall, invoke, и done), образец использует единственный метод

invoke(Remote, Method, Object[],
 int)

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

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

Параметры:

obj - удалённый образец через который сделать вызов

op - массив операций образца

opnum - номер операции

hash - хэш интерфейса образец/скелет

Возвращает:

объект вызова, представляющий удалённый вызов

Исключения:

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

С:

1.1

См. также:

invoke

@Deprecated void invoke(RemoteCall call) throws Exception

Устарело.

Образцы стиля 1.2 больше не используют этот метод. Вместо использования последовательности вызовов методов на удалённую ссылку (newCall, invoke, и done), образец использует единственный метод

invoke(Remote, Method, Object[],
 int)

Выполняет удалённый вызов. Invoke поднимет любые "пользовательские" исключения, которые должны проходить сквозь и не перехватываться образцом. Если во время удалённого вызова возникает какое-либо исключение, invoke должен позаботиться об очистке соединения перед подъёмом "пользовательского" или удалённого исключения.

Параметры:

call - объект, представляющий удалённый вызов

Исключения:

Exception - если возникло какое-либо исключение при удалённом методе

С:

1.1

См. также:

done

@Deprecated void done(RemoteCall call) throws RemoteException

Устарело.

invoke(Remote, Method, Object[],
 int)

Позволяет удалённой ссылке очистить (или повторно использовать) соединение. Done должен вызываться только в том случае, если invoke возвращает успешно (без исключений) в образец.

Параметры:

call - объект, представляющий удалённый вызов

Исключения:

RemoteException - если возникает удалённая ошибка во время очистки вызова

С:

1.1

См. также:

getRefClass

String getRefClass(ObjectOutput out)

Возвращает имя класса типа ссылки, который должен быть сериализован в поток 'out'.

Параметры:: out - поток вывода, в который будет сериализована ссылка
Возвращает:: имя класса (без квалификации пакета) типа ссылки
С:: 1.1

remoteHashCode

int remoteHashCode()

Возвращает хэш-код для удалённого объекта. Два удалённых объекта-образца, которые ссылаются на один и тот же удалённый объект, будут иметь одинаковый хэш-код (для поддержки удалённых объектов в качестве ключей в хэш-таблицах).

Возвращает:

хэш-код удалённого объекта

С:

1.1

См. также:

remoteEquals

boolean remoteEquals(RemoteRef obj)

Сравнивает два удалённых объекта на равенство. Возвращает булево значение, указывающее, эквивалентен ли этот удалённый объект указанному объекту. Этот метод используется, когда удалённый объект хранится в хэш-таблице.

Параметры:

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

Возвращает:

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

С:

1.1

См. также:

remoteToString

String remoteToString()

Возвращает строку, представляющую ссылку на этот удалённый объект.

Возвращает:: строка, представляющая ссылку удалённого объекта
С:: 1.1

© 1993, 2023, 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/21/docs/api/java.rmi/java/rmi/server/RemoteRef.html