Перечисление RetentionPolicy

java.lang.Object

java.lang.Enum<RetentionPolicy>

java.lang.annotation.RetentionPolicy

Все реализуемые интерфейсы:: Serializable, Comparable<RetentionPolicy>, Constable

public enum RetentionPolicy extends Enum<RetentionPolicy>

Политика хранения аннотаций. Константы этого класса-перечисления описывают различные политики хранения аннотаций. Они используются вместе с метааннотацией Retention, чтобы указать, как долго должны храниться аннотации.

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

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в классе Enum

Enum.EnumDesc<E>

Краткое описание констант перечисления

Константа перечисления	Описание
`CLASS`	Компилятор записывает аннотации в файл класса, но виртуальная машина не обязана хранить их во время выполнения.
`RUNTIME`	Компилятор записывает аннотации в файл класса, а виртуальная машина хранит их во время выполнения, поэтому их можно считывать с помощью рефлексии.
`SOURCE`	Компилятор отбрасывает аннотации.

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

Модификатор и тип	Метод	Описание
`static RetentionPolicy`	`valueOf(String name)`	Возвращает константу перечисления этого класса с указанным именем.
`static RetentionPolicy[]`	`values()`	Возвращает массив, содержащий константы этого класса-перечисления в порядке их объявления.

Методы, объявленные в классе Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Методы, объявленные в классе Object

getClass, notify, notifyAll, wait, wait, wait

Подробное описание констант перечисления

SOURCE

public static final RetentionPolicy SOURCE

Компилятор отбрасывает аннотации.

CLASS

public static final RetentionPolicy CLASS

Компилятор записывает аннотации в файл класса, но виртуальная машина не обязана хранить их во время выполнения. Это поведение используется по умолчанию.

RUNTIME

public static final RetentionPolicy RUNTIME

Компилятор записывает аннотации в файл класса, а виртуальная машина хранит их во время выполнения, поэтому их можно считывать с помощью рефлексии.

См. также:

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

values

public static RetentionPolicy[] values()

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

Возвращает:: массив, содержащий константы этого класса-перечисления в порядке их объявления

valueOf

public static RetentionPolicy valueOf(String name)

Возвращает константу перечисления этого класса с указанным именем. Строка должна в точности совпадать с идентификатором, использованным для объявления константы перечисления в этом классе. (Лишние пробельные символы не допускаются.)

Параметры:: name — имя возвращаемой константы перечисления.
Возвращает:: константа перечисления с указанным именем
Исключения:: IllegalArgumentException — если в этом классе-перечислении нет константы с указанным именем; NullPointerException — если аргумент равен null

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/annotation/RetentionPolicy.html