Класс MethodHandleProxies

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

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

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

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

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

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

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

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

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

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

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

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