Интерфейс 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, эквивалентного тому, который создал целевой обработчик метода, или имеющего достаточные разрешения для создания эквивалентного обработчика метода.

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

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

Виды ссылок

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

reference kinds

вид ссылки	описательное имя	область	член	поведение
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*);