java.lang.invoke

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

java.lang. Объект

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

Включение класса:

MethodHandles

public static final class MethodHandles.Lookup
extends Object

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

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

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

lookup expression	member	behavior
lookup.findGetter (C.class, "f", FT.class)	FT f;	(T) this.f;
lookup.findStaticGetter (C.class, "f", FT.class)	static FT f;	(T) C.f;
lookup.findSetter (C.class, "f", FT.class)	FT f;	this.f = x;
lookup.findStaticSetter (C.class, "f", FT.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, this.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 класс или интерфейс, искавший элемент, задокументированный в качестве параметра названный refc в методах поиска. Метод или тип конструктора MT составляется из типа возврата T и последовательность типов параметра A*. Оба MT и тип поля FT документируются в качестве параметра названные type. Формальный параметр this стенды для самоссылки типа C; если это присутствует, это всегда - ведущий параметр вызову дескриптора метода. Имя arg стенды для всех других параметров дескриптора метода. В примерах кода для Базового API Reflection, имени thisOrNull стенды для нулевой ссылки, если метод, к которому получают доступ, или поле статичны, и this иначе. Имена aMethod, aField, и aConstructor стенд для отражающих объектов, соответствующих данным элементам.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Во всех случаях, smgr.checkMemberAccess(refc, Member.PUBLIC) вызывается.
• Если загрузчик класса класса поиска не является тем же самым как или предок загрузчика класса refc, тогда smgr.checkPackageAccess(refcPkg) вызывается, где refcPkg пакет refc.
• Если полученный элемент не общедоступен, smgr.checkMemberAccess(defc, Member.DECLARED) вызывается. (Отметьте это defc могло бы быть то же самое как refc.) Реализация по умолчанию этого метода менеджера безопасности осматривает стек, чтобы определить исходную вызывающую сторону отражающего запроса (такой как findStatic), и выполняет дополнительные проверки разрешения если загрузчик класса defc отличается от загрузчика класса класса, из которого прибыл отражающий запрос.
• Если полученный элемент не общедоступен, и если defc и refc находятся в различных загрузчиках класса, и если загрузчик класса класса поиска не является тем же самым как или предок загрузчика класса 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<?>	lookupClass() Говорит, какой класс выполняет поиск.
int	lookupModes() Говорит, какие классы защиты доступа элементов этот объект поиска может произвести.
Строка	toString() Выводит на экран имя класса, из которого должны быть сделаны поиски.
MethodHandle	unreflect(Method m) Делает дескриптор прямого метода к м., если у класса поиска есть разрешение.
MethodHandle	unreflectConstructor(Constructor c) Производит дескриптор метода для отраженного конструктора.
MethodHandle	unreflectGetter(Field f) Производит дескриптор метода, дающий доступ для чтения к отраженному полю.
MethodHandle	unreflectSetter(Field f) Производит дескриптор метода, дающий доступ для записи к отраженному полю.
MethodHandle	unreflectSpecial(Method m, Class<?> specialCaller) Производит дескриптор метода для отраженного метода.

Методы 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()

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

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

lookupModes

public int lookupModes()

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

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

в

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

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

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

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

Параметры:

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

Возвраты:

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

Броски:

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

toString

public String toString()

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

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

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

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

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

toString в классе Object

Возвраты:

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

См. Также:

in(java.lang.Class<?>)

findStatic

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

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

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

Параметры:

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

name - имя метода

type - тип метода

Возвраты:

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

Броски:

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

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

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

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

findVirtual

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

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

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

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

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

Параметры:

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

name - имя метода

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

Возвраты:

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

Броски:

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

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

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

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

findConstructor

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

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

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

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

Параметры:

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

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 инструкция.)

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

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

Параметры:

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

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

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

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

Возвраты:

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

Броски:

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

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

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

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

findGetter

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

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

Параметры:

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

name - имя поля

type - тип поля

Возвраты:

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

Броски:

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

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

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

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

findSetter

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

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

Параметры:

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

name - имя поля

type - тип поля

Возвраты:

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

Броски:

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

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

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

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

findStaticGetter

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

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

Параметры:

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

name - имя поля

type - тип поля

Возвраты:

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

Броски:

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

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

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

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

findStaticSetter

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

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

Параметры:

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

name - имя поля

type - тип поля

Возвраты:

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

Броски:

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

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

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

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

связать

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

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

У возвращенного дескриптора метода будет переменная арность если и только если переменный бит модификатора арности метода (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() или тип высшего качества того класса, в котором требуемый метод доступен для класса поиска. (Отметьте это bindTo не сохраняет переменную арность.)

Параметры:

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

name - имя метода

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

Возвраты:

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

Броски:

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

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

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

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

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

public MethodHandle unreflect(Method m)
                       throws IllegalAccessException

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

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

Параметры:

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

Возвраты:

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

Броски:

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

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

unreflectSpecial

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

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

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

Параметры:

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

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

Возвраты:

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

Броски:

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

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

unreflectConstructor

public MethodHandle unreflectConstructor(Constructor c)
                                  throws IllegalAccessException

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

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

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

Параметры:

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

Возвраты:

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

Броски:

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

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

unreflectGetter

public MethodHandle unreflectGetter(Field f)
                             throws IllegalAccessException

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

Параметры:

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

Возвраты:

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

Броски:

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

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

unreflectSetter

public MethodHandle unreflectSetter(Field f)
                             throws IllegalAccessException

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

Параметры:

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

Возвраты:

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

Броски:

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

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