Интерфейс ClassDesc

static ClassDesc of(String name)

Параметры:

name — полное двоичное имя класса (с разделителями-точками)

Возвращает:

ClassDesc, описывающий нужный класс

Вызывает исключение:

NullPointerException — если аргумент равен null

IllegalArgumentException — если строка имени имеет неверный формат

См. также:

• ofDescriptor(String)
• ofInternalName(String)

static ClassDesc ofInternalName(String name)

Примечание к API:

Чтобы создать дескриптор для типа массива, используйте ofDescriptor(String) или arrayType(); чтобы создать дескриптор для примитивного типа, используйте ofDescriptor(String) или предварительно определённые константы в ConstantDescs.

Параметры:

name — полное имя класса во внутреннем формате (с разделителями-косыми чертами)

Возвращает:

ClassDesc, описывающий нужный класс

Вызывает исключение:

NullPointerException — если аргумент равен null

IllegalArgumentException — если строка имени имеет неверный формат

См. Спецификацию виртуальной машины Java:

4.2.1 Двоичные имена классов и интерфейсов

Начиная с версии:

20

См. также:

• of(String)
• ofDescriptor(String)

static ClassDesc of(String packageName, String className)

Параметры:

packageName — имя пакета (с разделителями-точками); если имя пакета — пустая строка, класс считается принадлежащим безымянному пакету

className — неквалифицированное (простое) имя класса

Возвращает:

ClassDesc, описывающий нужный класс

Вызывает исключение:

NullPointerException — если любой аргумент равен null

IllegalArgumentException — если имя пакета или имя класса имеет неверный формат

static ClassDesc ofDescriptor(String descriptor)

Примечание к API:

Строка дескриптора типа поля для типа, не являющегося массивом, — это либо однобуквенный код, соответствующий примитивному типу ("J", "I", "C", "S", "B", "D", "F", "Z", "V"), либо буква "L", за которой следует полное двоичное имя класса, а затем ";". Дескриптор типа поля для типа массива — это символ "[", за которым следует дескриптор поля для типа компонента. Примеры допустимых строк дескрипторов типов: "Ljava/lang/String;", "I", "[I", "V", "[Ljava/lang/String;" и т. д. Дополнительные сведения см. в JVMS 4.3.2 («Дескрипторы полей»).

Параметры:

descriptor — строка дескриптора поля

Возвращает:

ClassDesc, описывающий нужный класс

Вызывает исключение:

NullPointerException — если аргумент равен null

IllegalArgumentException — если строка дескриптора имеет неверный формат

См. Спецификацию виртуальной машины Java:

4.3.2 Дескрипторы полей
4.4.1 Структура CONSTANT_Class_info

См. также:

• of(String)
• ofInternalName(String)

ClassDesc arrayType()

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

arrayType в интерфейсе TypeDescriptor.OfField<ClassDesc>

Возвращает:

ClassDesc, описывающий тип массива

Вызывает исключение:

IllegalStateException — если размерность результирующего ClassDesc превышает 255

См. Спецификацию виртуальной машины Java:

4.4.1 Структура CONSTANT_Class_info

ClassDesc arrayType(int rank)

Параметры:

rank — размерность массива

Возвращает:

ClassDesc, описывающий тип массива

Вызывает исключение:

IllegalArgumentException — если размерность меньше или равна нулю либо размерность результирующего типа массива превышает 255

См. Спецификацию виртуальной машины Java:

4.4.1 Структура CONSTANT_Class_info

default ClassDesc nested(String nestedName)

Примечание к API:

Пример: если дескриптор d описывает класс java.util.Map, дескриптор для класса java.util.Map.Entry можно получить с помощью d.nested("Entry").

Параметры:

nestedName — неквалифицированное имя вложенного класса

Возвращает:

ClassDesc, описывающий вложенный класс

Вызывает исключение:

NullPointerException — если аргумент равен null

IllegalStateException — если этот ClassDesc не описывает тип класса или интерфейса

IllegalArgumentException — если имя вложенного класса недопустимо

default ClassDesc nested(String firstNestedName, String... moreNestedNames)

Параметры:

firstNestedName — неквалифицированное имя первого уровня вложенного класса

moreNestedNames — неквалифицированные имена остальных уровней вложенного класса

Возвращает:

ClassDesc, описывающий вложенный класс

Вызывает исключение:

NullPointerException — если любой аргумент или его содержимое равно null

IllegalStateException — если этот ClassDesc не описывает тип класса или интерфейса

IllegalArgumentException — если имя вложенного класса недопустимо

default boolean isArray()

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

isArray в интерфейсе TypeDescriptor.OfField<ClassDesc>

Возвращает:

описывает ли этот ClassDesc тип массива

default boolean isPrimitive()

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

isPrimitive в интерфейсе TypeDescriptor.OfField<ClassDesc>

Возвращает:

описывает ли этот ClassDesc примитивный тип

default boolean isClassOrInterface()

Возвращает:

описывает ли этот ClassDesc тип класса или интерфейса

default ClassDesc componentType()

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

componentType в интерфейсе TypeDescriptor.OfField<ClassDesc>

Возвращает:

ClassDesc, описывающий тип компонента, или null, если этот дескриптор не описывает тип массива

default String packageName()

Возвращает:

имя пакета или пустую строку, если класс находится в пакете по умолчанию, либо этот ClassDesc не описывает тип класса или интерфейса

String displayName()

Возвращает:

удобочитаемое имя этого ClassDesc

String descriptorString()

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

descriptorString в интерфейсе TypeDescriptor

Возвращает:

строку дескриптора

См. Спецификацию виртуальной машины Java:

4.3.2 Дескрипторы полей

Class<?> resolveConstantDesc(MethodHandles.Lookup lookup) throws ReflectiveOperationException

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

resolveConstantDesc в интерфейсе ConstantDesc

Параметры:

lookup — MethodHandles.Lookup, предоставляющий контекст разрешения имён и контроля доступа

Возвращает:

разрешённое значение константы

Вызывает исключение:

ReflectiveOperationException — если класс, метод или поле не удалось разрешить с помощью рефлексии в ходе разрешения

Начиная с версии:

21

boolean equals(Object o)

Переопределяет:

equals в классе Object

Параметры:

o — другой объект

Возвращает:

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

См. также:

• Object.hashCode()
• HashMap