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*);