Интерфейс RemoteRef
- Все суперинтерфейсы:
-
Externalizable,Serializable
- Все известные подинтерфейсы:
ServerRef
public interface RemoteRef extends Externalizable
RemoteRef представляет собой дескриптор удалённого объекта. RemoteStub использует удалённую ссылку для выполнения удалённого вызова метода удалённому объекту.- С:
- 1.1
- См. также:
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final String |
packagePrefix |
Инициализирует префикс пакета сервера: предполагается, что реализация классов ссылок сервера (например, UnicastRef, UnicastServerRef) находится в пакете, определённом префиксом. |
static final long |
serialVersionUID |
Устаревший. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
done |
Устаревший. Стыки в стиле 1.2 больше не используют этот метод. |
String |
getRefClass |
Возвращает имя класса типа ссылки, который должен быть сериализован в поток 'out'. |
Object |
invoke |
Вызов метода. |
void |
invoke |
Устаревший. Стыки в стиле 1.2 больше не используют этот метод. |
RemoteCall |
newCall |
Устаревший. Стыки в стиле 1.2 больше не используют этот метод. |
boolean |
remoteEquals |
Сравнивает два удалённых объекта на равенство. |
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
Устарело.
Подстановки стиля 1.2 больше не используют этот метод. Вместо использования последовательности вызовов методов на удаленной ссылке (
newCall, invoke, и done), подстановка использует один метод 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)
Сравнивает два удаленных объекта на равенство. Возвращает boolean, указывающий, эквивалентен ли этот удаленный объект указанному объекту. Этот метод используется, когда удаленный объект хранится в хеш-таблице.
- Параметры:
-
obj- объект для сравнения - Возвращает:
- true, если эти объекты равны; false в противном случае.
- С тех пор:
- 1.1
- См. также:
remoteToString
String remoteToString()
Возвращает строку, представляющую ссылку на этот удаленный объект.
- Возвращает:
- строка, представляющая ссылку на удаленный объект
- С тех пор:
- 1.1
© 1993, 2021, 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/17/docs/api/java.rmi/java/rmi/server/RemoteRef.html
serialVersionUIDв интерфейсе неэффективно.