java.rmi.server

Класс RemoteObjectInvocationHandler

java.lang. Объект

java.rmi.server. RemoteObject

java.rmi.server.RemoteObjectInvocationHandler

Все Реализованные Интерфейсы:

Сериализуемый, InvocationHandler, Удаленный

public class RemoteObjectInvocationHandler
extends RemoteObject
implements InvocationHandler

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

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

С тех пор:

1.5

См. Также:

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

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

Поля java.rmi.server унаследованный от класса. RemoteObject

касательно

Сводка конструктора

Конструкторы

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

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

Методы

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

Методы java.rmi.server унаследованный от класса. RemoteObject

equals, getRef, hashCode, toString, toStub

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

RemoteObjectInvocationHandler

public RemoteObjectInvocationHandler(RemoteRef ref)

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

Параметры:

ref - удаленное касательно

Броски:

NullPointerException - если ref null

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

вызвать

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

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

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

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

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

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

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

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

Определенный:

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

Параметры:

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

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

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

Возвраты:

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

Броски:

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

См. Также:

UndeclaredThrowableException