Перечисление RetentionPolicy
- Все реализованные интерфейсы:
-
Serializable,Comparable<RetentionPolicy>,Constable
public enum RetentionPolicy extends Enum<RetentionPolicy>
Политика хранения аннотаций. Константы этого перечисления описывают различные политики хранения аннотаций. Они используются совместно с мета-аннотационным интерфейсом
Retention для указания, как долго аннотации должны храниться.- С тех пор:
- 1.5
Краткое описание вложенных классов
Вложенные классы/интерфейсы, объявленные в классе java.lang.Enum
Enum.EnumDesc<E extends Enum<E>>
Краткое описание констант перечисления
| Константа перечисления | Описание |
|---|---|
CLASS |
Аннотации записываются в файл класса компилятором, но не сохраняются ВМ во время выполнения. |
RUNTIME |
Аннотации записываются в файл класса компилятором и сохраняются ВМ во время выполнения, поэтому их можно читать рефлексивно. |
SOURCE |
Аннотации отбрасываются компилятором. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
static RetentionPolicy |
valueOf |
Возвращает константу перечисления этого класса с заданным именем. |
static RetentionPolicy[] |
values() |
Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления. |
Подробное описание констант перечисления
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, 2021, 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/17/docs/api/java.base/java/lang/annotation/RetentionPolicy.html