Класс RemoteObjectInvocationHandler

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteObjectInvocationHandler

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

public class RemoteObjectInvocationHandler extends RemoteObject implements InvocationHandler

Реализация интерфейса InvocationHandler для использования с вызовом удаленных методов Java (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 - исключение, которое должно быть сгенерировано при вызове метода на экземпляре прокси

См. также:

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