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

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

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

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

class Shimmer implements FloorWax, DessertTopping { ... }

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Как правило, результат вычисляется с помощью следующего четырехэтапного алгоритма. Пусть 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 — метод из набора методов с одинаковой сигнатурой 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 представляет класс или интерфейс без объявленных полей, этот метод возвращает массив нулевой длины.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  modified_package_name/name

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

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

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

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

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

  modified_package_name/name

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если этот объект 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).