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