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