Класс 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 и non-abstract.
• Класс прокси наследуется от 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. если все интерфейсы прокси являются public, класс прокси будет public и находиться в безусловно экспортируемом, но не открытом пакете. Имя пакета и модуля не определено.
   2. если хотя бы один из интерфейсов прокси является non-public, класс прокси будет non-public и находиться в пакете и модуле интерфейсов, не являющихся public. Все интерфейсы, не являющиеся public, должны находиться в одном пакете и модуле; в противном случае проксирование невозможно.
2. Если хотя бы один интерфейс прокси находится в пакете, который является неэкспортируемым и неоткрытым:
   1. если все интерфейсы прокси являются public, класс прокси будет public и находиться в неэкспортируемом, неоткрытом пакете динамического модуля. Имена пакета и модуля не определены.
   2. если хотя бы один из интерфейсов прокси является non-public, класс прокси будет non-public и находиться в пакете и модуле интерфейсов, не являющихся public. Все интерфейсы, не являющиеся public, должны находиться в одном пакете и модуле; в противном случае проксирование невозможно.

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

Обратите внимание: произвольный код может получить доступ к классу прокси в открытом пакете с помощью 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.