Интерфейс MethodHandleInfo

public interface MethodHandleInfo

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

Прямые дескрипторы методов

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

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

Ограничения на разложение

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

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

Требование соответствия объекта поиска обеспечивает «быстрый отказ» для программ, которые в противном случае могли бы довериться ошибочному раскрытию дескриптора метода с символьной информацией (или привязкой к вызывающему коду) из неожиданной области видимости. Чтобы обойти это ограничение, используйте MethodHandles.reflectAs(Class, 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` с учетом четырех частей его символьной ссылки.