Класс Class

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

Class.forName(className, true, currentLoader)

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

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

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

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

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

Для получения объекта 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.

Никакие другие объекты класса не считаются примитивными.

Если этот объект 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() для внешнего класса.

Если этот класс является локальным классом local class или анонимным классом anonymous class, то этот метод эквивалентен вызову 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 флаг отсутствует, даже если компонентный тип является интерфейсом

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

• локальный класс local class
• анонимный класс anonymous class
• скрытый класс hidden class
• массив, тип компонента которого не имеет канонического имени

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

Если у этого объекта 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 типа массива.

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

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

Этот метод не находит ни одного метода с именем "<init>" или "<clinit>".

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

1. Объединение методов состоит из:
   1. Объявленных публичных экземпляров и статических методов C, возвращаемых getDeclaredMethods(), и отфильтрованных для включения только публичных методов, которые соответствуют заданным name и parameterTypes
   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. Пусть R — тип возвращаемого значения метода M из множества всех выбранных методов с шага 3. M — метод с наиболее специфичным типом возвращаемого значения, если нет такого метода N != M из того же набора, имеющего тип возвращаемого значения S != R, такого что S — подтип R, как определено R.class.isAssignableFrom(java.lang.Class<?>)(S.class).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  `/[пакетное имя]/[имя ресурса]`

  Где `[пакетное имя]` — это имя пакета данного объекта с заменой '/' на '.' ('\u002e').

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

В противном случае, если этот класс не находится в именованном модуле, правила поиска ресурсов, связанных с данным классом, реализуются определяющим загрузчиком классов класса. Этот метод делегирует загрузчику классов этого объекта Class. Если этот объект 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).