Интерфейс InvocationHandler

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

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

static Object invokeDefault(Object proxy, Method method, Object... args) throws Throwable

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

Вызов этого метода ведёт себя так, как если бы invokespecial инструкция выполнена из класса прокси, нацеленная на метод по умолчанию в интерфейсе прокси. Это эквивалентно вызову: X.super.m(A* a), где X является интерфейсом прокси, и вызов X.super::m(A*) резолвится в данный method.

Примеры: интерфейс A и B оба объявляют реализацию по умолчанию метода m. Интерфейс C расширяет A и наследует метод по умолчанию m от своего суперинтерфейса A.

 interface A {
     default T m(A a) { return t1; }
 }
 interface B {
     default T m(A a) { return t2; }
 }
 interface C extends A {}
 

Следующее создаёт экземпляр прокси, реализующий A и вызывает метод по умолчанию A::m.

 Object proxy = Proxy.newProxyInstance(loader, new Class<?>[] { A.class },
         (o, m, params) -> {
             if (m.isDefault()) {
                 // if it's a default method, invoke it
                 return InvocationHandler.invokeDefault(o, m, params);
             }
         });
 

Если экземпляр прокси реализует как A, так и B, оба из которых предоставляют реализацию по умолчанию метода m, обработчик вызовов может передать вызов метода к A::m или B::m через метод invokeDefault. Например, следующий код делегирует вызов метода к B::m.

 Object proxy = Proxy.newProxyInstance(loader, new Class<?>[] { A.class, B.class },
         (o, m, params) -> {
             if (m.getName().equals("m")) {
                 // invoke B::m instead of A::m
                 Method bMethod = B.class.getMethod(m.getName(), m.getParameterTypes());
                 return InvocationHandler.invokeDefault(o, bMethod, params);
             }
         });
 

Если экземпляр прокси реализует C, который наследует метод по умолчанию m от своего суперинтерфейса A, тогда вызов метода интерфейса на "m" передаётся обработчику вызовов в метод invoke с аргументом объекта Method, представляющим метод по умолчанию A::m.

 Object proxy = Proxy.newProxyInstance(loader, new Class<?>[] { C.class },
        (o, m, params) -> {
             if (m.isDefault()) {
                 // behaves as if calling C.super.m(params)
                 return InvocationHandler.invokeDefault(o, m, params);
             }
        });
 

Вызов метода "m" на этом proxy будет вести себя так, как если бы C.super::m был вызван, и это привело к вызову A::m.

Добавление метода по умолчанию или изменение метода из абстрактного в метод по умолчанию может вызвать исключение, если существующий код пытается вызвать invokeDefault для вызова метода по умолчанию. Например, если C изменяется, чтобы реализовать метод по умолчанию m:

 interface C extends A {
     default T m(A a) { return t3; }
 }
 

Код выше, который создаёт экземпляр прокси proxy с изменённым C будет выполняться без исключений, и это приведёт к вызову C::m вместо A::m.

Следующий пример создаёт экземпляр прокси C и обработчик вызовов вызывает метод invokeDefault для вызова A::m:

 C c = (C) Proxy.newProxyInstance(loader, new Class<?>[] { C.class },
         (o, m, params) -> {
             if (m.getName().equals("m")) {
                 // IllegalArgumentException thrown as {@code A::m} is not a method
                 // inherited from its proxy interface C
                 Method aMethod = A.class.getMethod(m.getName(), m.getParameterTypes());
                 return InvocationHandler.invokeDefault(o, aMethod params);
             }
         });
 c.m(...);
 

Вышеприведённый код выполняется успешно со старой версией C и A::m вызывается. При запуске с новой версией C вышеуказанный код завершится с ошибкой IllegalArgumentException, потому что C перезаписывает реализацию того же метода, и A::m не доступен экземпляру прокси.