Класс 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
   

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

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

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