compact1, compact2, compact3

java.lang.invoke

Класс MethodHandleProxies

java.lang. Объект

java.lang.invoke. MethodHandleProxies

public class MethodHandleProxies
extends Object

Этот class состоит исключительно из статических методов, что справка адаптирует дескрипторы метода к другим типам JVM, таким как интерфейсы.

Сводка метода

Модификатор и Тип	Метод и Описание
static <T> T	asInterfaceInstance(Class<T> intfc, MethodHandle target) Производит экземпляр данного интерфейса единственного метода, который перенаправляет его звонки в данный дескриптор метода.
static boolean	isWrapperInstance(Object x) Определяет, был ли данный объект произведен звонком asInterfaceInstance.
static MethodHandle	wrapperInstanceTarget(Object x) Производит или восстанавливает целевой дескриптор метода, который поведенчески эквивалентен уникальному методу этого экземпляра обертки.
static Class<?>	wrapperInstanceType(Object x) Восстанавливает уникальный тип интерфейса единственного метода, для которого создавался этот экземпляр обертки.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь метода

asInterfaceInstance

public static <T> T asInterfaceInstance(Class<T> intfc,
                                        MethodHandle target)

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

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

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

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

Уникально именованному методу позволяют быть, умножаются объявленный, с отличными дескрипторами типа. (Например, это может быть перегружено, или может обладать мостовыми методами.) Все такие объявления соединяются непосредственно с целевым дескриптором метода. Параметр и типы возврата корректируются asType для каждого отдельного объявления.

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

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

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

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

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

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

Параметры:

target - дескриптор метода, чтобы вызвать от обертки

intfc - требуемый тип обертки, интерфейса единственного метода

Возвраты:

правильно введенная обертка для данной цели

Броски:

NullPointerException - если любым параметром является нуль

IllegalArgumentException - если intfc не допустимый параметр этому методу

WrongMethodTypeException - если цель не может быть преобразована в тип, требуемый требуемым интерфейсом

isWrapperInstance

public static boolean isWrapperInstance(Object x)

Определяет, был ли данный объект произведен звонком asInterfaceInstance.

Параметры:

x - любая ссылка

Возвраты:

истина, если ссылка не является нулем и указывает на объект, произведенный asInterfaceInstance

wrapperInstanceTarget

public static MethodHandle wrapperInstanceTarget(Object x)

Производит или восстанавливает целевой дескриптор метода, который поведенчески эквивалентен уникальному методу этого экземпляра обертки. Объект x должно быть, был произведен звонком asInterfaceInstance. Это требование может быть протестировано через isWrapperInstance.

Параметры:

x - любая ссылка

Возвраты:

дескриптор метода, реализовывая уникальный метод

Броски:

IllegalArgumentException - если ссылка x не к экземпляру обертки

wrapperInstanceType

public static Class<?> wrapperInstanceType(Object x)

Восстанавливает уникальный тип интерфейса единственного метода, для которого создавался этот экземпляр обертки. Объект x должно быть, был произведен звонком asInterfaceInstance. Это требование может быть протестировано через isWrapperInstance.

Параметры:

x - любая ссылка

Возвраты:

интерфейс единственного метода вводит, для которого создавалась обертка

Броски:

IllegalArgumentException - если ссылка x не к экземпляру обертки