Интерфейс MethodHandleInfo

public interface MethodHandleInfo

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

Прямые ссылки на методы

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

Выполняя инструкцию ldc над константой CONSTANT_MethodHandle. (См. Спецификацию Java Virtual Machine, разделы 4.4.8 и 5.4.3.)
Вызвав один из методов фабрики методов поиска, таких как 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) для отмены этого ограничения.

Типы ссылок

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

вид ссылки	описательное имя	область видимости	член	поведение
`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 int`	`REF_getField` Вид ссылки на прямую ссылку на метод, как определено в таблице выше.
`static int`	`REF_getStatic` Вид ссылки на прямую ссылку на метод, как определено в таблице выше.
`static int`	`REF_invokeInterface` Вид ссылки на прямую ссылку на метод, как определено в таблице выше.
`static int`	`REF_invokeSpecial` Вид ссылки на прямую ссылку на метод, как определено в таблице выше.
`static int`	`REF_invokeStatic` Вид ссылки на прямую ссылку на метод, как определено в таблице выше.
`static int`	`REF_invokeVirtual` Вид ссылки на прямую ссылку на метод, как определено в таблице выше.
`static int`	`REF_newInvokeSpecial` Вид ссылки на прямую ссылку на метод, как определено в таблице выше.
`static int`	`REF_putField` Вид ссылки на прямую ссылку на метод, как определено в таблице выше.
`static 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`, используя четыре части его символической ссылки.