模块 java.base

软件包 java.lang.annotation

Enum RetentionPolicy

java.lang.Object

java.lang.Enum<RetentionPolicy>

java.lang.annotation.RetentionPolicy

实现的所有接口

Serializable ， Comparable<RetentionPolicy>

public enum RetentionPolicyextends Enum<RetentionPolicy>

注释保留策略。 此枚举类型的常量描述了用于保留注释的各种策略。 它们与Retention元注释类型结合使用，以指定要保留注释的时间。

从以下版本开始：

1.5

Enum Constant Summary

Enum Constants

Enum Constant	描述
CLASS	注释将由编译器记录在类文件中，但在运行时不需要由VM保留。
RUNTIME	注释将由编译器记录在类文件中，并在运行时由VM保留，因此可以反射性地读取它们。
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

Enum Constant Detail

SOURCE

public static final RetentionPolicy SOURCE

编译器将丢弃注释。

CLASS

public static final RetentionPolicy CLASS

注释将由编译器记录在类文件中，但在运行时不需要由VM保留。 这是默认行为。

RUNTIME

public static final RetentionPolicy RUNTIME

注释将由编译器记录在类文件中，并在运行时由VM保留，因此可以反射性地读取它们。

另请参见：

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 - if the argument is null