Класс Proxy

     InvocationHandler handler = new MyInvocationHandler(...);
     Foo f = (Foo) Proxy.newProxyInstance(Foo.class.getClassLoader(),
                                          new Class<?>[] { Foo.class },
                                          handler);
 

Класс-прокси — это класс, созданный во время выполнения, который реализует указанный список интерфейсов, известных как прокси-интерфейсы. Экземпляр-прокси — это экземпляр класса-прокси. Каждый экземпляр-прокси связан с объектом обработчика вызовов, который реализует интерфейс InvocationHandler. Вызов метода на экземпляре-прокси через один из его прокси-интерфейсов будет перенаправлен на метод invoke объекта-обработчика вызовов, передавая экземпляр-прокси, объект java.lang.reflect.Method, идентифицирующий метод, который был вызван, и массив типа Object, содержащий аргументы. Обработчик вызовов обрабатывает закодированный вызов метода соответствующим образом, и возвращаемое им значение будет возвращено как результат вызова метода на экземпляре-прокси.

Класс-прокси обладает следующими свойствами:

• Неопределено полное имя класса-прокси. Однако область имён классов, начинающихся со строки "$Proxy", должна быть зарезервирована для классов-прокси.
• Пакет и модуль, в котором определен класс-прокси, указаны ниже.
• Класс-прокси является final и не абстрактным.
• Класс-прокси расширяет java.lang.reflect.Proxy.
• Класс-прокси реализует ровно те интерфейсы, которые были указаны при его создании, в том же порядке. Вызов getInterfaces на его Class объекте вернёт массив, содержащий тот же список интерфейсов (в указанном порядке при создании), вызов getMethods на его Class объекте вернёт массив Method объектов, включающий все методы в этих интерфейсах, и вызов getMethod найдёт методы в прокси-интерфейсах, как ожидается.
• ProtectionDomain класса-прокси совпадает с таковым у системных классов, загруженных загрузчиком базового класса, например, java.lang.Object.
• Метод Proxy.isProxyClass может быть использован для определения, является ли данный класс классом-прокси.

Экземпляр-прокси обладает следующими свойствами:

• Для экземпляра-прокси proxy и одного из реализуемых его классом-прокси интерфейсов Foo, следующее выражение вернёт true:

       proxy instanceof Foo
   

  и следующее приведение типов успешно выполнится (а не выбросит ClassCastException):

       (Foo) proxy
   

• Каждый экземпляр-прокси связан с обработчиком вызовов, переданным в его конструктор. Статический метод Proxy.getInvocationHandler вернёт обработчик вызовов, связанный с экземпляром-прокси, переданным в качестве аргумента.
• Вызов метода интерфейса на экземпляре-прокси будет закодирован и перенаправлен на метод invoke обработчика вызовов, как описано в документации для этого метода.
• Прокси-интерфейс может определять метод по умолчанию или унаследовать его от своего суперинтерфейса прямо или косвенно. Обработчик вызовов может вызвать метод по умолчанию прокси-интерфейса, вызвав InvocationHandler::invokeDefault.
• Вызов методов hashCode, equals или toString, объявленных в java.lang.Object, на экземпляре-прокси будет закодирован и перенаправлен на метод invoke обработчика вызовов таким же образом, как закодированы и перенаправлены вызовы методов интерфейсов, как описано выше. Класс-объявитель объекта Method, переданного в invoke, будет java.lang.Object. Другие общедоступные методы экземпляра-прокси, унаследованные от java.lang.Object, не переопределяются классом-прокси, поэтому вызовы этих методов ведут себя так же, как и для экземпляров java.lang.Object.

Принадлежность пакета и модуля классу-прокси

1. Если все прокси-интерфейсы находятся в экспортированных или открытых пакетах:
   1. если все прокси-интерфейсы являются публичными, то класс-прокси является публичным в безусловно экспортированном, но не открытом пакете. Имя пакета и модуля не определены.
   2. если хотя бы один из всех прокси-интерфейсов является непубличным, то класс-прокси является непубличным в пакете и модуле непубличных интерфейсов. Все непубличные интерфейсы должны находиться в одном пакете и модуле; в противном случае их проксирование невозможно.
2. Если хотя бы один прокси-интерфейс находится в пакете, который является неэкспортированным и неокрытым:
   1. если все прокси-интерфейсы являются публичными, то класс-прокси является публичным в неэкспортированном, неокрытом пакете динамического модуля. Имена пакета и модуля не определены.
   2. если хотя бы один из всех прокси-интерфейсов является непубличным, то класс-прокси является непубличным в пакете и модуле непубличных интерфейсов. Все непубличные интерфейсы должны находиться в одном пакете и модуле; в противном случае их проксирование невозможно.

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

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

В этом спецификации «неэкспортированный пакет» относится к пакету, который не экспортируется во все модули, а «неокрытый пакет» — к пакету, который не открыт для всех модулей. В частности, эти термины относятся к пакету, который либо не экспортирован/открыт содержащим его модулем, либо экспортирован/открыт в квалифицированном виде содержащим его модулем.

Динамические модули

Динамический модуль — это именованный модуль, генерируемый во время выполнения. Класс-прокси, определённый в динамическом модуле, является изолированным и недоступным для других модулей. Вызов Constructor.newInstance(Object...) на классе-прокси в динамическом модуле вызовет IllegalAccessException; вместо этого следует использовать метод Proxy.newProxyInstance.

Динамический модуль может считывать модули всех суперинтерфейсов класса-прокси и модули классов и интерфейсов, на которые ссылаются все общедоступные сигнатуры методов класса-прокси. Если суперинтерфейс или ссылаемый класс или интерфейс, скажем T, находится в неэкспортированном пакете, модуль T обновляется, чтобы экспортировать пакет T в динамический модуль.

Методы, дублированные в нескольких прокси-интерфейсах

Когда два или более прокси-интерфейса содержат метод с одинаковым именем и сигнатурой параметров, порядок интерфейсов класса-прокси становится существенным. При вызове такого дублирующего метода на экземпляре-прокси, объект Method, переданный обработчику вызовов, необязательно будет тем, чей объявляющий класс может быть приведён к типу ссылки интерфейса, через который метод прокси был вызван. Это ограничение существует, потому что соответствующая реализация метода в сгенерированном классе-прокси не может определить, через какой интерфейс он был вызван. Поэтому, когда дублирующий метод вызывается на экземпляре-прокси, объект Method для метода в самом верхнем интерфейсе, который содержит метод (либо напрямую, либо унаследован через суперинтерфейс) в списке интерфейсов класса-прокси, передаётся обработчику вызовов, независимо от типа ссылки, через который произошёл вызов метода.

Если прокси-интерфейс содержит метод с тем же именем и сигнатурой параметров, что и методы hashCode, equals или toString класса java.lang.Object, при вызове такого метода на экземпляре-прокси объект Method, переданный обработчику вызовов, будет иметь класс-объявитель java.lang.Object. Другими словами, общедоступные, не final методы класса java.lang.Object логически предшествуют всем прокси-интерфейсам для определения, какой объект Method передать обработчику вызовов.

Также обратите внимание, что когда дублирующий метод перенаправляется обработчику вызовов, метод invoke может выбрасывать только типы checked исключений, которые могут быть приведены к одному из типов исключений в разделе throws метода во всех прокси-интерфейсах, через которые он может быть вызван. Если метод invoke выбрасывает checked исключение, которое не приводимо ни к одному из типов исключений, объявленных методом в одном из прокси-интерфейсов, через которые он может быть вызван, тогда необрабатываемое UndeclaredThrowableException будет выброшено при вызове на экземпляре-прокси. Это ограничение означает, что не все типы исключений, возвращаемые при вызове getExceptionTypes на объекте Method, переданном методу invoke, обязательно могут быть успешно выброшены методом invoke.