Перечисление 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, 2023, 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/21/docs/api/java.base/java/lang/annotation/RetentionPolicy.html