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