当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

RetentionPolicy (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 枚举常量 | 字段 | 方法	详细信息： 枚举常量 | 字段 | 方法

---

java.lang.annotation
枚举 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           编译器将把注释记录在类文件中，但在运行时 VM 不需要保留注释。
RUNTIME           编译器将把注释记录在类文件中，在运行时 VM 将保留注释，因此可以反射性地读取。
SOURCE           编译器要丢弃的注释。

 

方法摘要
static RetentionPolicy	valueOf(String name)           返回带有指定名称的该类型的枚举常量。
static RetentionPolicy[]	values()           按照声明该枚举类型的常量的顺序，返回 包含这些常量的数组。

 

从类 java.lang.Enum 继承的方法
clone, compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

 

从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, wait, wait, wait

 

枚举常量详细信息

SOURCE

public static final RetentionPolicy SOURCE

编译器要丢弃的注释。

---

CLASS

public static final RetentionPolicy CLASS

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

---

RUNTIME

public static final RetentionPolicy RUNTIME

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

另请参见：

AnnotatedElement

方法详细信息

values

public static final RetentionPolicy[] values()

按照声明该枚举类型的常量的顺序，返回 包含这些常量的数组。该方法可用于迭代 常量，如下所示：

for(RetentionPolicy c :RetentionPolicy.values())
        System.out.println(c);

返回：

按照声明该枚举类型的常量的顺序，返回 包含这些常量的数组。

---

valueOf

public static RetentionPolicy valueOf(String name)

返回带有指定名称的该类型的枚举常量。 字符串必须与用于声明该类型的枚举常量的 标识符完全匹配。（不允许有多余 的空格。）

参数：

指定要返回的枚举常量的名称。 -

返回：

返回带有指定名称的枚举常量

抛出：

如果该枚举类型没有带有指定名称的常量， - 则抛出 IllegalArgumentException

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 枚举常量 | 字段 | 方法	详细信息： 枚举常量 | 字段 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。