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

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

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

       proxy instanceof Foo
   

  , и следующая операция приведения типов будет успешной (вместо выброса исключения %%%CODE_BLOCK_26%%):

       (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 для метода в первом интерфейсе, содержащем метод (прямо или через наследование суперинтерфейса) в списке интерфейсов класса-прокси, передаётся обработчику вызовов методу invoke, независимо от типа ссылки, через который произошёл вызов метода.

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

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