Класс Class<T>

public String toString()

Преобразует объект в строку. Представление в виде строки — это строка "class" или "interface", за которой следует пробел и имя класса в формате, возвращаемом getName. Если этот Class объект представляет примитивный тип, этот метод возвращает имя примитивного типа. Если этот Class объект представляет тип void, этот метод возвращает "void". Если этот Class объект представляет тип массива, этот метод возвращает "class " и затем getName.

public String toGenericString()

Возвращает строку, описывающую этот Class, включая информацию о модификаторах и параметрах типа. Строка форматируется как список модификаторов типа, если таковые имеются, за которым следует вид типа (пустая строка для примитивных типов и class, enum, interface, @interface, или record соответственно), за которым следует имя типа, за которым следует список параметров типа в квадратных скобках, разделенных запятыми, если таковые имеются, включая информативные границы параметров типа, если таковые имеются. Пробел используется для разделения модификаторов друг от друга и для разделения любых модификаторов от вида типа. Модификаторы выставляются в каноническом порядке. Если параметров типа нет, список параметров типа опускается. Для типа массива строка начинается с имени типа, за которой следует список параметров типа в квадратных скобках, разделенных запятыми, если таковые имеются, за которым следует последовательность [] символов, один набор скобок на каждую размерность массива.

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

public static Class<?> forName(String className) throws ClassNotFoundException

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

Class.forName(className, true, currentLoader)

, где currentLoader обозначает класс-загрузчик, определяющий текущий класс.

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

Class t = Class.forName("java.lang.Thread")

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

public static Class<?> forName(String name, boolean initialize, ClassLoader loader) throws ClassNotFoundException

Возвращает Class объект, связанный с классом или интерфейсом с заданным именем строки, используя заданный класс-загрузчик. Учитывая полное квалифицированное имя класса или интерфейса (в том же формате, что и возвращаемый getName), этот метод пытается найти и загрузить класс или интерфейс. Указанный класс-загрузчик используется для загрузки класса или интерфейса. Если параметр loader равен null, класс загружается через загрузчик Bootstrap. Класс инициализируется только если параметр initialize равен true и если он еще не был инициализирован ранее.

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

Если name обозначает класс массива, тип элемента класса массива загружается, но не инициализируется.

Например, в методе экземпляра выражение:

Class.forName("Foo")

эквивалентно:

Class.forName("Foo", true, this.getClass().getClassLoader())

Обратите внимание, что этот метод выбрасывает ошибки, связанные с загрузкой, связыванием или инициализацией, как указано в разделах 12.2, 12.3 и 12.4 Спецификации языка Java. Обратите внимание, что этот метод не проверяет, доступен ли запрашиваемый класс вызывающему его.

public static Class<?> forName(Module module, String name)

Возвращает Class с заданным бинарным именем в заданном модуле.

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

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

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

@Deprecated(since="9") public T newInstance() throws InstantiationException, IllegalAccessException

 clazz.newInstance()
 

 clazz.getDeclaredConstructor().newInstance()
 

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

public boolean isInstance(Object obj)

Определяет, является ли указанный Object совместимым с объектом, представленным этим Class. Этот метод является динамическим эквивалентом оператора Java instanceof. Метод возвращает true если указанный Object аргумент не равен null и может быть преобразован к ссылочному типу, представленному этим Class объектом, без подъёма ClassCastException.. В противном случае он возвращает false.

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

public boolean isAssignableFrom(Class<?> cls)

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

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

public boolean isInterface()

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

public boolean isArray()

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

public boolean isPrimitive()

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

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

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

public boolean isAnnotation()

Возвращает true, если этот Class объект представляет интерфейс аннотации. Обратите внимание, что если этот метод возвращает true, isInterface() также вернёт true, так как все интерфейсы аннотаций являются также интерфейсами.

public boolean isSynthetic()

Возвращает true тогда и только тогда, когда у этого класса установлен бит модификатора synthetic.

public String getName()

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

Если этот 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"
 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"
 

public ClassLoader getClassLoader()

Возвращает загрузчик классов для класса. Некоторые реализации могут использовать null для обозначения загрузчика базового класса. В таких реализациях этот метод вернёт null, если данный класс загружен базовым загрузчиком.

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

public Module getModule()

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

public TypeVariable<Class<T>>[] getTypeParameters()

Возвращает массив TypeVariable объектов, представляющих переменные типа, объявленные обобщённым объявлением, представленным этим GenericDeclaration объектом, в порядке объявления. Возвращает массив длины 0, если базовое обобщённое объявление не объявляет переменных типа.

public Class<? super T> getSuperclass()

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

public Type getGenericSuperclass()

Возвращает Type , представляющий непосредственный суперкласс сущности (класс, интерфейс, примитивный тип или void), представленной этим Class объектом.

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

public Package getPackage()

Получает пакет этого класса.

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

public String getPackageName()

Возвращает полное квалифицированное имя пакета.

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

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

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

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

public Class<?>[] getInterfaces()

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

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

class Shimmer implements FloorWax, DessertTopping { ... }

предположим, что значение s является экземпляром Shimmer; значение выражения:

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

является Class объектом, представляющим интерфейс FloorWax; и значение:

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

является Class объектом, представляющим интерфейс DessertTopping.

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

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

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

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

public Type[] getGenericInterfaces()

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

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

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

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

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

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

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

public Class<?> getComponentType()

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

public int getModifiers()

Возвращает модификаторы языка Java для этого класса или интерфейса, закодированные в целое число. Модификаторы состоят из констант Java Virtual Machine для public, protected, private, final, static, abstract и interface; их следует декодировать с помощью методов класса Modifier.

Если базовый класс является классом массива, то его модификаторы public, private и protected совпадают с модификаторами его типа компонента. Если этот Class объект представляет примитивный тип или void, его модификатор public всегда равен true, а его модификаторы protected и private всегда равны false. Если этот Class объект представляет класс массива, примитивный тип или void, то его модификатор final всегда равен true, а модификатор интерфейса всегда равен false. Значения других модификаторов не определяются этой спецификацией.

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

public Object[] getSigners()

Получает подписантов этого класса.

public Method getEnclosingMethod() throws SecurityException

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

public Constructor<?> getEnclosingConstructor() throws SecurityException

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

public Class<?> getDeclaringClass() throws SecurityException

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

public Class<?> getEnclosingClass() throws SecurityException

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

public String getSimpleName()

Возвращает простое имя базового класса, как указано в исходном коде. Пустая строка возвращается, если базовый класс является анонимным. Синтетический класс, отсутствующий в исходном коде, может иметь непустое имя, включающее специальные символы, такие как "$".

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

public String getTypeName()

Возвращает информативную строку для имени этого класса или интерфейса.

public String getCanonicalName()

Возвращает каноническое имя базового класса, определённое в Спецификации языка Java. Возвращает null если базовый класс не имеет канонического имени. К классам без канонических имён относятся:

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

public boolean isAnonymousClass()

Возвращает true тогда и только тогда, когда базовый класс является анонимным классом.

public boolean isLocalClass()

Возвращает true тогда и только тогда, когда базовый класс является локальным классом.

public boolean isMemberClass()

Возвращает true тогда и только тогда, когда базовый класс является членом класса.

public Class<?>[] getClasses()

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

public Field[] getFields() throws SecurityException

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

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

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

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

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

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

public Method[] getMethods() throws SecurityException

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

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

public Constructor<?>[] getConstructors() throws SecurityException

Возвращает массив, содержащий объекты Constructor, отражающие все открытые конструкторы класса, представленного этим объектом Class. Массив длиной 0 возвращается, если у класса нет открытых конструкторов, или если класс является массивом, или если класс отражает примитивный тип или void.

public Field getField(String name) throws NoSuchFieldException, SecurityException

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

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

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

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

public Method getMethod(String name, Class<?>... parameterTypes) throws NoSuchMethodException, SecurityException

Возвращает объект Method, отражающий указанный общедоступный метод-член класса или интерфейса, представленного этим объектом Class. Параметр name является строкой String, указывающей простое имя желаемого метода. Параметр parameterTypes — массив объектов Class, которые идентифицируют формальные типы параметров метода в порядке объявления. Если parameterTypes равен null, он обрабатывается как пустой массив.

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

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

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

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

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

public Constructor<T> getConstructor(Class<?>... parameterTypes) throws NoSuchMethodException, SecurityException

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

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

public Class<?>[] getDeclaredClasses() throws SecurityException

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

public Field[] getDeclaredFields() throws SecurityException

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

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

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

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

public RecordComponent[] getRecordComponents()

Возвращает массив объектов RecordComponent , представляющих все компоненты записи этого класса записи, или null , если этот класс не является классом записи.

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

public Method[] getDeclaredMethods() throws SecurityException

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

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

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

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

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

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

public Constructor<?>[] getDeclaredConstructors() throws SecurityException

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

См. раздел Спецификация языка Java, раздел 8.2.

public Field getDeclaredField(String name) throws NoSuchFieldException, SecurityException

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

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

public Method getDeclaredMethod(String name, Class<?>... parameterTypes) throws NoSuchMethodException, SecurityException

Возвращает объект Method , отражающий указанный объявленный метод класса или интерфейса, представленного этим объектом Class . Параметр name — это String , который задаёт простое имя требуемого метода, а параметр parameterTypes — это массив объектов Class , которые определяют формальные типы параметров метода в порядке объявления. Если в классе объявлено более одного метода с одинаковыми типами параметров, и один из этих методов имеет тип возвращаемого значения, более специфичный, чем любой другой, возвращается этот метод; в противном случае выбирается один из методов произвольно. Если имя — "<init>" или "<clinit>," генерируется исключение NoSuchMethodException .

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

public Constructor<T> getDeclaredConstructor(Class<?>... parameterTypes) throws NoSuchMethodException, SecurityException

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

public InputStream getResourceAsStream(String name)

Поиск ресурса с заданным именем.

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

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

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

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

  modified_package_name/name

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

public URL getResource(String name)

Поиск ресурса с заданным именем.

Если этот класс находится в именованном 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').

public ProtectionDomain getProtectionDomain()

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

public boolean desiredAssertionStatus()

Возвращает состояние проверки утверждений, которое было бы назначено этому классу, если бы он был инициализирован в момент вызова этого метода. Если для этого класса было установлено состояние проверки утверждений, будет возвращено последнее значение; в противном случае, если для этого класса установлено какое-либо значение по умолчанию для проверки утверждений, будет возвращено последнее значение для самого специфического значения по умолчанию пакета; в противном случае, если этот класс не является системным классом (т.е. имеет загрузчик классов), будет возвращено значение по умолчанию для проверки утверждений загрузчика классов; в противном случае — значение по умолчанию для проверки утверждений системного класса.

public boolean isEnum()

Возвращает true, если и только если этот класс был объявлен как перечисление в исходном коде. Обратите внимание, что Enum сам по себе не является классом перечисления. Также обратите внимание, что если константа перечисления объявлена с телом класса, класс этого объекта константы перечисления является анонимным классом, а не классом объявляющего класса перечисления. Метод Enum.getDeclaringClass() константы перечисления можно использовать для получения класса класса перечисления, объявляющего константу.

public boolean isRecord()

Возвращает true тогда и только тогда, когда этот класс является классом-записью.

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

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

public T[] getEnumConstants()

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

public T cast(Object obj)

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

public <U> Class<? extends U> asSubclass(Class<U> clazz)

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

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

public <A extends Annotation> A getAnnotation(Class<A> annotationClass)

Возвращает аннотацию этого элемента для указанного типа, если такая аннотация присутствует, в противном случае null.

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

public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)

Возвращает true, если аннотация для указанного типа присутствует на этом элементе, в противном случае false. Этот метод разработан в первую очередь для удобного доступа к аннотациям-маркерам.

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

public <A extends Annotation> A[] getAnnotationsByType(Class<A> annotationClass)

Возвращает аннотации, связанные с этим элементом. Если аннотаций, связанных с этим элементом, нет, возвращаемое значение — массив длиной 0. Разница между этим методом и AnnotatedElement.getAnnotation(Class) заключается в том, что этот метод определяет, является ли его аргумент повторяемым типом аннотации (JLS 9.6), и если да, то пытается найти одну или несколько аннотаций этого типа, «просматривая» аннотацию-контейнер. Вызывающий метод может свободно изменять возвращённый массив; это не повлияет на массивы, возвращаемые другим вызывающим сторонам.

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

public Annotation[] getAnnotations()

Возвращает аннотации, присутствующие на этом элементе. Если аннотаций присутствующих на этом элементе нет, возвращаемое значение — массив длиной 0. Вызывающий метод может свободно изменять возвращаемый массив; это не повлияет на массивы, возвращаемые другими вызывающими сторонами.

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

public <A extends Annotation> A getDeclaredAnnotation(Class<A> annotationClass)

Возвращает аннотацию этого элемента для указанного типа, если такая аннотация непосредственно присутствует, в противном случае null. Этот метод игнорирует унаследованные аннотации. (Возвращает null, если аннотации непосредственно не присутствуют на этом элементе.)

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

public <A extends Annotation> A[] getDeclaredAnnotationsByType(Class<A> annotationClass)

Возвращает аннотацию(и) этого элемента для указанного типа, если такие аннотации непосредственно присутствуют или косвенно присутствуют. Этот метод игнорирует унаследованные аннотации. Если указанных аннотаций непосредственно или косвенно нет на этом элементе, возвращаемое значение — массив длиной 0. Разница между этим методом и AnnotatedElement.getDeclaredAnnotation(Class) заключается в том, что этот метод определяет, является ли его аргумент повторяемым типом аннотации (JLS 9.6), и если да, то пытается найти одну или несколько аннотаций этого типа, «просматривая» аннотацию-контейнер, если она присутствует. Вызывающий метод может свободно изменять возвращаемый массив; это не повлияет на массивы, возвращаемые другими вызывающими сторонами.

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

public Annotation[] getDeclaredAnnotations()

Возвращает аннотации, непосредственно присутствующие на этом элементе. Этот метод игнорирует унаследованные аннотации. Если аннотаций непосредственно присутствующих на этом элементе нет, возвращаемое значение — массив длиной 0. Вызывающий метод может свободно изменять возвращаемый массив; это не повлияет на массивы, возвращаемые другими вызывающими сторонами.

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

public AnnotatedType getAnnotatedSuperclass()

Возвращает объект AnnotatedType, представляющий использование типа для указания суперкласса сущности, представленной этим объектом Class. (Использование типа Foo для указания суперкласса в '... extends Foo' отличается от объявления класса Foo.)

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

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

public AnnotatedType[] getAnnotatedInterfaces()

Возвращает массив объектов AnnotatedType, представляющих использование типов для указания суперинтерфейсов сущности, представленной этим объектом Class. (Использование типа Foo для указания суперинтерфейса в '... implements Foo' отличается от объявления интерфейса Foo.)

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

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

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

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

public Class<?> getNestHost()

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

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

public boolean isNestmateOf(Class<?> c)

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

public Class<?>[] getNestMembers()

Возвращает массив, содержащий объекты Class, представляющие все классы и интерфейсы, являющиеся членами гнезда, к которому принадлежит класс или интерфейс, представленный этим объектом Class. Сначала этот метод получает хост гнезда, H, гнезда, к которому принадлежит класс или интерфейс, представленный этим объектом Class. Нулевой элемент возвращаемого массива — H. Затем для каждого класса или интерфейса C, который регистрируется H как член своего гнезда, этот метод пытается получить объект Class для C (используя загрузчик определяющего класса текущего объекта Class), а затем получает хост гнезда гнезда, к которому принадлежит C. Классы и интерфейсы, которые регистрируются H как члены гнезда, и для которых H может быть определен как их хост гнезда, указываются последующими элементами возвращаемого массива. Порядок таких элементов не определён. Повторы допускаются.

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

public String descriptorString()

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

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

public Class<?> componentType()

Возвращает тип компонента этого Class, если он описывает тип массива, или null в противном случае.

public Class<?> arrayType()

Возвращает Class для типа массива, чьим типом компонента описывается этот класс Class.

public Optional<ClassDesc> describeConstable()

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

public boolean isHidden()

Возвращает true тогда и только тогда, когда базовый класс является скрытым классом.

public Class<?>[] getPermittedSubclasses()

Возвращает массив объектов Class, представляющих непосредственные подинтерфейсы или подклассы, разрешённые для расширения или реализации этого класса или интерфейса, если он запечатан. Порядок таких элементов не определён. Массив пуст, если у этого запечатанного класса или интерфейса нет разрешённых подклассов. Если этот Class объект представляет примитивный тип, void, тип массива или класс или интерфейс, который не является запечатанным, то есть isSealed() возвращает false, то этот метод возвращает null. И наоборот, если isSealed() возвращает true, то этот метод возвращает ненулевое значение. Для каждого класса или интерфейса C, который записан как разрешённый непосредственный подинтерфейс или подкласс этого класса или интерфейса, этот метод пытается получить объект Class для C (используя загрузчик классов определения текущего Class объекта). Объекты Class, которые могут быть получены и являются непосредственными подинтерфейсами или подклассами этого класса или интерфейса, указываются элементами возвращаемого массива. Если объект Class получить не удаётся, он молча игнорируется и не включается в результирующий массив.

public boolean isSealed()

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