Класс Class<T>

Экземпляры класса Class представляют классы и интерфейсы в работающем приложении Java. Перечисление — это вид класса, а аннотация — вид интерфейса. Каждый массив также принадлежит классу, который отражается как объект Class, используемый всеми массивами с тем же типом элементов и числом измерений. Примитивные типы Java (boolean, byte, char, short, int, long, float, и double) и ключевое слово void также представлены как объекты Class.

Объекты Class не имеют публичного конструктора. Вместо этого объекты Class создаются автоматически виртуальной машиной Java при загрузке классов и при вызовах метода defineClass в загрузчике классов.

Следующий пример использует объект Class для вывода имени класса объекта:

void printClassName(Object obj) {
    System.out.println("The class of " + obj +
                       " is " + obj.getClass().getName());
}

Также возможно получить объект Class для именованного типа (или для void) с помощью литерала класса. См. раздел 15.8.2 спецификации языка Java™. Например:

System.out.println("The name of class Foo is: "+Foo.class.getName());

Методы

toString

public String toString()

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

Overrides:

toString в классе Object

Возвращает:

строковое представление этого объекта класса.

toGenericString

public String toGenericString()

Возвращает:

строку, описывающую этот Class, включая информацию о модификаторах и параметрах типа

С:

1.8

forName

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

Class.forName(className, true, currentLoader)

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

Параметры:

className - полное квалифицированное имя желаемого класса.

Возвращает:

объект Class для класса с указанным именем.

Издает:

LinkageError - если связывание завершается неудачно

ExceptionInInitializerError - если инициализация, вызванная этим методом, завершается неудачно

ClassNotFoundException - если класс не может быть найден

forName

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

Class.forName("Foo")

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

Параметры:

name - полное квалифицированное имя желаемого класса

initialize - если true класс будет инициализирован. См. раздел 12.4 спецификации языка Java.

loader - загрузчик классов, из которого должен быть загружен класс

Возвращает:

объект класса, представляющий желаемый класс

Издает:

LinkageError - если связывание завершается неудачно

ExceptionInInitializerError - если инициализация, вызванная этим методом, завершается неудачно

ClassNotFoundException - если класс не может быть найден указанным загрузчиком классов

С:

1.2

См. также:

forName(String), ClassLoader

newInstance

public T newInstance()
              throws InstantiationException,
                     IllegalAccessException

Возвращает:

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

Издает:

IllegalAccessException - если класс или его конструктор nullary недоступны.

InstantiationException - если этот Class представляет абстрактный класс, интерфейс, класс массива, примитивный тип или void; или если у класса нет конструктора nullary; или если создание экземпляра завершается неудачно по какой-либо другой причине.

ExceptionInInitializerError - если инициализация, вызванная этим методом, завершается неудачно.

SecurityException - Если присутствует менеджер безопасности, s, и загрузчик классов вызывающего объекта не совпадает или не является предком загрузчика классов текущего класса и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса.

isInstance

public boolean isInstance(Object obj)

Параметры:

obj - проверяемый объект

Возвращает:

true, если obj является экземпляром этого класса

С:

JDK1.1

isAssignableFrom

public boolean isAssignableFrom(Class<?> cls)

Параметры:

cls - объект Class для проверки

Возвращает:

значение boolean , указывающее, могут ли объекты типа cls быть назначены объектам этого класса

Издает:

NullPointerException - если указанный параметр Class равен null.

С:

JDK1.1

isInterface

public boolean isInterface()

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

Возвращает:

true , если этот объект представляет интерфейс; false в противном случае.

isArray

public boolean isArray()

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

Возвращает:

true , если этот объект представляет класс массива; false в противном случае.

С:

JDK1.1

isPrimitive

public boolean isPrimitive()

Возвращает:

true тогда и только тогда, когда этот класс представляет примитивный тип

С тех пор:

JDK1.1

См. также:

Boolean.TYPE, Character.TYPE, Byte.TYPE, Short.TYPE, Integer.TYPE, Long.TYPE, Float.TYPE, Double.TYPE, Void.TYPE

isAnnotation

public boolean isAnnotation()

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

Возвращает:

true если этот объект класса представляет тип аннотации; false в противном случае

С тех пор:

1.5

isSynthetic

public boolean isSynthetic()

Возвращает true если этот класс является синтетическим классом; возвращает false в противном случае.

Возвращает:

true тогда и только тогда, когда этот класс является синтетическим классом, как определено в спецификации языка Java.

С тех пор:

1.5

getName

public String getName()

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"

Возвращает:

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

getClassLoader

public ClassLoader getClassLoader()

Возвращает:

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

Исключение:

SecurityException - если существует диспетчер безопасности, и его метод checkPermission запрещает доступ к загрузчику класса для класса.

См. также:

ClassLoader, SecurityManager.checkPermission(java.security.Permission), RuntimePermission

getTypeParameters

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

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

Определено в:

getTypeParameters в интерфейсе GenericDeclaration

Возвращает:

массив TypeVariable объектов, которые представляют переменные типов, объявленные этим общим объявлением

Исключение:

GenericSignatureFormatError - если общая подпись этого общего объявления не соответствует формату, указанному в Спецификации виртуальной машины Java™

С тех пор:

1.5

getSuperclass

public Class<? super T> getSuperclass()

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

Возвращает:

суперкласс класса, представленного этим объектом.

getGenericSuperclass

public Type getGenericSuperclass()

Возвращает:

суперкласс класса, представленного этим объектом

Исключение:

GenericSignatureFormatError - если общая подпись класса не соответствует формату, указанному в Спецификации виртуальной машины Java™

TypeNotPresentException - если общий суперкласс ссылается на не существующее объявление типа

MalformedParameterizedTypeException - если общий суперкласс ссылается на параметризованный тип, который не может быть создан по какой-либо причине

С тех пор:

1.5

getPackage

public Package getPackage()

Возвращает:

пакет класса или null, если информация о пакете недоступна из архива или кодовой базы.

getInterfaces

public Class<?>[] getInterfaces()

class Shimmer implements FloorWax, DessertTopping { ... }

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

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

Возвращает:

массив интерфейсов, реализованных этим классом.

getGenericInterfaces

public Type[] getGenericInterfaces()

Возвращает:

массив интерфейсов, реализованных этим классом

Исключение:

GenericSignatureFormatError - если сигнатура обобщённого класса не соответствует формату, указанному в Спецификации Java™ виртуальной машины

TypeNotPresentException - если любой из обобщённых суперинтерфейсов ссылается на не существующее объявление типа

MalformedParameterizedTypeException - если любой из обобщённых суперинтерфейсов ссылается на параметризованный тип, который не может быть инстанцирован по какой-либо причине

С:

1.5

getComponentType

public Class<?> getComponentType()

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

Возвращает:

Class, представляющий тип компонента этого класса, если этот класс является массивом

С:

JDK1.1

См. также:

Array

getModifiers

public int getModifiers()

Возвращает:

int, представляющий модификаторы для этого класса

С:

JDK1.1

См. также:

Modifier

getSigners

public Object[] getSigners()

Получает подписывающие лица этого класса.

Возвращает:

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

С:

JDK1.1

getEnclosingMethod

public Method getEnclosingMethod()
                          throws SecurityException

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

Возвращает:

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

Исключение:

SecurityException - Если присутствует менеджер безопасности, s, и выполняется любое из следующих условий:

• загрузчик класса вызывающего не совпадает с загрузчиком класса окружающего и вызов метода s.checkPermission с RuntimePermission("accessDeclaredMembers") отказывает доступ к методам в окружающем классе
• загрузчик класса вызывающего не совпадает с или предком загрузчика класса окружающего и вызов метода s.checkPackageAccess() отказывает доступ к пакету окружающего класса

С:

1.5

getEnclosingConstructor

public Constructor<?> getEnclosingConstructor()
                                       throws SecurityException

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

Возвращает:

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

Исключение:

SecurityException - Если присутствует менеджер безопасности, s, и выполняется любое из следующих условий:

• загрузчик класса вызывающего не совпадает с загрузчиком класса окружающего и вызов метода s.checkPermission с RuntimePermission("accessDeclaredMembers") отказывает доступ к конструкторам в окружающем классе
• загрузчик класса вызывающего не совпадает с или предком загрузчика класса окружающего и вызов метода s.checkPackageAccess() отказывает доступ к пакету окружающего класса

С:

1.5

getDeclaringClass

public Class<?> getDeclaringClass()
                           throws SecurityException

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

Возвращает:

класс-объявитель для этого класса

Исключение:

SecurityException - Если присутствует менеджер безопасности, s, и загрузчик класса вызывающего не совпадает с или предком загрузчика класса объявляющего, и вызов s.checkPackageAccess() отказывает доступ к пакету класса-объявителя

С:

JDK1.1

getEnclosingClass

public Class<?> getEnclosingClass()
                           throws SecurityException

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

Возвращает:

непосредственно окружающий класс базового класса

Исключение:

SecurityException - Если присутствует менеджер безопасности, s, и загрузчик класса вызывающего не совпадает с или предком загрузчика класса окружающего, и вызов s.checkPackageAccess() отказывает доступ к пакету окружающего класса

С:

1.5

getSimpleName

public String getSimpleName()

Возвращает:

простое имя базового класса

С:

1.5

getTypeName

public String getTypeName()

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

Определено в:

getTypeName в интерфейсе Type

Возвращает:

информативную строку для имени этого типа

С:

1.8

getCanonicalName

public String getCanonicalName()

Возвращает каноническое имя базового класса, как определено спецификацией языка Java. Возвращает null, если базовый класс не имеет канонического имени (т.е. если он является локальным или анонимным классом или массивом, тип компонента которого не имеет канонического имени).

Возвращает:

каноническое имя базового класса, если оно существует, и null в противном случае.

С:

1.5

isAnonymousClass

public boolean isAnonymousClass()

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

Возвращает:

true тогда и только тогда, когда этот класс является анонимным классом.

С:

1.5

isLocalClass

public boolean isLocalClass()

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

Возвращает:

true тогда и только тогда, когда этот класс является локальным классом.

С:

1.5

isMemberClass

public boolean isMemberClass()

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

Возвращает:

true тогда и только тогда, когда этот класс является внутренним классом.

С:

1.5

getClasses

public Class<?>[] getClasses()

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

Возвращает:

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

Исключение:

SecurityException - если присутствует менеджер безопасности, s, и загрузчик класса вызывающего метода не совпадает с загрузчиком класса текущего класса или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса.

С момента:

JDK1.1

getFields

public Field[] getFields()
                  throws SecurityException

Возвращает:

массив объектов Field , представляющих общедоступные поля

Исключение:

SecurityException - если присутствует менеджер безопасности, s, и загрузчик класса вызывающего метода не совпадает с загрузчиком класса текущего класса или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса.

С момента:

JDK1.1

getMethods

public Method[] getMethods()
                    throws SecurityException

Возвращает:

массив объектов Method , представляющих общедоступные методы этого класса

Исключение:

SecurityException - если присутствует менеджер безопасности, s, и загрузчик класса вызывающего метода не совпадает с загрузчиком класса текущего класса или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса.

С момента:

JDK1.1

getConstructors

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

Возвращает массив объектов Constructor , отражающих все общедоступные конструкторы класса, представленного этим объектом Class . Массив длиной 0 возвращается, если у класса нет общедоступных конструкторов, или если класс является классом массива, или если класс отражает примитивный тип или void. Обратите внимание, что, хотя этот метод возвращает массив объектов Constructor<T> (то есть массив конструкторов из этого класса), тип возвращаемого значения этого метода Constructor<?>[] и не Constructor<T>[] , как можно было бы ожидать. Этот менее информативный тип возвращаемого значения необходим, поскольку после возвращения из этого метода массив может быть изменён для хранения объектов Constructor для разных классов, что нарушило бы гарантии типа Constructor<T>[].

Возвращает:

массив объектов Constructor , представляющих общедоступные конструкторы этого класса

Исключение:

SecurityException - если присутствует менеджер безопасности, s, и загрузчик класса вызывающего метода не совпадает с загрузчиком класса текущего класса или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса.

С момента:

JDK1.1

getField

public Field getField(String name)
               throws NoSuchFieldException,
                      SecurityException

Параметры:

name - имя поля

Возвращает:

объект Field этого класса, указанный в name

Исключение:

NoSuchFieldException - если поле с заданным именем не найдено.

NullPointerException - если name имеет значение null

SecurityException - Если присутствует менеджер безопасности, s, и загрузчик класса вызывающего метода не совпадает с загрузчиком класса текущего класса или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса.

С момента:

JDK1.1

getMethod

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

Параметры:

name - имя метода

parameterTypes - список параметров

Возвращает:

объект Method, соответствующий указанному name и parameterTypes.

Исключение:

NoSuchMethodException - если метод с указанным именем не найден или если имя равно "<init>" или "<clinit>".

NullPointerException - если name равно null

SecurityException - Если присутствует менеджер безопасности, s, и загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса, или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету текущего класса.

С:

JDK1.1

getConstructor

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

Параметры:

parameterTypes - массив параметров

Возвращает:

объект Constructor публичного конструктора, соответствующего указанным parameterTypes

Исключение:

NoSuchMethodException - если метод с указанным именем не найден.

SecurityException - Если присутствует менеджер безопасности, s, и загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса, или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету текущего класса.

С:

JDK1.1

getDeclaredClasses

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

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

Возвращает:

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

Исключение:

SecurityException - Если присутствует менеджер безопасности, s, и выполняются следующие условия:

• загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса и вызов s.checkPermission с RuntimePermission("accessDeclaredMembers") запрещает доступ к объявленным классам внутри этого класса
• загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса, или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса

С:

JDK1.1

getDeclaredFields

public Field[] getDeclaredFields()
                          throws SecurityException

Возвращает:

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

Исключение:

SecurityException - Если присутствует менеджер безопасности, s, и выполняются следующие условия:

• загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса и вызов s.checkPermission с RuntimePermission("accessDeclaredMembers") запрещает доступ к объявленным полям внутри этого класса
• загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса, или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса

С:

JDK1.1

getDeclaredMethods

public Method[] getDeclaredMethods()
                            throws SecurityException

Возвращает:

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

Исключение:

SecurityException - Если присутствует менеджер безопасности, s, и выполняются следующие условия:

• загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса и вызов s.checkPermission с RuntimePermission("accessDeclaredMembers") запрещает доступ к объявленным методам внутри этого класса
• загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса, или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса

С:

JDK1.1

getDeclaredConstructors

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

Возвращает:

массив объектов Constructor , представляющих все объявленные конструкторы этого класса

Исключение:

SecurityException - Если присутствует менеджер безопасности, s, и выполняются следующие условия:

• загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса и вызов s.checkPermission с RuntimePermission("accessDeclaredMembers") запрещает доступ к объявленным конструкторам внутри этого класса
• загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса, или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса

С:

JDK1.1

getDeclaredField

public Field getDeclaredField(String name)
                       throws NoSuchFieldException,
                              SecurityException

Параметры:

name - имя поля

Возвращает:

объект Field для указанного поля в этом классе

Исключение:

NoSuchFieldException - если поле с указанным именем не найдено.

NullPointerException - если name равно null

SecurityException - Если присутствует менеджер безопасности, s, и выполняются следующие условия:

• загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса и вызов s.checkPermission с RuntimePermission("accessDeclaredMembers") запрещает доступ к объявленному полю
• загрузчик класса вызывающего кода не совпадает с загрузчиком класса текущего класса, или не является его предком, и вызов s.checkPackageAccess() запрещает доступ к пакету этого класса

С:

JDK1.1

getDeclaredMethod

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

Параметры:

name — имя метода

parameterTypes — массив параметров

Возвращает:

объект Method для метода этого класса, соответствующего указанному имени и параметрам

Исключения:

NoSuchMethodException — если соответствующий метод не найден.

NullPointerException — если name равно null

SecurityException — если присутствует менеджер безопасности s и выполняются любые из следующих условий:

• загрузчик классов вызывающего объекта не совпадает с загрузчиком классов этого класса, и вызов метода s.checkPermission с RuntimePermission("accessDeclaredMembers") отказывает доступ к объявленному методу
• загрузчик классов вызывающего объекта не совпадает и не является предком загрузчика классов текущего класса, и вызов метода s.checkPackageAccess() отказывает доступ к пакету этого класса

С:

JDK1.1

getDeclaredConstructor

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

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

Параметры:

parameterTypes — массив параметров

Возвращает:

Объект Constructor для конструктора со списком параметров

Исключения:

NoSuchMethodException — если соответствующий метод не найден.

SecurityException — если присутствует менеджер безопасности s и выполняются любые из следующих условий:

• загрузчик классов вызывающего объекта не совпадает с загрузчиком классов этого класса, и вызов метода s.checkPermission с RuntimePermission("accessDeclaredMembers") отказывает доступ к объявленному конструктору
• загрузчик классов вызывающего объекта не совпадает и не является предком загрузчика классов текущего класса, и вызов метода s.checkPackageAccess() отказывает доступ к пакету этого класса

С:

JDK1.1

getResourceAsStream

public InputStream getResourceAsStream(String name)

Параметры:

name — имя искомого ресурса

Возвращает:

объект InputStream или null, если ресурс с таким именем не найден

Исключения:

NullPointerException — Если name равно null

С:

JDK1.1

getResource

public URL getResource(String name)

Параметры:

name — имя искомого ресурса

Возвращает:

объект URL или null, если ресурс с таким именем не найден

С:

JDK1.1

getProtectionDomain

public ProtectionDomain getProtectionDomain()

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

Возвращает:

область защиты этого класса

Исключения:

SecurityException — если менеджер безопасности существует и его метод checkPermission не позволяет получить область защиты.

С:

1.2

См. также:

ProtectionDomain, SecurityManager.checkPermission(java.security.Permission), RuntimePermission

desiredAssertionStatus

public boolean desiredAssertionStatus()

Возвращает:

желаемое состояние утверждения указанного класса.

С:

1.4

См. также:

ClassLoader.setClassAssertionStatus(java.lang.String, boolean), ClassLoader.setPackageAssertionStatus(java.lang.String, boolean), ClassLoader.setDefaultAssertionStatus(boolean)

isEnum

public boolean isEnum()

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

Возвращает:

true, если и только если этот класс был объявлен как перечисление в исходном коде

С:

1.5

getEnumConstants

public T[] getEnumConstants()

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

Возвращает:

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

С:

1.5

cast

public T cast(Object obj)

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

Параметры:

obj — преобразуемый объект

Возвращает:

объект после преобразования или null, если obj равен null

Исключения:

ClassCastException — если объект не равен null и не может быть приведён к типу T.

С:

1.5

asSubclass

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

Параметры типа:

U — тип, в который необходимо преобразовать этот объект класса

Параметры:

clazz — класс типа, в который нужно преобразовать этот объект класса

Возвращает:

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

Исключения:

ClassCastException — если этот объект Class не представляет подкласс указанного класса (здесь «подкласс» включает сам класс).

С:

1.5

getAnnotation

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

Описание скопировано из интерфейса: AnnotatedElement

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

Определено в:

getAnnotation в интерфейсе AnnotatedElement

Параметры типа:

A - тип аннотации, для которой выполняется запрос и которая возвращается, если присутствует

Параметры:

annotationClass - объект Class, соответствующий типу аннотации

Возвращает:

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

Исключения:

NullPointerException - если заданный класс аннотации равен null

С тех пор как:

1.5

isAnnotationPresent

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

Определено в:

isAnnotationPresent в интерфейсе AnnotatedElement

Параметры:

annotationClass - объект Class, соответствующий типу аннотации

Возвращает:

true, если аннотация для указанного типа аннотации присутствует в этом элементе, иначе false

Исключения:

NullPointerException - если заданный класс аннотации равен null

С тех пор как:

1.5

getAnnotationsByType

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

Описание скопировано из интерфейса: AnnotatedElement

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

Определено в:

getAnnotationsByType в интерфейсе AnnotatedElement

Параметры типа:

A - тип аннотации, для которой выполняется запрос и которая возвращается, если присутствует

Параметры:

annotationClass - объект Class, соответствующий типу аннотации

Возвращает:

все аннотации этого элемента для указанного типа аннотации, если они связаны с этим элементом, иначе массив длиной ноль

Исключения:

NullPointerException - если заданный класс аннотации равен null

С тех пор как:

1.8

getAnnotations

public Annotation[] getAnnotations()

Описание скопировано из интерфейса: AnnotatedElement

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

Определено в:

getAnnotations в интерфейсе AnnotatedElement

Возвращает:

аннотации, присутствующие в этом элементе

С тех пор как:

1.5

getDeclaredAnnotation

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

Описание скопировано из интерфейса: AnnotatedElement

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

Определено в:

getDeclaredAnnotation в интерфейсе AnnotatedElement

Параметры типа:

A - тип аннотации, для которой выполняется запрос и которая возвращается, если она непосредственно присутствует

Параметры:

annotationClass - объект Class, соответствующий типу аннотации

Возвращает:

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

Исключения:

NullPointerException - если заданный класс аннотации равен null

С тех пор как:

1.8

getDeclaredAnnotationsByType

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

Описание скопировано из интерфейса: AnnotatedElement

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

Определено в:

getDeclaredAnnotationsByType в интерфейсе AnnotatedElement

Параметры типа:

A - тип аннотации, для которой выполняется запрос и которая возвращается, если она непосредственно или косвенно присутствует

Параметры:

annotationClass - объект Class, соответствующий типу аннотации

Возвращает:

все аннотации этого элемента для указанного типа аннотации, если они присутствуют непосредственно или косвенно в этом элементе, иначе массив длиной ноль

Исключения:

NullPointerException - если заданный класс аннотации равен null

С тех пор как:

1.8

getDeclaredAnnotations

public Annotation[] getDeclaredAnnotations()

Описание скопировано из интерфейса: AnnotatedElement

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

Определено в:

getDeclaredAnnotations в интерфейсе AnnotatedElement

Возвращает:

аннотации, непосредственно присутствующие в этом элементе

С тех пор как:

1.5

getAnnotatedSuperclass

public AnnotatedType getAnnotatedSuperclass()

Возвращает:

объект, представляющий суперкласс

С тех пор как:

1.8

getAnnotatedInterfaces

public AnnotatedType[] getAnnotatedInterfaces()

Возвращает:

массив, представляющий суперинтерфейсы

С тех пор как:

1.8