Класс Class

Обратите внимание, что поскольку генерируется информация о представлении типа в runtime, могут быть присутствовать модификаторы, которые отсутствуют в исходном коде или недопустимы в исходном коде.

Class.forName(className, true, currentLoader)

Например, следующий фрагмент кода возвращает объект runtime Class для класса с именем java.lang.Thread:

Class<?> t = Class.forName("java.lang.Thread");

Вызов forName("X") вызывает инициализацию класса с именем X.

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

Этот метод не может использоваться для получения любых объектов Class, представляющих примитивные типы или void, скрытых классов или интерфейсов, или классов массивов, чье элементный тип — скрытый класс или интерфейс. Если name обозначает примитивный тип или void, например I, будет предпринята попытка найти пользовательский класс в безымянном пакете, имя которого — I.

Чтобы получить объект Class, связанный с классом массива, имя состоит из одного или нескольких '[', представляющих глубину вложения массива, за которым следует элементный тип, закодированный в таблице, указанной в Class.getName().

Примеры:

Class<?> threadClass = Class.forName("java.lang.Thread", false, currentLoader);
Class<?> stringArrayClass = Class.forName("[Ljava.lang.String;", false, currentLoader);
Class<?> intArrayClass = Class.forName("[[[I", false, currentLoader);   // Class of int[][][]
Class<?> nestedClass = Class.forName("java.lang.Character$UnicodeBlock", false, currentLoader);
Class<?> fooClass = Class.forName("Foo", true, currentLoader);

Вызов getName() на объекте Class, возвращённом forName(N) возвращает N.

Вызов forName("[LN;") вызывает загрузку элементного типа с именем N, но не инициализирует его независимо от значения параметра initialize.

Этот метод пытается найти и загрузить класс или интерфейс. Он не связывает класс и не выполняет инициализатор класса. Если класс не найден, этот метод возвращает null.

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

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

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

В частности, этот метод проверяет, может ли тип, представленный указанным Class параметром, быть преобразован в тип, представленный этим объектом Class, посредством преобразования тождества или расширяющего преобразования ссылки. См. Спецификацию языка Java, разделы 5.1.1 и 5.1.4, для получения подробностей.

Существует девять предопределённых объектов Class для представления восьми примитивных типов и void. Они создаются виртуальной машиной Java и имеют те же имена, что и примитивные типы, которые они представляют, а именно boolean, byte, char, short, int, long, float и double.

К этим объектам можно получить доступ только через следующие статические переменные public static final, и они являются единственными объектами Class, для которых этот метод возвращает true.

Если этот Class объект представляет класс или интерфейс, а не класс массива, то:

• Если класс или интерфейс не скрыт, то возвращается бинарное имя класса или интерфейса.
• Если класс или интерфейс скрыт, то результат — строка вида: N + '/' + <suffix>, где N — бинарное имя, указанное в файле class, переданном в Lookup::defineHiddenClass, а <suffix> — неопределённое имя.

Если этот Class объект представляет класс массива, то результат — строка, состоящая из одного или нескольких символов '[', представляющих глубину вложенности массива, за которой следует тип элемента, закодированный в соответствии со следующей таблицей:

Типы элементов и их кодировки

Тип элемента	Кодировка
boolean	Z
byte	B
char	C
класс или интерфейс с бинарным именем N	LN;
double	D
float	F
int	I
long	J
short	S

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

Примеры:

 String.class.getName()
     returns "java.lang.String"
 Character.UnicodeBlock.class.getName()
     returns "java.lang.Character$UnicodeBlock"
 byte.class.getName()
     returns "byte"
 (new Object[3]).getClass().getName()
     returns "[Ljava.lang.Object;"
 (new int[3][4][5][6][7][8][9]).getClass().getName()
     returns "[[[[[[[I"
 

Если этот Class объект представляет примитивный тип или void, возвращается null.

Если суперкласс является параметризованным типом, возвращаемый Type объект должен точно отражать фактические типы аргументов, используемые в исходном коде. Параметризованный тип, представляющий суперкласс, создаётся, если он ещё не был создан. См. объявление ParameterizedType для семантики процесса создания параметризованных типов. Если этот Class объект представляет либо класс Object, интерфейс, примитивный тип или void, то возвращается null. Если этот Class объект представляет класс массива, то возвращается Class объект, представляющий класс Object.

Если этот класс представляет тип массива, примитивный тип или void, этот метод возвращает null.

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

Если этот класс является вложенным классом, то этот метод эквивалентен вызову getPackageName() для внешнего класса.

Если этот класс является локальным классом или анонимным классом, то этот метод эквивалентен вызову getPackageName() для объявляющего класса внешнего метода или внешнего конструктора.

Если этот класс представляет тип массива, то этот метод возвращает имя пакета типа элемента. Если этот класс представляет примитивный тип или void, то возвращается имя пакета "java.lang".

Если этот Class объект представляет класс, возвращаемое значение — массив, содержащий объекты, представляющие все интерфейсы, непосредственно реализуемые классом. Порядок интерфейсных объектов в массиве соответствует порядку имён интерфейсов в части implements объявления класса, представленного этим Class объектом. Например, при объявленни:

class Shimmer implements FloorWax, DessertTopping { ... }

s.getClass().getInterfaces()[0]

s.getClass().getInterfaces()[1]

Если этот Class объект представляет интерфейс, массив содержит объекты, представляющие все интерфейсы, непосредственно расширяемые интерфейсом. Порядок интерфейсных объектов в массиве соответствует порядку имён интерфейсов в части extends объявления интерфейса, представленного этим Class объектом.

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

Если этот Class объект представляет примитивный тип или void, метод возвращает массив длиной 0.

Если этот Class объект представляет тип массива, интерфейсы Cloneable и java.io.Serializable возвращаются в этом порядке.

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

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

Если этот Class объект представляет интерфейс, массив содержит объекты, представляющие все интерфейсы, непосредственно расширяемые интерфейсом. Порядок интерфейсных объектов в массиве соответствует порядку имён интерфейсов в части extends объявления интерфейса, представленного этим Class объектом.

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

Если этот Class объект представляет примитивный тип или void, метод возвращает массив длиной 0.

Если этот Class объект представляет тип массива, интерфейсы Cloneable и java.io.Serializable возвращаются в этом порядке.

Если подлежащий класс является классом массива:

• его public, private и protected модификаторы такие же, как у его типа компонента
• его abstract и final модификаторы всегда true
• его модификатор интерфейса всегда false, даже если тип компонента является интерфейсом

Кодирования модификаторов определены в разделе 4.1 спецификации Java Virtual Machine.

Если подлежащий класс является классом массива:

• его PUBLIC, PRIVATE и PROTECTED флаги доступа такие же, как у его типа компонента
• его ABSTRACT и FINAL флаги присутствуют
• его INTERFACE флаг отсутствует, даже если тип компонента является интерфейсом

Простое имя класса массива — это простое имя компонента типа с присоединённым "[]". В частности, простое имя класса массива, компоненты которого являются анонимными, — это "[]".

• локальный класс
• анонимный класс
• неопределённый класс^{ПРОСМОТР}
• скрытый класс
• массив, у которого тип компонента не имеет канонического имени

Тип массива имеет каноническое имя только тогда, когда его компонентный тип имеет каноническое имя. Когда тип массива имеет каноническое имя, оно равно каноническому имени компонентного типа, за которым следует "[]".

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

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

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

Если этот Class объект представляет тип массива, примитивный тип или void, то этот метод возвращает массив длиной 0.

Элементы возвращаемого массива не отсортированы и не расположены в определенном порядке.

Если этот Class объект представляет тип массива, то возвращаемый массив содержит Method объект для каждого из общедоступных методов, унаследованных типом массива от Object. Он не содержит Method объект для clone().

Если этот Class объект представляет интерфейс, то возвращаемый массив не содержит никаких неявных методов, объявленных от Object. Таким образом, если в этом интерфейсе или любом из его суперинтерфейсов явно не объявлены методы, то возвращаемый массив имеет длину 0. (Обратите внимание, что Class объект, представляющий класс, всегда имеет общедоступные методы, унаследованные от Object.)

Возвращаемый массив никогда не содержит методы с именами "<init>" или "<clinit>".

Элементы возвращаемого массива не отсортированы и не расположены в определенном порядке.

В общем случае результат вычисляется по следующему 4-ступенчатому алгоритму. Пусть C — класс или интерфейс, представленный этим Class объектом:

1. Объединение методов состоит из:
   1. Объявленные общедоступные экземпляры и статические методы C, возвращаемые getDeclaredMethods() и отфильтрованные для включения только общедоступных методов.
   2. Если C — класс, отличный от Object, то включить результат применения этого алгоритма рекурсивно к суперклассу C.
   3. Включить результаты применения этого алгоритма рекурсивно ко всем непосредственным суперинтерфейсам C, но включать только методы экземпляров.
2. Объединение из шага 1 разделяется на подмножества методов с одинаковой сигнатурой (имя, типы параметров) и типом возвращаемого значения.
3. В каждом таком подмножестве выбираются только наиболее специфичные методы. Пусть метод M — метод из набора методов с одинаковой сигнатурой и типом возвращаемого значения. M является наиболее специфичным, если не существует такого метода N != M из того же набора, такой что N более специфичен, чем M. N более специфичен, чем M, если:
   1. N объявлен классом, а M — интерфейсом; или
   2. N и M объявлены классами или обоими интерфейсами, и тип объявления N такой же или является подтипом типа объявления M (очевидно, если типы объявления M и N являются одним типом, то M и N — один и тот же метод).
4. Результат этого алгоритма — объединение всех выбранных методов из шага 3.

Поле для отражения определяется алгоритмом, который следует. Пусть C — класс или интерфейс, представленный этим Class объектом:

1. Если C объявляет общедоступное поле с указанным именем, это и есть поле для отражения.
2. Если поле не было найдено на шаге 1 выше, этот алгоритм применяется рекурсивно к каждому прямому суперинтерфейсу C. Прямые суперинтерфейсы просматриваются в порядке их объявления.
3. Если поле не было найдено на шагах 1 и 2 выше, и у C есть суперкласс S, то этот алгоритм вызывается рекурсивно для S. Если у C нет суперкласса, то выбрасывается NoSuchFieldException.

Если этот Class объект представляет тип массива, то этот метод не находит length поле типа массива.

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

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

Этот метод не находит методов с именем или .

В общем случае, отражаемый метод определяется алгоритмом из 4 шагов, который следует. Пусть C — класс или интерфейс, представленный этим объектом:

1. Объединение методов состоит из:
   1. Объявленных публичных экземпляра и статических методов C, возвращаемых методом и отфильтрованных для включения только публичных методов, которые соответствуют заданным и
   2. Если C — класс, отличный от , то включается результат вызова этого алгоритма рекурсивно на суперклассе C.
   3. Включаются результаты вызова этого алгоритма рекурсивно на всех прямых суперинтерфейсах C, но включаются только методы экземпляра.
2. Это объединение разбивается на подмножества методов с одинаковым типом возвращаемого значения (выбор методов с шага 1 также гарантирует, что у них одинаковое имя метода и типы параметров).
3. Внутри каждого такого подмножества выбираются только наиболее специфичные методы. Пусть метод M — метод из набора методов с той же сигнатурой VM (тип возвращаемого значения, имя, типы параметров). M — наиболее специфичный, если нет такого метода N != M из того же набора, такого что N более специфичен, чем M. N более специфичен, чем M, если:
   1. N объявлен классом, а M — интерфейсом; или
   2. N и M объявлены либо классами, либо интерфейсами, и декларирующий тип N такой же или подтип декларирующего типа M (очевидно, если декларирующие типы M и N — один и тот же тип, то M и N — один и тот же метод).
4. Результат этого алгоритма произвольно выбирается из методов с наиболее специфичным типом возвращаемого значения среди всех выбранных методов с шага 3. Пусть R — тип возвращаемого значения метода M из набора всех выбранных методов с шага 3. M — метод с наиболее специфичным типом возвращаемого значения, если нет такого метода N != M из того же набора, имеющего тип возвращаемого значения S != R, такого что S является подтипом R, как определяется методом .

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

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

Если этот объект представляет тип массива, примитивный тип или void, то этот метод возвращает массив длиной 0.

Элементы в возвращаемом массиве не отсортированы и не в каком-либо конкретном порядке.

Компоненты возвращаются в том же порядке, в котором они объявлены в заголовке записи. Массив пуст, если у этого класса записи нет компонентов. Если класс не является классом записи, то есть isRecord() возвращает false, то этот метод возвращает null. И наоборот, если isRecord() возвращает true, то этот метод возвращает ненулевое значение.

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

Если этот объект Class представляет класс или интерфейс, у которого есть метод инициализации класса "<clinit>", то возвращаемый массив не содержит соответствующего объекта Method.

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

Если этот объект Class представляет тип массива, примитивный тип или void, то возвращаемый массив имеет длину 0.

Элементы в возвращаемом массиве не отсортированы и не расположены в определенном порядке.

Если этот объект Class представляет тип массива, то этот метод не находит поле length типа массива.

Если этот объект представляет тип массива, этот метод не находит метод.

Если этот класс находится в именованном Module, этот метод попытается найти ресурс в модуле. Это делается путём делегирования к загрузчику классов модуля методу findResource(String,String), вызывая его с именем модуля и абсолютным именем ресурса. Ресурсы в именованных модулях подчиняются правилам инкапсуляции, указанным в Module getResourceAsStream методе, и поэтому этот метод возвращает null, когда ресурс является не-".class" ресурсом в пакете, который не открыт для модуля вызывающего метода.

В противном случае, если этот класс не находится в именованном модуле, правила поиска ресурсов, связанных с данным классом, реализуются определяющим загрузчиком классов класса. Этот метод делегирует загрузчику классов этого объекта. Если этот объект был загружен загрузчиком Bootstrap, метод делегирует методу ClassLoader.getSystemResourceAsStream(java.lang.String).

Перед делегированием абсолютное имя ресурса строится из заданного имени ресурса по следующему алгоритму:

• Если name начинается с '/' ('\u002f'), абсолютное имя ресурса — это часть name, следующая за '/'.
• В противном случае абсолютное имя имеет следующий вид:

  modified_package_name/name

  Где modified_package_name — имя пакета этого объекта с '/', заменённым на '.' ('\u002e').

Если этот класс находится в именованном Module, этот метод попытается найти ресурс в модуле. Это делается путём делегирования к загрузчику классов модуля методу findResource(String,String), вызывая его с именем модуля и абсолютным именем ресурса. Ресурсы в именованных модулях подчиняются правилам инкапсуляции, указанным в Module getResourceAsStream методе, и поэтому этот метод возвращает null, когда ресурс является не-".class" ресурсом в пакете, который не открыт для модуля вызывающего метода.

В противном случае, если этот класс не находится в именованном модуле, правила поиска ресурсов, связанных с данным классом, реализуются определяющим загрузчиком классов класса. Этот метод делегирует загрузчику классов этого объекта. Если этот объект был загружен загрузчиком Bootstrap, метод делегирует методу ClassLoader.getSystemResource(java.lang.String).

Перед делегированием абсолютное имя ресурса строится из заданного имени ресурса по следующему алгоритму:

• Если name начинается с '/' ('\u002f'), абсолютное имя ресурса — это часть name, следующая за '/'.
• В противном случае абсолютное имя имеет следующий вид:

  modified_package_name/name

  Где modified_package_name — имя пакета этого объекта с '/', заменённым на '.' ('\u002e').

Прямым суперклассом класса записи является java.lang.Record. Класс записи является final. Класс записи имеет (возможно, ноль) компонентов записи; getRecordComponents() возвращает ненулевое, но возможно пустое значение для записи.

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

Этот метод полезен, когда клиенту нужно «сузить» тип объекта Class, чтобы передать его в API, который ограничивает объекты Class, которые он готов принять. Преобразование вызовет предупреждение во время компиляции, так как корректность преобразования нельзя проверить во время выполнения (потому что общие типы реализуются стиранием).

Обратите внимание, что любая аннотация, возвращаемая этим методом, является аннотацией объявления.

Значение истинности, возвращаемое этим методом, эквивалентно: getAnnotation(annotationClass) != null

Обратите внимание, что любые аннотации, возвращаемые этим методом, являются аннотациями объявления.

Обратите внимание, что любые аннотации, возвращаемые этим методом, являются аннотациями объявления.

Обратите внимание, что любая аннотация, возвращаемая этим методом, является аннотацией объявления.

Обратите внимание, что любые аннотации, возвращаемые этим методом, являются аннотациями объявления.

Обратите внимание, что любые аннотации, возвращаемые этим методом, являются аннотациями объявления.

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

Если этот объект Class представляет либо класс Object, тип интерфейса, тип массива, примитивный тип или void, то возвращаемое значение – null.

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

Если этот объект Class представляет интерфейс, возвращаемое значение – массив, содержащий объекты, представляющие использование типов интерфейсов для указания интерфейсов, прямо расширяемых этим интерфейсом. Порядок объектов в массиве соответствует порядку типов интерфейсов, используемых в ключе 'extends' объявления этого объекта Class.

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

Если этот объект Class представляет либо класс Object, тип массива, примитивный тип или void, возвращаемое значение – массив длиной 0.

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

Если этот объект Class представляет примитивный тип, тип массива или void, то этот метод возвращает массив с одним элементом, содержащим this.

Если этот объект Class представляет класс или интерфейс, а не класс массива, то:

• Если класс или интерфейс не скрыт, то результатом является описатель поля (JVMS 4.3.2) для класса или интерфейса. Вызов ClassDesc::ofDescriptor со строкой описателя результата создаёт объект ClassDesc, описывающий этот класс или интерфейс.
• Если класс или интерфейс скрыт, то результатом является строка вида:

  "L" + N + "." + <suffix> + ";"

  , где N — бинарное имя, закодированное во внутреннем формате, указанном в файле class, переданном в Lookup::defineHiddenClass, а <suffix> — имя без квалификатора. Скрытый класс или интерфейс не имеет номинального описателя. Результирующая строка не является описателем типа.

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

• Если тип элемента не является скрытым классом или интерфейсом, то этот класс массива может быть описан номинально. Вызов ClassDesc::ofDescriptor со строкой описателя результата создаёт объект ClassDesc, описывающий этот класс массива.
• Если тип элемента является скрытым классом или интерфейсом, то этот класс массива не может быть описан номинально. Результирующая строка не является описателем типа.

Если этот объект Class представляет примитивный тип или void, то результатом является строка описателя поля, которая представляет собой однобуквенный код, соответствующий примитивному типу или void ("B", "C", "D", "F", "I", "J", "S", "Z", "V") (JVMS 4.3.2).