RetentionPolicy - Java 11中文版 - API参考文档

API Reference Document

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

实现的所有接口

Serializable ， Comparable<RetentionPolicy>
```
public enum RetentionPolicy
extends 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