Класс RemoteObjectInvocationHandler

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteObjectInvocationHandler

Все реализованные интерфейсы:: Serializable, InvocationHandler, Remote

public class RemoteObjectInvocationHandler extends RemoteObject implements InvocationHandler

Реализация интерфейса InvocationHandler для использования с Java Remote Method Invocation (Java RMI). Этот обработчик вызовов может быть использован совместно с экземпляром динамического прокси для замены предварительно сгенерированного класса-заглушки.

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

С тех пор:

1.5

См. также:

Сериализованная форма

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

Поля, объявленные в классе java.rmi.server.RemoteObject

ref

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

Конструктор	Описание
`RemoteObjectInvocationHandler(RemoteRef ref)`	Создаёт новый `RemoteObjectInvocationHandler` с указанным `RemoteRef`.

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

Модификатор и тип	Метод	Описание
`Object`	`invoke(Object proxy, Method method, Object[] args)`	Обрабатывает вызов метода на экземпляре обернутого прокси-объекта, `proxy`, и возвращает результат.

Методы, объявленные в классе java.rmi.server.RemoteObject

equals, getRef, hashCode, toString, toStub

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

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

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

RemoteObjectInvocationHandler

public RemoteObjectInvocationHandler(RemoteRef ref)

Создаёт новый RemoteObjectInvocationHandler с указанным RemoteRef.

Параметры:: ref - удалённая ссылка
Исключения:: NullPointerException - если ref является null

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

invoke

public Object invoke(Object proxy, Method method, Object[] args) throws Throwable

Обрабатывает вызов метода на экземпляре обернутого прокси-объекта, proxy, и возвращает результат.

RemoteObjectInvocationHandler реализует этот метод следующим образом:

Если method является одним из следующих методов, он обрабатывается, как описано ниже:

Object.hashCode: Возвращает значение хэш-кода для прокси.
Object.equals: Возвращает true если аргумент (args[0]) является экземпляром класса динамического прокси и этот обработчик вызовов равен обработчику вызовов этого аргумента, и возвращает false в противном случае.
Object.toString: Возвращает строковое представление прокси.

Если method переопределяет Object.finalize, он игнорируется.

В противном случае, удалённый вызов выполняется следующим образом:

Если proxy не является экземпляром интерфейса Remote, то выбрасывается IllegalArgumentException.
В противном случае вызывается метод invoke на удалённой ссылке этого обработчика вызовов, передавая proxy, method, args, и хэш-код метода (определённый в разделе 8.3 спецификации "Java Remote Method Invocation (RMI)") для method, и возвращается результат.
Если исключение выбрасывается методом RemoteRef.invoke и это исключение является проверяемым исключением, которое не может быть присвоено ни одному исключению в блоке throws метода, реализованного классом proxy, то это исключение обертывается в UnexpectedException и обернутое исключение выбрасывается. В противном случае, исключение, сгенерированное методом invoke, выбрасывается этим методом.

Семантика этого метода не определена, если аргументы не могут быть получены экземпляром некоторого допустимого класса динамического прокси, содержащего этот обработчик вызовов.

Определено в:

invoke в интерфейсе InvocationHandler

Параметры:

proxy - экземпляр прокси, на котором был вызван метод

method - экземпляр Method, соответствующий методу интерфейса, вызванному на экземпляре прокси

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

Возвращает:

значение, которое должно быть возвращено из вызова метода на экземпляре прокси

Исключения:

Throwable - исключение, которое должно быть выброшено при вызове метода на экземпляре прокси

См. также:

UndeclaredThrowableException

© 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/RemoteObjectInvocationHandler.html