Класс MethodHandleProxies

public static <T> T asInterfaceInstance(Class<T> intfc, MethodHandle target)

Создаёт экземпляр заданного интерфейса с одним методом, который перенаправляет вызовы на заданный обработчик метода.

Интерфейс с одним методом — это интерфейс, который объявляет единственный метод с уникальным именем. При определении уникального имени метода интерфейса с одним методом, публичные Object методы (toString, equals, hashCode) игнорируются, как и любые методы по умолчанию (не абстрактные). Например, Comparator является интерфейсом с одним методом, даже если он повторно объявляет метод Object.equals и также объявляет методы по умолчанию, такие как Comparator.reverse.

Интерфейс должен быть публичным и не запечатанным. Дополнительные проверки доступа не выполняются.

Результирующий экземпляр требуемого типа будет реагировать на вызов метода с уникальным именем типа, вызывая заданный обработчик на входных аргументах и возвращая или выбрасывая то, что возвращает или выбрасывает обработчик. Вызов будет выполнен как если бы он был произведён target.invoke. Тип обработчика будет проверен перед созданием экземпляра, как если бы был вызов asType, что может привести к WrongMethodTypeException.

Уникальный метод может быть многократно объявлен с различными описателями типов. (Например, он может быть перегружен или может иметь мостовые методы.) Все такие объявления напрямую связаны с целевым обработчиком метода. Аргументы и возвращаемые типы корректируются asType для каждого отдельного объявления.

Экземпляр обертки будет реализовывать запрашиваемый интерфейс и его супертипы, но не другие интерфейсы с одним методом. Это означает, что экземпляр не будет неожиданно проходить проверку типа instanceof для любого нетребуемого типа.

Примечание по реализации: Следовательно, каждый экземпляр должен реализовывать уникальный интерфейс с одним методом. Реализации не могут объединять несколько интерфейсов с одним методом на одном классе реализации по типу AWTEventMulticaster.

Обработчик метода может бросить необъявленное исключение, что означает любое проверяемое исключение (или другое проверяемое исключение) не объявленное единственным абстрактным методом запрашиваемого типа. Если это произойдёт, исключение будет обернуто в экземпляр UndeclaredThrowableException и брошено в этом обернутом виде.

Как и Integer.valueOf, asInterfaceInstance является фабричным методом, результаты которого определяются их поведением. Не гарантируется, что он будет возвращать новый экземпляр для каждого вызова.

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

Будущие версии этого API могут принять дополнительные типы, такие как абстрактные классы с одним абстрактным методом. Будущие версии этого API также могут оснастить экземпляры оберток одним или несколькими дополнительными публичными "маркерными" интерфейсами.

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

public static boolean isWrapperInstance(Object x)

Определяет, был ли данный объект создан вызовом asInterfaceInstance.

public static MethodHandle wrapperInstanceTarget(Object x)

Создаёт или восстанавливает целевой обработчик метода, который поведением эквивалентен уникальному методу этого экземпляра обертки. Объект x должен был быть создан вызовом asInterfaceInstance. Это требование может быть проверено с помощью isWrapperInstance.

public static Class<?> wrapperInstanceType(Object x)

Восстанавливает уникальный тип интерфейса с одним методом, для которого был создан этот экземпляр обертки. Объект x должен был быть создан вызовом asInterfaceInstance. Это требование может быть проверено с помощью isWrapperInstance.