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