Класс Class<T>

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

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, с помощью тождественного преобразования или расширяющего преобразования ссылки. Подробности см. в разделах 5.1.1 и 5.1.4 Спецификации языка Java.

Существует девять предопределённых объектов 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() для охватывающего класса.

Если этот класс является локальным классом или анонимным классом, метод эквивалентен вызову 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.

Если базовый класс является классом массива:

• его флаги доступа 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>".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  modified_package_name/name

  Здесь modified_package_name — это имя пакета данного объекта, в котором '/' заменено на '.' ('\u002e').

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

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

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

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

  modified_package_name/name

  Здесь modified_package_name — это имя пакета данного объекта, в котором '/' заменено на '.' ('\u002e').

Непосредственным суперклассом record-класса является java.lang.Record. Record-класс является финальным. У record-класса может быть ноль или более компонентов; getRecordComponents() возвращает ненулевое, но потенциально пустое значение для record-класса.

Обратите внимание, что класс Record не является 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).