Политика сохранения аннотаций

java.lang.Object
- java.lang.Enum<RetentionPolicy>
- - java.lang.annotation.RetentionPolicy

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

public enum RetentionPolicy
extends Enum<RetentionPolicy>

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

С:: 1.5

Постоянные значения перечисления

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

Методы

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

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

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

Методы, объявленные в классе java.lang.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

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

См. также:: AnnotatedElement

Методы

values

public static RetentionPolicy[] values()

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

for (RetentionPolicy c : RetentionPolicy.values())
    System.out.println(c);

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

valueOf

public static RetentionPolicy valueOf(String name)

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

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