Интерфейс MethodHandleInfo

public interface MethodHandleInfo

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

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

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

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

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

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

Если основной метод является чувствительным к вызывающему элементу, прямой обработчик метода будет «привязан» к определенному классу вызывающего элемента, классу поиска (lookup class) объекта поиска, используемого для его создания. Разбор этого обработчика метода с другим классом поиска завершится неудачей, даже если основной метод является общедоступным (например, 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`, заданное четырьмя частями его символьной ссылки.