Указывает, какой класс выполняет поиск. Это тот класс, по отношению к которому выполняются проверки видимости и разрешений доступа.

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

Указывает, какие классы защиты доступа к членам может генерировать этот объект поиска. Результатом является битовая маска битов PUBLIC (0x01), PRIVATE (0x02), PROTECTED (0x04), PACKAGE (0x08), MODULE (0x10) и UNCONDITIONAL (0x20).

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

Создаёт поиск в указанном новом классе поиска. Результирующий объект будет сообщать о указанном классе как об собственном lookupClass.

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

• Если старый класс поиска находится в named модуле, а новый класс поиска находится в другом модуле M, тогда ни один член, даже публичные члены в экспортированных пакетах M, не будут доступны. Исключением из этого правила является тот случай, когда этот поиск publicLookup, в этом случае PUBLIC доступ не теряется.
• Если старый класс поиска находится в безымянном модуле, а новый класс поиска — в другом модуле, тогда MODULE доступ теряется.
• Если новый класс поиска отличается от старого, тогда UNCONDITIONAL теряется.
• Если новый класс поиска находится в другом пакете, чем старый, защищённые и стандартные (пакетные) члены не будут доступны.
• Если новый класс поиска не находится в том же пакете, что и старый, частные члены не будут доступны, и защищённые члены не будут доступны в силу наследования. (Защищённые члены могут по-прежнему быть доступны из-за совместного использования пакетов.)
• Если новый класс поиска недоступен для старого класса поиска, тогда ни один член, даже публичный, не будет доступен. (Во всех остальных случаях публичные члены по-прежнему будут доступны.)

Возможности результирующего поиска по загрузке классов (используемые во время вызовов findClass(java.lang.String)) определяются загрузчиком класса поиска, который может измениться из-за этой операции.

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

Режимы поиска для этого поиска должны включать PACKAGE доступ, так как члены по умолчанию (пакета) будут доступны для класса. PACKAGE режим поиска служит для проверки того, что объект поиска был создан вызывающим объектом в пакете времени выполнения (или получен от поиска, изначально созданного кодом с соответствующими привилегиями для целевого класса в пакете времени выполнения).

bytes параметр — это байты класса, являющиеся корректным файлом класса (как определено в Спецификации виртуальной машины Java) с именем класса в том же пакете, что и класс поиска.

Этот метод не выполняет инициализатор класса. Инициализатор класса может быть выполнен в более позднее время, как подробно описано в разделе 12.4 Спецификации языка Java.

Если существует менеджер безопасности, его метод checkPermission сначала вызывается для проверки RuntimePermission("defineClass").

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

• Если доступ не разрешён, суффикс — "/noaccess".
• Если разрешён только публичный доступ к типам в экспортированных пакетах, суффикс — "/public".
• Если разрешены только публичный доступ и безусловный доступ, суффикс — "/publicLookup".
• Если разрешён только публичный и модульный доступ, суффикс — "/module".
• Если разрешены только публичный, модульный и пакетный доступ, суффикс — "/package".
• Если разрешены только публичный, модульный, пакетный и частный доступ, суффикс — "/private".

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

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

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

Если вызывается возвращаемый обработчик методов, класс метода будет инициализирован, если он ещё не был инициализирован.

Пример:

import static java.lang.invoke.MethodHandles.*;
import static java.lang.invoke.MethodType.*;
...
MethodHandle MH_asList = publicLookup().findStatic(Arrays.class,
  "asList", methodType(List.class, Object[].class));
assertEquals("[x, y]", MH_asList.invoke("x", "y").toString());

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

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

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

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

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

Если класс является VarHandle, а строка имени соответствует имени метода метода с полиморфизмом сигнатур, полученный обработчик метода эквивалентен обработчику, созданному MethodHandles.varHandleInvoker(java.lang.invoke.VarHandle.AccessMode, java.lang.invoke.MethodType) с режимом доступа, соответствующим строке имени, и с теми же аргументами type.

Пример:

import static java.lang.invoke.MethodHandles.*;
import static java.lang.invoke.MethodType.*;
...
MethodHandle MH_concat = publicLookup().findVirtual(String.class,
  "concat", methodType(String.class, String.class));
MethodHandle MH_hashCode = publicLookup().findVirtual(Object.class,
  "hashCode", methodType(int.class));
MethodHandle MH_hashCode_String = publicLookup().findVirtual(String.class,
  "hashCode", methodType(int.class));
assertEquals("xy", (String) MH_concat.invokeExact("x", "y"));
assertEquals("xy".hashCode(), (int) MH_hashCode.invokeExact((Object)"xy"));
assertEquals("xy".hashCode(), (int) MH_hashCode_String.invokeExact("xy"));
// interface method:
MethodHandle MH_subSequence = publicLookup().findVirtual(CharSequence.class,
  "subSequence", methodType(CharSequence.class, int.class, int.class));
assertEquals("def", MH_subSequence.invoke("abcdefghi", 3, 6).toString());
// constructor "internal method" must be accessed differently:
MethodType MT_newString = methodType(void.class); //()V for new String()
try { assertEquals("impossible", lookup()
        .findVirtual(String.class, "<init>", MT_newString));
 } catch (NoSuchMethodException ex) { } // OK
MethodHandle MH_newString = publicLookup()
  .findConstructor(String.class, MT_newString);
assertEquals("", (String) MH_newString.invokeExact());

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

Запрашиваемый тип должен иметь тип возвращаемого значения void. (Это согласуется с обработкой JVM описателей типов конструкторов.)

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

Если возвращаемый обработчик метода вызывается, класс конструктора будет инициализирован, если он ещё не был инициализирован.

Пример:

import static java.lang.invoke.MethodHandles.*;
import static java.lang.invoke.MethodType.*;
...
MethodHandle MH_newArrayList = publicLookup().findConstructor(
  ArrayList.class, methodType(void.class, Collection.class));
Collection orig = Arrays.asList("x", "y");
Collection copy = (ArrayList) MH_newArrayList.invokeExact(orig);
assert(orig != copy);
assertEquals(orig, copy);
// a variable-arity constructor:
MethodHandle MH_newProcessBuilder = publicLookup().findConstructor(
  ProcessBuilder.class, methodType(void.class, String[].class));
ProcessBuilder pb = (ProcessBuilder)
  MH_newProcessBuilder.invoke("x", "y", "z");
assertEquals("[x, y, z]", pb.command().toString());

Ищет класс по имени из контекста поиска, определённого этим объектом Lookup. Статический инициализатор класса не выполняется.

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

Определяет, можно ли получить доступ к классу из контекста поиска, определённого этим объектом Lookup. Статический инициализатор класса не выполняется.

Контекст поиска определяется классом поиска lookup class и режимами поиска.

Создаёт ранний обработчик метода для виртуального метода. Он пропустит проверки переопределённых методов у получателя, как если бы он был вызван инструкцией invokespecial из внутри явно указанного specialCaller. Тип обработчика метода будет таким же, как у метода, с надлежащим ограничением типа получателя. (Тип получателя будет specialCaller или подклассом.) Метод и все его типы аргументов должны быть доступны объекту поиска.

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

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

(Примечание: внутренние методы JVM с именем "<init>" не видны для этого API, даже если инструкция invokespecial может ссылаться на них в особых случаях. Используйте findConstructor, чтобы безопасно получить доступ к методам инициализации экземпляров.)

Пример:

import static java.lang.invoke.MethodHandles.*;
import static java.lang.invoke.MethodType.*;
...
static class Listie extends ArrayList {
  public String toString() { return "[wee Listie]"; }
  static Lookup lookup() { return MethodHandles.lookup(); }
}
...
// no access to constructor via invokeSpecial:
MethodHandle MH_newListie = Listie.lookup()
  .findConstructor(Listie.class, methodType(void.class));
Listie l = (Listie) MH_newListie.invokeExact();
try { assertEquals("impossible", Listie.lookup().findSpecial(
        Listie.class, "<init>", methodType(void.class), Listie.class));
 } catch (NoSuchMethodException ex) { } // OK
// access to super and self methods via invokeSpecial:
MethodHandle MH_super = Listie.lookup().findSpecial(
  ArrayList.class, "toString" , methodType(String.class), Listie.class);
MethodHandle MH_this = Listie.lookup().findSpecial(
  Listie.class, "toString" , methodType(String.class), Listie.class);
MethodHandle MH_duper = Listie.lookup().findSpecial(
  Object.class, "toString" , methodType(String.class), Listie.class);
assertEquals("[]", (String) MH_super.invokeExact(l));
assertEquals(""+l, (String) MH_this.invokeExact(l));
assertEquals("[]", (String) MH_duper.invokeExact(l)); // ArrayList method
try { assertEquals("inaccessible", Listie.lookup().findSpecial(
        String.class, "toString", methodType(String.class), Listie.class));
 } catch (IllegalAccessException ex) { } // OK
Listie subl = new Listie() { public String toString() { return "[subclass]"; } };
assertEquals(""+l, (String) MH_this.invokeExact(subl)); // Listie method

Создаёт VarHandle, предоставляющий доступ к нестатическому полю name типа type, объявленному в классе типа recv. Тип переменной VarHandle - type, а тип координаты - recv.

Проверка доступа выполняется немедленно от имени класса поиска.

Некоторые режимы доступа возвращаемого VarHandle не поддерживаются в следующих условиях:

• если поле объявлено final, то режимы записи, атомарного обновления, атомарного числового обновления и атомарного побитового обновления не поддерживаются.
• если тип поля отличается от byte, short, char, int, long, float, или double, то режимы атомарного числового обновления не поддерживаются.
• если тип поля отличается от boolean, byte, short, char, int или long, то режимы атомарного побитового обновления не поддерживаются.

Если поле объявлено volatile, то возвращаемый VarHandle переопределит доступ к полю (фактически проигнорирует объявление volatile) в соответствии с его указанными режимами доступа.

Если тип поля - float или double, то режимы числового и атомарного обновления сравнивают значения, используя их битовую представление (см. Float.floatToRawIntBits(float) и Double.doubleToRawLongBits(double) соответственно).

Создаёт обработчик метода, предоставляющий доступ для чтения к статическому полю. Тип обработчика метода будет иметь возвращаемый тип типа значения поля. Обработчик метода не будет принимать аргументов. Проверка доступа выполняется немедленно от имени класса поиска.

Если вызывается возвращаемый обработчик метода, класс поля будет инициализирован, если он ещё не был инициализирован.

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

Если вызывается возвращаемый обработчик метода, класс поля будет инициализирован, если он ещё не был инициализирован.

Создаёт VarHandle, предоставляющий доступ к статическому полю name типа type , объявленному в классе типа decl. Тип переменной VarHandle - type, а тип координаты отсутствует.

Проверка доступа выполняется немедленно от имени класса поиска.

Если на возвращаемый VarHandle производится операция, класс объявления будет инициализирован, если он ещё не был инициализирован.

Некоторые режимы доступа возвращаемого VarHandle не поддерживаются в следующих условиях:

• если поле объявлено final, то режимы записи, атомарного обновления, атомарного числового обновления и атомарного побитового обновления не поддерживаются.
• если тип поля отличается от byte, short, char, int, long, float, или double, то режимы атомарного числового обновления не поддерживаются.
• если тип поля отличается от boolean, byte, short, char, int или long, то режимы атомарного побитового обновления не поддерживаются.

Если поле объявлено volatile, то возвращаемый VarHandle переопределит доступ к полю (фактически проигнорирует объявление volatile) в соответствии с его указанными режимами доступа.

Если тип поля - float или double, то режимы числового и атомарного обновления сравнивают значения, используя их битовую представление (см. Float.floatToRawIntBits(float) и Double.doubleToRawLongBits(double) соответственно).

Создает метод-обработчик с ранним связыванием для нестатического метода. Получатель должен иметь супертип 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);
mh1 = mh1.withVarargs(mh0.isVarargsCollector());
return mh1;

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

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

Если m статический, и если вызывается возвращаемый метод-обработчик, класс метода инициализируется, если он еще не был инициализирован.

Создает метод-обработчик для отраженного метода. Он пропустит проверки переопределенных методов получателя, как если бы он был вызван из инструкции invokespecial изнутри явно указанного specialCaller. Тип метода-обработчика будет таким же, как у метода, с надлежащим образом ограниченным типом получателя впереди. (Тип получателя будет specialCaller или подтипом). Если флаг accessible метода не установлен, проверка доступа выполняется немедленно от имени класса поиска, как будто инструкция invokespecial была связана.

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

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

Создает метод-обработчик для отраженного конструктора. Тип метода-обработчика будет таким же, как у конструктора, с типом возврата, измененным на класс объявления. Метод-обработчик выполнит операцию newInstance, создав новый экземпляр класса конструктора по аргументам, переданным методу-обработчику.

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

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

Если вызывается возвращаемый метод-обработчик, класс конструктора инициализируется, если он еще не был инициализирован.

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

Если поле статическое, и если вызывается возвращаемый метод-обработчик, класс поля инициализируется, если он еще не был инициализирован.

Создает метод-обработчик, предоставляющий доступ для записи к отраженному полю. Тип метода-обработчика будет иметь тип void в качестве типа возврата. Если поле статическое, метод-обработчик будет принимать один аргумент типа значения поля — значение, которое нужно сохранить. В противном случае двумя аргументами будут экземпляр, содержащий поле, и значение, которое нужно сохранить. Если флаг accessible поля не установлен, проверка доступа выполняется немедленно от имени класса поиска.

Если поле статическое, и если вызывается возвращаемый метод-обработчик, класс поля инициализируется, если он еще не был инициализирован.

Создаёт VarHandle, обеспечивающий доступ к отражённому полю f типа T, объявленному в классе типа R. Тип переменной VarHandle — T. Если поле не статическое, у VarHandle есть один тип координаты — R. В противном случае поле статическое, и у VarHandle нет типов координат.

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

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

Некоторые режимы доступа возвращённого VarHandle не поддерживаются в следующих условиях:

• если поле объявлено final, то режимы записи, атомарного обновления, атомарного числового обновления и атомарного побитового обновления не поддерживаются.
• если тип поля — любой другой, кроме byte, short, char, int, long, float, или double, то режимы атомарного числового обновления не поддерживаются.
• если тип поля — любой другой, кроме boolean, byte, short, char, int или long, то режимы атомарного побитового обновления не поддерживаются.

Если поле объявлено volatile, то возвращённый VarHandle переопределит доступ к полю (фактически проигнорирует объявление volatile) в соответствии со своими заданными режимами доступа.

Если тип поля — float или double, то режимы числового и атомарного обновления сравнивают значения с использованием их двоичного представления (см. Float.floatToRawIntBits(float) и Double.doubleToRawLongBits(double) соответственно).