Перечисление RetentionPolicy
- 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
© 1993, 2020, 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.