Интерфейс InvocationHandler

public interface InvocationHandler

InvocationHandler является интерфейсом, реализуемым обработчиком вызовов экземпляра прокси.

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

Методы

invoke

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

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

Параметры:

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

method - экземпляр Method, соответствующий методу интерфейса, вызванному на экземпляре прокси. Объявляющий класс объекта Method будет интерфейсом, в котором метод был объявлен, что может быть суперинтерфейсом интерфейса прокси, по которому прокси-класс унаследовал метод.

args - массив объектов, содержащий значения аргументов, переданных в вызов метода на экземпляре прокси, или null, если метод интерфейса не принимает аргументы. Аргументы примитивных типов обернуты в экземпляры соответствующего класса обёртки примитивных типов, таких как java.lang.Integer или java.lang.Boolean.

Возвращает:

значение, которое должно быть возвращено из вызова метода на экземпляре прокси. Если объявленный тип возвращаемого значения метода интерфейса — примитивный тип, то возвращаемое значение этого метода должно быть экземпляром соответствующего класса обёртки примитивного типа; в противном случае оно должно быть типом, присваиваемым объявленному типу возвращаемого значения. Если возвращаемое значение этого метода равно null и тип возвращаемого значения метода интерфейса — примитивный тип, то метод вызова на экземпляре прокси выбросит NullPointerException. Если возвращаемое значение этого метода по другим причинам несовместимо с объявленным типом возвращаемого значения метода интерфейса, как описано выше, вызов метода на экземпляре прокси выбросит ClassCastException.

Бросает:

Throwable - исключение, которое необходимо бросить из вызова метода на экземпляре прокси. Тип исключения должен быть присваиваем любому из типов исключений, объявленных в разделе throws метода интерфейса, или к исключениям без проверки типа java.lang.RuntimeException или java.lang.Error. Если метод этого метода выбрасывает проверочное исключение, которое не присваивается ни одному из типов исключений, объявленных в разделе throws метода интерфейса, то метод вызова на экземпляре прокси выбросит UndeclaredThrowableException, содержащий исключение, которое было выброшено этим методом.

См. также:

UndeclaredThrowableException