java.rmi.server

Интерфейсный RemoteRef

Все Суперинтерфейсы:

Externalizable, Сериализуемый

Все Известные Подынтерфейсы:

ServerRef

public interface RemoteRef
extends Externalizable

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

С тех пор:

JDK1.1

См. Также:

RemoteStub

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

Поля

Модификатор и Тип	Поле и Описание
static String	packagePrefix Инициализируйте префикс пакета сервера: предполагает, что реализация сервера касательно классов (например, UnicastRef, UnicastServerRef) располагается в пакете, определенном префиксом.
static long	serialVersionUID укажите на совместимость с JDK 1.1.x версия класса.

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

Методы

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

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

readExternal, writeExternal

Полевая Деталь

serialVersionUID

static final long serialVersionUID

укажите на совместимость с JDK 1.1.x версия класса.

См. Также:

Постоянные Значения полей

packagePrefix

static final String packagePrefix

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

См. Также:

Постоянные Значения полей

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

вызвать

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 - если отказавший инициировать новый удаленный вызов

С тех пор:

JDK1.1

См. Также:

invoke(Remote,java.lang.reflect.Method,Object[],long)

вызвать

@Deprecated
void invoke(RemoteCall call)
            throws Exception

Осуждаемый. 1.2 тупика стиля больше не используют этот метод. Вместо того, чтобы использовать последовательность вызовов метода удаленной ссылки (newCall, invoke, и done), тупик использует единственный метод, invoke(Remote, Method, Object[], int), на удаленной ссылке, чтобы выполнить маршалинг параметра, отдалите выполнение метода и немаршалинг возвращаемого значения.

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

Параметры:

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

Броски:

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

С тех пор:

JDK1.1

См. Также:

invoke(Remote,java.lang.reflect.Method,Object[],long)

сделанный

@Deprecated
void done(RemoteCall call)
          throws RemoteException

Осуждаемый. 1.2 тупика стиля больше не используют этот метод. Вместо того, чтобы использовать последовательность вызовов метода удаленной ссылки (newCall, invoke, и done), тупик использует единственный метод, invoke(Remote, Method, Object[], int), на удаленной ссылке, чтобы выполнить маршалинг параметра, отдалите выполнение метода и немаршалинг возвращаемого значения.

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

Параметры:

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

Броски:

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

С тех пор:

JDK1.1

См. Также:

invoke(Remote,java.lang.reflect.Method,Object[],long)

getRefClass

String getRefClass(ObjectOutput out)

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

Параметры:

out - поток вывода, к которому будет сериализирована ссылка

Возвраты:

имя класса (без квалификации пакета) ссылочного типа

С тех пор:

JDK1.1

remoteHashCode

int remoteHashCode()

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

Возвраты:

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

С тех пор:

JDK1.1

См. Также:

Hashtable

remoteEquals

boolean remoteEquals(RemoteRef obj)

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

Параметры:

obj - Объект сравниться с

Возвраты:

истина, если эти Объекты равны; ложь иначе.

С тех пор:

JDK1.1

См. Также:

Hashtable

remoteToString

String remoteToString()

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

Возвраты:

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

С тех пор:

JDK1.1