Интерфейс MethodHandleInfo

public interface MethodHandleInfo

Символьная ссылка, полученная путем разбиения прямого обработчика метода на его составляющие символические части. Для разбиения прямого обработчика метода вызовите Lookup.revealDirect.

Прямые обработчики методов

Прямой обработчик метода представляет метод, конструктор или поле без каких-либо промежуточных привязок аргументов или других преобразований. Метод, конструктор или поле, на которые ссылается прямой обработчик метода, называется его основным членом. Прямые обработчики методов могут быть получены следующими способами:

Выполнив инструкцию ldc над константой CONSTANT_MethodHandle. (См. спецификацию Java Virtual Machine, разделы 4.4.8 и 5.4.3.)
Вызвав один из методов-фабрик методов Lookup, таких как Lookup.findVirtual, для разрешения символьной ссылки в обработчик метода. Символьная ссылка состоит из класса, имени строки и типа.
Вызвав метод-фабрику Lookup.unreflect или Lookup.unreflectSpecial для преобразования Method в обработчик метода.
Вызвав метод-фабрику Lookup.unreflectConstructor для преобразования Constructor в обработчик метода.
Вызвав метод-фабрику Lookup.unreflectGetter или Lookup.unreflectSetter для преобразования Field в обработчик метода.

Ограничения на разбиение

При наличии подходящего объекта Lookup, можно разбить любой прямой обработчик метода, чтобы восстановить символическую ссылку на основной метод, конструктор или поле. Разбиение должно выполняться с помощью объекта Lookup, эквивалентного объекту, который создал целевой обработчик метода, или с достаточными правами доступа для создания эквивалентного обработчика метода.

Если основной метод является чувствительным к вызывающей стороне, прямой обработчик метода будет «привязан» к определенному классу вызывающей стороны, классу выгляда объекта взгляда, используемого для его создания. Разбиение этого обработчика метода с другим классом взгляда потерпит неудачу, даже если основной метод является общедоступным (например, Class.forName).

Требование соответствия объекта взгляда обеспечивает «быстрое отклонение» для программ, которые в противном случае могут доверять ошибочному раскрытию обработчика метода с символической информацией (или привязкой вызывающей стороны) из неожиданного контекста. Используйте MethodHandles.reflectAs(java.lang.Class<T>, java.lang.invoke.MethodHandle) для отмены этого ограничения.

Виды ссылок

Методы-фабрики методов Lookup соответствуют всем основным случаям использования методов, конструкторов и полей. Эти случаи использования могут быть выделены с помощью небольших целых чисел следующим образом:

виды ссылок
вид ссылки	описательное имя	область	член	поведение
`1`	`REF_getField`	`class`	`FT f;`	`(T) this.f;`
`2`	`REF_getStatic`	`class` или `interface`	`static` `FT f;`	`(T) C.f;`
`3`	`REF_putField`	`class`	`FT f;`	`this.f = x;`
`4`	`REF_putStatic`	`class`	`static` `FT f;`	`C.f = arg;`
`5`	`REF_invokeVirtual`	`class`	`T m(A*);`	`(T) this.m(arg*);`
`6`	`REF_invokeStatic`	`class` или `interface`	`static` `T m(A*);`	`(T) C.m(arg*);`
`7`	`REF_invokeSpecial`	`class` или `interface`	`T m(A*);`	`(T) super.m(arg*);`
`8`	`REF_newInvokeSpecial`	`class`	`C(A*);`	`new C(arg*);`
`9`	`REF_invokeInterface`	`interface`	`T m(A*);`	`(T) this.m(arg*);`

С момента:: 1.8

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`REF_getField`	Вид ссылки на прямой обработчик метода, как определено в таблице выше.
`static final int`	`REF_getStatic`	Вид ссылки на прямой обработчик метода, как определено в таблице выше.
`static final int`	`REF_invokeInterface`	Вид ссылки на прямой обработчик метода, как определено в таблице выше.
`static final int`	`REF_invokeSpecial`	Вид ссылки на прямой обработчик метода, как определено в таблице выше.
`static final int`	`REF_invokeStatic`	Вид ссылки на прямой обработчик метода, как определено в таблице выше.
`static final int`	`REF_invokeVirtual`	Вид ссылки на прямой обработчик метода, как определено в таблице выше.
`static final int`	`REF_newInvokeSpecial`	Вид ссылки на прямой обработчик метода, как определено в таблице выше.
`static final int`	`REF_putField`	Вид ссылки на прямой обработчик метода, как определено в таблице выше.
`static final int`	`REF_putStatic`	Вид ссылки на прямой обработчик метода, как определено в таблице выше.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Class<?>`	`getDeclaringClass()`	Возвращает класс, в котором был определен основной член обработчика метода.
`MethodType`	`getMethodType()`	Возвращает номинальный тип разрываемой символической ссылки, представленной в виде типа метода.
`int`	`getModifiers()`	Возвращает атрибуты доступа к основному члену.
`String`	`getName()`	Возвращает имя основного члена обработчика метода.
`int`	`getReferenceKind()`	Возвращает вид ссылки обработчика метода, который определяет, был ли основной член обработчика метода конструктором, методом или полем.
`default boolean`	`isVarArgs()`	Определяет, был ли основной член методом или конструктором с переменным числом аргументов.
`static String`	`referenceKindToString(int referenceKind)`	Возвращает описательное имя заданного вида ссылки, как определено в таблице выше.
`<T extends Member> T`	`reflectAs(Class<T> expected, MethodHandles.Lookup lookup)`	Отражает основной член как объект метода, конструктора или поля.
`static String`	`toString(int kind, Class<?> defc, String name, MethodType type)`	Возвращает строковое представление для `MethodHandleInfo`, учитывая четыре части его символической ссылки.