compact1, compact2, compact3

java.lang.invoke

Класс MethodHandles. Поиск

java.lang. Объект

java.lang.invoke. MethodHandles. Поиск

Включение class:

MethodHandles

public static final class MethodHandles.Lookup
extends Object

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

Поиск class, который должен создать дескрипторы метода, вызовет MethodHandles.lookup создать фабрику для себя. Когда Lookup объект фабрики создается, идентификационные данные поиска, class определяется, и надежно сохранен в Lookup объект. Поиск class (или его делегаты) может тогда использовать методы фабрики на Lookup объект создать дескрипторы метода для проверенных в доступе элементов. Это включает все методы, конструкторов, и поля, которые позволяются поиску class, даже частные.

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

lookup expression	member	behavior
lookup.findGetter (C.class, "f", Футы class)	FT f;	(T) this.f;
lookup.findStaticGetter (C.class, "f", Футы class)	static FT f;	(T) C.f;
lookup.findSetter (C.class, "f", Футы class)	FT f;	this.f = x;
lookup.findStaticSetter (C.class, "f", Футы class)	static FT f;	C.f = arg;
lookup.findVirtual (C.class, "м.", MT)	T m(A*);	(T) this.m(arg*);
lookup.findStatic (C.class, "м.", MT)	static T m(A*);	(T) C.m(arg*);
lookup.findSpecial (C.class, "м.", MT, это. class)	T m(A*);	(T) super.m(arg*);
lookup.findConstructor (C.class, Монтана)	C(A*);	(T) new C(arg*);
lookup.unreflectGetter (далеко от дома)	(static)? FT f;	(FT) aField.get(thisOrNull);
lookup.unreflectSetter (далеко от дома)	(static)? FT f;	aField.set(thisOrNull, arg);
lookup.unreflect (aMethod)	(static)? T m(A*);	(T) aMethod.invoke(thisOrNull, arg*);
lookup.unreflectConstructor (aConstructor)	C(A*);	(C) aConstructor.newInstance(arg*);
lookup.unreflect (aMethod)	(static)? T m(A*);	(T) aMethod.invoke(thisOrNull, arg*);

Здесь, тип C class или интерфейс, искавший элемент, задокументированный в качестве параметра названный refc в методах поиска. Метод или тип конструктора MT составляется из типа возврата T и последовательность типов параметра A*. Оба MT и тип поля FT документируются в качестве параметра названные type. Формальный параметр this стенды для самоссылки типа C; если это присутствует, это всегда - ведущий параметр вызову дескриптора метода. (В случае некоторых protected элементы, this может быть ограничен в типе поиску class; см. ниже.) Имя arg стенды для всех других параметров дескриптора метода. В примерах кода для Базового API Reflection, имени thisOrNull стенды для нулевой ссылки, если метод, к которому получают доступ, или поле статичны, и this иначе. Имена aMethod, aField, и aConstructor стенд для отражающих объектов, соответствующих данным элементам.

В случаях, где данный элемент имеет переменную арность (то есть, метод или конструктор) возвращенный дескриптор метода будет также иметь переменную арность. Во всех других случаях возвращенный дескриптор метода будет иметь фиксированную арность.

Эквивалентность между смотревшими дескрипторами метода и базовыми элементами class может сломаться несколькими способами:

• Если C не символически доступно от загрузчика class поиска, поиск может все еще успешно выполниться, даже когда нет никакого эквивалентного выражения Java или bytecoded константы.
• Аналогично, если T или MT не символически доступно от загрузчика class поиска, поиск может все еще успешно выполниться. Например, поиски для MethodHandle.invokeExact и MethodHandle.invoke будет всегда успешно выполняться, независимо от требуемого типа.
• Если есть установленный менеджер безопасности, он может запретить поиск на различных основах (см. ниже). В отличие от этого, ldc инструкция не подвергается проверкам менеджера безопасности.

Проверка доступа

Проверки прав доступа применяются в методах фабрики Lookup, когда дескриптор метода создается. Это - основное отличие от Базового API Reflection с тех пор java.lang.reflect.Method.invoke выполняет проверку доступа против каждой вызывающей стороны, на каждом вызове.

Все проверки прав доступа запускаются с a Lookup объект, который сравнивает его записанный поиск class со всеми запросами, чтобы создать дескрипторы метода. Сингл Lookup объект может использоваться, чтобы создать любое число проверенных в доступе дескрипторов метода, все проверенные по единственному поиску class.

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

Поиск может перестать работать, потому что содержание class не доступно для поиска class, или потому что требуемый элемент class отсутствует, или потому что требуемый элемент class не доступен для поиска class. В любом из этих случаев, a ReflectiveOperationException будет брошен от предпринятого поиска. Точный class будет одним из следующего:

• NoSuchMethodException — если метод требуют, но не существует
• NoSuchFieldException — если поле требуют, но не существует
• IllegalAccessException — если элемент существует, но проверка прав доступа, перестал работать

Вообще, условия, при которых дескриптор метода может искаться метод M точно эквивалентны условиям, при которых поиск class, возможно, скомпилировал и разрешил звонок M. И эффект вызова дескриптора метода, следующего из поиска, точно эквивалентен выполнению скомпилированного и разрешенного звонка M. Та же самая точка верна для полей и конструкторов.

Если требуемый элемент protected, обычные правила JVM применяются, включая требование, чтобы поиск class был или быть в том же самом пакете как требуемый элемент, или должен наследовать тот элемент. (См. Спецификацию виртуальной машины Java, разделы 4.9.2, 5.4.3.5, и 6.4.), Кроме того, если требуемый элемент является нестатическим полем или методом в различном пакете, получающийся дескриптор метода может только быть применен к объектам поиска class или один из его подклассов. Это требование осуществляется, сужая тип продвижения this параметр от C (который обязательно будет суперклассом поиска class) к поиску class непосредственно.

В некоторых случаях доступ между вложенными классами получается компилятором Java, создавая метод обертки, чтобы получить доступ к закрытому методу другого class в том же самом высокоуровневом объявлении. Например, вложенный class C.D может получить доступ к членам парламента, не занимающим официального поста в пределах других связанных классов такой как C, C.D.E, или C.B, но компилятор Java, возможно, должен генерировать методы обертки в тех связанных классах. В таких случаях, a Lookup объект на C.E было бы неспособно тем членам парламента, не занимающим официального поста. Обходное решение для этого ограничения Lookup.in метод, который может преобразовать поиск на C.E в одного на любом из тех других классов, без специального повышения полномочия.

Хотя инструкции байт-кода могут только обратиться к классам в связанном загрузчике class, этот API может искать методы в любом class пока ссылка на Class объект доступен. Такие ссылки перекрестного загрузчика также возможны с Базовым API Reflection, и невозможны к инструкциям байт-кода такой как invokestatic или getfield. Есть API менеджера безопасности, чтобы позволить приложениям проверять такие ссылки перекрестного загрузчика. Эти проверки применяются к обоим MethodHandles.Lookup API и Базовый API Reflection (как найдено на Class).

Проверки прав доступа только применяются к именованным и отраженным методам, конструкторам, и полям. Другие методы создания дескриптора метода, такой как MethodHandle.asType, не требуйте никаких проверок прав доступа, и делаются со статическими методами MethodHandles, независимо от любого Lookup объект.

Взаимодействия менеджера безопасности

Если менеджер безопасности присутствует, задействованные поиски подвергаются дополнительным проверкам. От одного до четырех вызовов делаются к менеджеру безопасности. Любой из этих вызовов может отказать в доступе, бросая a SecurityException. Определить smgr как менеджер безопасности, refc как содержание class, в котором элемент разыскивается, и defc как class, в котором фактически определяется элемент. Вызовы выполняются согласно следующим правилам:

• Во всех случаях, smgr.checkMemberAccess(refc, Member.PUBLIC) вызывается.
• Если загрузчик class поиска class не является тем же самым как или предок загрузчика class refc, тогда smgr.checkPackageAccess(refcPkg) вызывается, где refcPkg пакет refc.
• Если полученный элемент не общедоступен, smgr.checkMemberAccess(defc, Member.DECLARED) вызывается. (Отметьте это defc могло бы быть то же самое как refc.) Реализация по умолчанию этого метода менеджера безопасности осматривает стек, чтобы определить исходную вызывающую сторону отражающего запроса (такой как findStatic), и выполняет дополнительные проверки разрешения если загрузчик class defc отличается от загрузчика class class, из которого прибыл отражающий запрос.
• Если полученный элемент не общедоступен, и если defc и refc находятся в различных загрузчиках class, и если загрузчик class поиска class не является тем же самым как или предок загрузчика class defc, тогда smgr.checkPackageAccess(defcPkg) вызывается, где defcPkg пакет defc.

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	ПАКЕТ Одно-разрядное представление маски package доступ (доступ значения по умолчанию), который может способствовать результату lookupModes.
static int	ЧАСТНЫЙ Одно-разрядное представление маски private доступ, который может способствовать результату lookupModes.
static int	ЗАЩИЩЕННЫЙ Одно-разрядное представление маски protected доступ, который может способствовать результату lookupModes.
static int	ОБЩЕСТВЕННОСТЬ Одно-разрядное представление маски public доступ, который может способствовать результату lookupModes.

Сводка метода

Модификатор и Тип	Метод и Описание
MethodHandle	bind(Object receiver, String name, MethodType type) Производит ранне-ограниченный дескриптор метода для нестатического метода.
MethodHandle	findConstructor(Class<?> refc, MethodType type) Производит дескриптор метода, который создает объект и инициализирует его, используя конструктора указанного типа.
MethodHandle	findGetter(Class<?> refc, String name, Class<?> type) Производит дескриптор метода, дающий доступ для чтения к нестатическому полю.
MethodHandle	findSetter(Class<?> refc, String name, Class<?> type) Производит дескриптор метода, дающий доступ для записи к нестатическому полю.
MethodHandle	findSpecial(Class<?> refc, String name, MethodType type, Class<?> specialCaller) Производит ранне-ограниченный дескриптор метода для виртуального метода, как будто вызванный от invokespecial инструкция от caller.
MethodHandle	findStatic(Class<?> refc, String name, MethodType type) Производит дескриптор метода для статического метода.
MethodHandle	findStaticGetter(Class<?> refc, String name, Class<?> type) Производит дескриптор метода, дающий доступ для чтения к статическому полю.
MethodHandle	findStaticSetter(Class<?> refc, String name, Class<?> type) Производит дескриптор метода, дающий доступ для записи к статическому полю.
MethodHandle	findVirtual(Class<?> refc, String name, MethodType type) Производит дескриптор метода для виртуального метода.
MethodHandles. Поиск	in(Class<?> requestedLookupClass) Создает поиск на указанном новом поиске class.
Class<?>	lookupClass() Говорит, который class выполняет поиск.
int	lookupModes() Говорит, какие классы защиты доступа элементов этот объект поиска может произвести.
Строка	toString() Выводит на экран имя class, из которого должны быть сделаны поиски.
MethodHandle	unreflect(Method m) Делает дескриптор прямого метода к м., если у поиска class есть разрешение.
MethodHandle	unreflectConstructor(Constructor c) Производит дескриптор метода для отраженного конструктора.
MethodHandle	unreflectGetter(Field f) Производит дескриптор метода, дающий доступ для чтения к отраженному полю.
MethodHandle	unreflectSetter(Field f) Производит дескриптор метода, дающий доступ для записи к отраженному полю.
MethodHandle	unreflectSpecial(Method m, Class<?> specialCaller) Производит дескриптор метода для отраженного метода.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Полевая Деталь

ОБЩЕСТВЕННОСТЬ

public static final int PUBLIC

Одно-разрядное представление маски public доступ, который может способствовать результату lookupModes. Значение, 0x01, оказывается, то же самое как значение public бит модификатора.

См. Также:

Постоянные Значения полей

ЧАСТНЫЙ

public static final int PRIVATE

Одно-разрядное представление маски private доступ, который может способствовать результату lookupModes. Значение, 0x02, оказывается, то же самое как значение private бит модификатора.

См. Также:

Постоянные Значения полей

ЗАЩИЩЕННЫЙ

public static final int PROTECTED

Одно-разрядное представление маски protected доступ, который может способствовать результату lookupModes. Значение, 0x04, оказывается, то же самое как значение protected бит модификатора.

См. Также:

Постоянные Значения полей

ПАКЕТ

public static final int PACKAGE

Одно-разрядное представление маски package доступ (доступ значения по умолчанию), который может способствовать результату lookupModes. Значение 0x08, который не соответствует обоснованно никакому определенному биту модификатора.

См. Также:

Постоянные Значения полей

Деталь метода

lookupClass

public Class<?> lookupClass()

Говорит, который class выполняет поиск. Это - этот class, против которого проверки выполняются для видимости и прав доступа.

class подразумевает максимальный уровень права доступа, но полномочия могут быть дополнительно ограничены битовой маской lookupModes, который управляет, можно ли к непубличным элементам получить доступ.

lookupModes

public int lookupModes()

Говорит, какие классы защиты доступа элементов этот объект поиска может произвести. Результатом является битовая маска ОБЩЕСТВЕННОСТИ битов (0x01), ЧАСТНЫЙ (0x02), ЗАЩИЩАЛ (0x04), и ПАКЕТ (0x08).

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

в

public MethodHandles.Lookup in(Class<?> requestedLookupClass)

Создает поиск на указанном новом поиске class. Получающийся объект сообщит об указанном class как о своем собственном lookupClass.

Однако, получающееся Lookup у объекта, как гарантируют, больше не будет возможностей доступа чем оригинал. В частности возможности доступа могут быть потеряны следующим образом:

• Если новый поиск, class отличается от старого, защищенные элементы, не будет доступен на основании наследования. (Защищенные элементы могут продолжать быть доступными из-за совместного использования пакета.)
• Если новый поиск, class находится в различном пакете чем старый, защищенный и значение по умолчанию (пакет) элементы, не будет доступен.
• Если новый поиск, который class не в пределах того же самого элемента пакета как старый, члены парламента, не занимающие официального поста, не будет доступен.
• Если новый поиск, class не доступен для старого поиска class, то никакие элементы, не даже общедоступные элементы, не будут доступны. (Во всех других случаях общедоступные элементы будут продолжать быть доступными.)

Параметры:

requestedLookupClass - требуемый поиск class для нового объекта поиска

Возвраты:

объект поиска, который сообщает о требуемом поиске class

Броски:

NullPointerException - если параметром является нуль

toString

public String toString()

Выводит на экран имя class, из которого должны быть сделаны поиски. (Имя является тем, о котором сообщают Class.getName.), Если есть ограничения на доступ, разрешенный к этому поиску, это обозначается, добавляя суффикс к имени class, состоя из наклонной черты и ключевого слова. Ключевое слово представляет самый сильный предоставленный доступ, и выбирается следующим образом:

• Если никакой доступ не предоставляется, суффикс является "/noaccess".
• Если только открытый доступ позволяется, суффикс является "/общественностью".
• Если только общественности и доступу пакета разрешают, суффикс является "/пакетом".
• Если только общественности, пакету, и частному доступу разрешают, суффикс "/частный".

Если ни один из вышеупомянутых случаев не применяется, это имеет место, что полный доступ (общественность, пакет, частный, и защищенный), позволяется. В этом случае никакой суффикс не добавляется. Это - истина только объекта, полученного первоначально из MethodHandles.lookup. Объекты, создаваемые Lookup.in всегда имейте ограниченный доступ, и выведет на экран суффикс.

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

Переопределения:

toString в class Object

Возвраты:

строковое представление объекта.

См. Также:

in(java.lang.Class<?>)

findStatic

public MethodHandle findStatic(Class<?> refc,
                               String name,
                               MethodType type)
                        throws NoSuchMethodException,
                               IllegalAccessException

Производит дескриптор метода для статического метода. Тип дескриптора метода будет типом метода. (Так как статические методы не берут получатели, нет никакого дополнительного параметра получателя, вставленного в тип дескриптора метода, поскольку было бы с findVirtual или findSpecial.) Метод и все его типы параметра должны быть доступными для поиска class. Если class метода еще не был инициализирован, который сразу делается, прежде, чем дескриптор метода возвращается.

У возвращенного дескриптора метода будет переменная арность если и только если переменный бит модификатора арности метода (0x0080) устанавливается.

Параметры:

refc - class, от которого получают доступ к методу

name - имя метода

type - тип метода

Возвраты:

требуемый дескриптор метода

Броски:

NoSuchMethodException - если метод не существует

IllegalAccessException - если проверка доступа перестала работать, или если метод не static, или если переменный бит модификатора арности метода устанавливается и asVarargsCollector сбои

SecurityException - если менеджер безопасности присутствует и это отказывает в доступе

NullPointerException - если каким-либо параметром является нуль

findVirtual

public MethodHandle findVirtual(Class<?> refc,
                                String name,
                                MethodType type)
                         throws NoSuchMethodException,
                                IllegalAccessException

Производит дескриптор метода для виртуального метода. Тип дескриптора метода будет типом метода с типом получателя (обычно refc) предварительно ожидаемый. Метод и все его типы параметра должны быть доступными для поиска class.

Когда вызвано, дескриптор обработает первый параметр как получатель и диспетчеризирует на типе получателя, чтобы определить который реализация метода войти. (Действие диспетчеризации идентично с выполняемым invokevirtual или invokeinterface инструкция.)

Первый параметр будет иметь тип refc если у поиска class есть полные полномочия получить доступ к элементу. Иначе элемент должен быть protected и первый параметр будет ограничен в типе поиску class.

У возвращенного дескриптора метода будет переменная арность если и только если переменный бит модификатора арности метода (0x0080) устанавливается.

Из-за общей эквивалентности между invokevirtual инструкции и дескрипторы метода, произведенные findVirtual, если class MethodHandle и строка имени invokeExact или invoke, получающийся дескриптор метода эквивалентен одному произведенному MethodHandles.exactInvoker или MethodHandles.invoker с тем же самым type параметр.

Параметры:

refc - class или интерфейс, от которого получают доступ к методу

name - имя метода

type - тип метода, с опущенным параметром получателя

Возвраты:

требуемый дескриптор метода

Броски:

NoSuchMethodException - если метод не существует

IllegalAccessException - если проверка доступа перестала работать, или если метод static или если переменный бит модификатора арности метода устанавливается и asVarargsCollector сбои

SecurityException - если менеджер безопасности присутствует и это отказывает в доступе

NullPointerException - если каким-либо параметром является нуль

findConstructor

public MethodHandle findConstructor(Class<?> refc,
                                    MethodType type)
                             throws NoSuchMethodException,
                                    IllegalAccessException

Производит дескриптор метода, который создает объект и инициализирует его, используя конструктора указанного типа. Типы параметра дескриптора метода будут таковыми из конструктора, в то время как тип возврата будет ссылкой на class конструктора. Конструктор и все его типы параметра должны быть доступными для поиска class. Если class конструктора еще не был инициализирован, который сразу делается, прежде, чем дескриптор метода возвращается.

Отметьте: У требуемого типа должен быть тип возврата void. Это является непротиворечивым с обработкой JVM дескрипторов типа конструктора.

У возвращенного дескриптора метода будет переменная арность если и только если переменный бит модификатора арности конструктора (0x0080) устанавливается.

Параметры:

refc - class или интерфейс, от которого получают доступ к методу

type - тип метода, с параметром получателя, опущенным, и пустой тип возврата

Возвраты:

требуемый дескриптор метода

Броски:

NoSuchMethodException - если конструктор не существует

IllegalAccessException - если проверка доступа перестала работать или если переменный бит модификатора арности метода устанавливается и asVarargsCollector сбои

SecurityException - если менеджер безопасности присутствует и это отказывает в доступе

NullPointerException - если каким-либо параметром является нуль

findSpecial

public MethodHandle findSpecial(Class<?> refc,
                                String name,
                                MethodType type,
                                Class<?> specialCaller)
                         throws NoSuchMethodException,
                                IllegalAccessException

Производит ранне-ограниченный дескриптор метода для виртуального метода, как будто вызванный от invokespecial инструкция от caller. Тип дескриптора метода будет типом метода с соответственно ограниченным типом получателя (такой как caller) предварительно ожидаемый. Метод и все его типы параметра должны быть доступными для вызывающей стороны.

Когда вызвано, дескриптор обработает первый параметр как получатель, но не будет диспетчеризировать на типе получателя. (Это прямое действие вызова идентично с выполняемым invokespecial инструкция.)

Если явно указанная вызывающая сторона, class не идентичен с поиском class, или если у этого объекта поиска нет частных прав доступа, сбоев доступа.

У возвращенного дескриптора метода будет переменная арность если и только если переменный бит модификатора арности метода (0x0080) устанавливается.

Параметры:

refc - class или интерфейс, от которого получают доступ к методу

name - имя метода (который не должен быть" <init>"),

type - тип метода, с опущенным параметром получателя

specialCaller - предложенный вызов class, чтобы выполнить invokespecial

Возвраты:

требуемый дескриптор метода

Броски:

NoSuchMethodException - если метод не существует

IllegalAccessException - если проверка доступа перестала работать или если переменный бит модификатора арности метода устанавливается и asVarargsCollector сбои

SecurityException - если менеджер безопасности присутствует и это отказывает в доступе

NullPointerException - если каким-либо параметром является нуль

findGetter

public MethodHandle findGetter(Class<?> refc,
                               String name,
                               Class<?> type)
                        throws NoSuchFieldException,
                               IllegalAccessException

Производит дескриптор метода, дающий доступ для чтения к нестатическому полю. У типа дескриптора метода будет тип возврата типа значения поля. Единственным параметром дескриптора метода будет экземпляр, содержащий поле. Проверка доступа сразу выполняется от имени поиска class.

Параметры:

refc - class или интерфейс, от которого получают доступ к методу

name - имя поля

type - тип поля

Возвраты:

дескриптор метода, который может загрузить значения из поля

Броски:

NoSuchFieldException - если поле не существует

IllegalAccessException - если проверка доступа перестала работать, или если поле static

SecurityException - если менеджер безопасности присутствует и это отказывает в доступе

NullPointerException - если каким-либо параметром является нуль

findSetter

public MethodHandle findSetter(Class<?> refc,
                               String name,
                               Class<?> type)
                        throws NoSuchFieldException,
                               IllegalAccessException

Производит дескриптор метода, дающий доступ для записи к нестатическому полю. У типа дескриптора метода будет пустой тип возврата. Дескриптор метода возьмет два параметра, экземпляр, содержащий поле, и значение, которое будет сохранено. Второй параметр будет иметь тип значения поля. Проверка доступа сразу выполняется от имени поиска class.

Параметры:

refc - class или интерфейс, от которого получают доступ к методу

name - имя поля

type - тип поля

Возвраты:

дескриптор метода, который может сохранить значения в поле

Броски:

NoSuchFieldException - если поле не существует

IllegalAccessException - если проверка доступа перестала работать, или если поле static

SecurityException - если менеджер безопасности присутствует и это отказывает в доступе

NullPointerException - если каким-либо параметром является нуль

findStaticGetter

public MethodHandle findStaticGetter(Class<?> refc,
                                     String name,
                                     Class<?> type)
                              throws NoSuchFieldException,
                                     IllegalAccessException

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

Параметры:

refc - class или интерфейс, от которого получают доступ к методу

name - имя поля

type - тип поля

Возвраты:

дескриптор метода, который может загрузить значения из поля

Броски:

NoSuchFieldException - если поле не существует

IllegalAccessException - если проверка доступа перестала работать, или если поле не static

SecurityException - если менеджер безопасности присутствует и это отказывает в доступе

NullPointerException - если каким-либо параметром является нуль

findStaticSetter

public MethodHandle findStaticSetter(Class<?> refc,
                                     String name,
                                     Class<?> type)
                              throws NoSuchFieldException,
                                     IllegalAccessException

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

Параметры:

refc - class или интерфейс, от которого получают доступ к методу

name - имя поля

type - тип поля

Возвраты:

дескриптор метода, который может сохранить значения в поле

Броски:

NoSuchFieldException - если поле не существует

IllegalAccessException - если проверка доступа перестала работать, или если поле не static

SecurityException - если менеджер безопасности присутствует и это отказывает в доступе

NullPointerException - если каким-либо параметром является нуль

связать

public MethodHandle bind(Object receiver,
                         String name,
                         MethodType type)
                  throws NoSuchMethodException,
                         IllegalAccessException

Производит ранне-ограниченный дескриптор метода для нестатического метода. У получателя должен быть супертип defc в котором метод имени и типа доступен для поиска class. Метод и все его типы параметра должны быть доступными для поиска class. Тип дескриптора метода будет типом метода без любой вставки дополнительного параметра получателя. Данный получатель будет связан в дескриптор метода, так, чтобы каждый звонок в дескриптор метода вызвал требуемый метод на данный получатель.

У возвращенного дескриптора метода будет переменная арность если и только если переменный бит модификатора арности метода (0x0080) устанавливается и запаздывающим параметром массива не является единственный параметр. (Если запаздывающим параметром массива будет единственный параметр, то данное значение получателя будет связано с этим.)

Это эквивалентно следующему коду:

import static java.lang.invoke.MethodHandles.*;
import static java.lang.invoke.MethodType.*;
...
MethodHandle mh0 = lookup().findVirtual(defc, name, type);
MethodHandle mh1 = mh0.bindTo(receiver);
MethodType mt1 = mh1.type();
if (mh0.isVarargsCollector())
  mh1 = mh1.asVarargsCollector(mt1.parameterType(mt1.parameterCount()-1));
return mh1;
 

где defc также receiver.getClass() или тип высшего качества что class, в котором требуемый метод доступен для поиска class. (Отметьте это bindTo не сохраняет переменную арность.)

Параметры:

receiver - объект, от которого получают доступ к методу

name - имя метода

type - тип метода, с опущенным параметром получателя

Возвраты:

требуемый дескриптор метода

Броски:

NoSuchMethodException - если метод не существует

IllegalAccessException - если проверка доступа перестала работать или если переменный бит модификатора арности метода устанавливается и asVarargsCollector сбои

SecurityException - если менеджер безопасности присутствует и это отказывает в доступе

NullPointerException - если каким-либо параметром является нуль

неотразиться

public MethodHandle unreflect(Method m)
                       throws IllegalAccessException

Делает дескриптор прямого метода к м., если у поиска class есть разрешение. Если м. нестатичен, параметр получателя обрабатывается как начальный параметр. Если м. является виртуальным, переопределение уважают на каждом вызове. В отличие от Базового API Reflection, не обертываются исключения. Тип дескриптора метода будет типом метода с предварительно ожидаемым типом получателя (но только если это нестатично). Если метод accessible флаг не устанавливается, проверка доступа сразу выполняется от имени поиска class. Если м. не общедоступен, не совместно используйте получающийся дескриптор с недоверяемыми сторонами.

У возвращенного дескриптора метода будет переменная арность если и только если переменный бит модификатора арности метода (0x0080) устанавливается.

Параметры:

m - отраженный метод

Возвраты:

дескриптор метода, который может вызвать отраженный метод

Броски:

IllegalAccessException - если проверка доступа перестала работать или если переменный бит модификатора арности метода устанавливается и asVarargsCollector сбои

NullPointerException - если параметром является нуль

unreflectSpecial

public MethodHandle unreflectSpecial(Method m,
                                     Class<?> specialCaller)
                              throws IllegalAccessException

Производит дескриптор метода для отраженного метода. Это обойдет проверки на переопределение методов на получателе, как будто a invokespecial инструкция изнутри specialCaller. Тип дескриптора метода будет типом метода со специальным предварительно ожидаемым типом вызывающей стороны (а не получатель метода). Если метод accessible флаг не устанавливается, проверка доступа сразу выполняется от имени поиска class, как будто invokespecial инструкция соединялась.

У возвращенного дескриптора метода будет переменная арность если и только если переменный бит модификатора арности метода (0x0080) устанавливается.

Параметры:

m - отраженный метод

specialCaller - class, номинально вызывая метод

Возвраты:

дескриптор метода, который может вызвать отраженный метод

Броски:

IllegalAccessException - если проверка доступа перестала работать или если переменный бит модификатора арности метода устанавливается и asVarargsCollector сбои

NullPointerException - если каким-либо параметром является нуль

unreflectConstructor

public MethodHandle unreflectConstructor(Constructor c)
                                  throws IllegalAccessException

Производит дескриптор метода для отраженного конструктора. Тип дескриптора метода будет типом конструктора с типом возврата, измененным на объявление class. Дескриптор метода выполнит a newInstance работа, создавая новый экземпляр class конструктора на параметрах, которые передают к дескриптору метода.

Если конструктор accessible флаг не устанавливается, проверка доступа сразу выполняется от имени поиска class.

У возвращенного дескриптора метода будет переменная арность если и только если переменный бит модификатора арности конструктора (0x0080) устанавливается.

Параметры:

c - отраженный конструктор

Возвраты:

дескриптор метода, который может вызвать отраженного конструктора

Броски:

IllegalAccessException - если проверка доступа перестала работать или если переменный бит модификатора арности метода устанавливается и asVarargsCollector сбои

NullPointerException - если параметром является нуль

unreflectGetter

public MethodHandle unreflectGetter(Field f)
                             throws IllegalAccessException

Производит дескриптор метода, дающий доступ для чтения к отраженному полю. У типа дескриптора метода будет тип возврата типа значения поля. Если поле будет статично, то дескриптор метода не возьмет параметров. Иначе, его единственным параметром будет экземпляр, содержащий поле. Если поле accessible флаг не устанавливается, проверка доступа сразу выполняется от имени поиска class.

Параметры:

f - отраженное поле

Возвраты:

дескриптор метода, который может загрузить значения из отраженного поля

Броски:

IllegalAccessException - если проверка доступа перестала работать

NullPointerException - если параметром является нуль

unreflectSetter

public MethodHandle unreflectSetter(Field f)
                             throws IllegalAccessException

Производит дескриптор метода, дающий доступ для записи к отраженному полю. У типа дескриптора метода будет пустой тип возврата. Если поле будет статично, то дескриптор метода возьмет единственный параметр, типа значения поля, значение, которое будет сохранено. Иначе, этими двумя параметрами будет экземпляр, содержащий поле, и значение, которое будет сохранено. Если поле accessible флаг не устанавливается, проверка доступа сразу выполняется от имени поиска class.

Параметры:

f - отраженное поле

Возвраты:

дескриптор метода, который может сохранить значения в отраженное поле

Броски:

IllegalAccessException - если проверка доступа перестала работать

NullPointerException - если параметром является нуль