Spec-Zone.ru › OpenJDK 27

Интерфейс AnnotationElement

public sealed interface AnnotationElement
Представляет пару «имя элемента — значение» в таблице element_value_pairs структуры annotation, определённой в JVMS §4.7.16, или в структуре type_annotation, определённой в JVMS §4.7.20.

Объекты AnnotationElement следует сравнивать с помощью метода equals.

См. Спецификацию виртуальной машины Java:
4.7.16.1 Структура element_value
Начиная с версии:
24
См. также:
  • Annotation
  • Аннотации в базовом API отражения

Краткое описание методов

Модификатор и тип Метод Описание
Utf8Entry name()
Возвращает имя элемента.
static AnnotationElement of(Utf8Entry name, AnnotationValue value)
Возвращает пару «имя элемента — значение».
static AnnotationElement of(String name, AnnotationValue value)
Возвращает пару «имя элемента — значение».
static AnnotationElement ofAnnotation(String name, Annotation value)
Возвращает пару «имя элемента — значение» для элемента со значением-аннотацией.
static AnnotationElement ofArray(String name, AnnotationValue... values)
Возвращает пару «имя элемента — значение» для элемента со значением-массивом.
static AnnotationElement ofBoolean(String name, boolean value)
Возвращает пару «имя элемента — значение» для элемента со значением типа boolean.
static AnnotationElement ofByte(String name, byte value)
Возвращает пару «имя элемента — значение» для элемента со значением типа byte.
static AnnotationElement ofChar(String name, char value)
Возвращает пару «имя элемента — значение» для элемента со значением типа char.
static AnnotationElement ofClass(String name, ClassDesc value)
Возвращает пару «имя элемента — значение» для элемента со значением типа class.
static AnnotationElement ofDouble(String name, double value)
Возвращает пару «имя элемента — значение» для элемента со значением типа double.
static AnnotationElement ofFloat(String name, float value)
Возвращает пару «имя элемента — значение» для элемента со значением типа float.
static AnnotationElement ofInt(String name, int value)
Возвращает пару «имя элемента — значение» для элемента со значением типа int.
static AnnotationElement ofLong(String name, long value)
Возвращает пару «имя элемента — значение» для элемента со значением типа long.
static AnnotationElement ofShort(String name, short value)
Возвращает пару «имя элемента — значение» для элемента со значением типа short.
static AnnotationElement ofString(String name, String value)
Возвращает пару «имя элемента — значение» для элемента со строковым значением.
AnnotationValue value()
Возвращает значение элемента.

Подробное описание методов

name

Utf8Entry name()
Возвращает имя элемента.
Примечание API:
В исходном коде Java по соглашению имя единственного элемента в интерфейсе аннотации с одним элементом — value. (JLS §9.6.1) Это относится к аннотациям с одним элементом (JLS §9.7.3) и контейнерным аннотациям для нескольких аннотаций (JLS §9.6.3).
Возвращает:
имя элемента

value

AnnotationValue value()
Возвращает значение элемента.
Возвращает:
значение элемента

of

static AnnotationElement of(Utf8Entry name, AnnotationValue value)
Возвращает пару «имя элемента — значение».
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение»

of

static AnnotationElement of(String name, AnnotationValue value)
Возвращает пару «имя элемента — значение».
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение»

ofClass

static AnnotationElement ofClass(String name, ClassDesc value)
Возвращает пару «имя элемента — значение» для элемента со значением типа class.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со значением типа class
См. также:
  • AnnotationValue::ofClass

ofString

static AnnotationElement ofString(String name, String value)
Возвращает пару «имя элемента — значение» для элемента со строковым значением.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со строковым значением
См. также:
  • AnnotationValue::ofString

ofLong

static AnnotationElement ofLong(String name, long value)
Возвращает пару «имя элемента — значение» для элемента со значением типа long.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со значением типа long
См. также:
  • AnnotationValue::ofLong

ofInt

static AnnotationElement ofInt(String name, int value)
Возвращает пару «имя элемента — значение» для элемента со значением типа int.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со значением типа int
См. также:
  • AnnotationValue::ofInt

ofChar

static AnnotationElement ofChar(String name, char value)
Возвращает пару «имя элемента — значение» для элемента со значением типа char.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со значением типа char
См. также:
  • AnnotationValue::ofChar

ofShort

static AnnotationElement ofShort(String name, short value)
Возвращает пару «имя элемента — значение» для элемента со значением типа short.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со значением типа short
См. также:
  • AnnotationValue::ofShort

ofByte

static AnnotationElement ofByte(String name, byte value)
Возвращает пару «имя элемента — значение» для элемента со значением типа byte.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со значением типа byte
См. также:
  • AnnotationValue::ofByte

ofBoolean

static AnnotationElement ofBoolean(String name, boolean value)
Возвращает пару «имя элемента — значение» для элемента со значением типа boolean.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со значением типа boolean
См. также:
  • AnnotationValue::ofBoolean

ofDouble

static AnnotationElement ofDouble(String name, double value)
Возвращает пару «имя элемента — значение» для элемента со значением типа double.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со значением типа double
См. также:
  • AnnotationValue::ofDouble

ofFloat

static AnnotationElement ofFloat(String name, float value)
Возвращает пару «имя элемента — значение» для элемента со значением типа float.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со значением типа float
См. также:
  • AnnotationValue::ofFloat

ofAnnotation

static AnnotationElement ofAnnotation(String name, Annotation value)
Возвращает пару «имя элемента — значение» для элемента со значением-аннотацией.
Параметры:
name — имя ключа
value — связанное значение
Возвращает:
пару «имя элемента — значение» для элемента со значением-аннотацией
См. также:
  • AnnotationValue::ofAnnotation

ofArray

static AnnotationElement ofArray(String name, AnnotationValue... values)
Возвращает пару «имя элемента — значение» для элемента со значением-массивом.
Параметры:
name — имя ключа
values — связанные значения
Возвращает:
пару «имя элемента — значение» для элемента со значением-массивом
Выбрасывает:
IllegalArgumentException — если количество связанных значений превышает предел u2
См. также:
  • AnnotationValue::ofArray

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её дочерних компаний в США и других странах.
Авторские права © 1993, 2026, Oracle и/или её дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API