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

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

---

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

---

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()           Returns an array containing the constants of this enum type, in the order they are declared.

 

从类 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

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

---

RUNTIME

public static final RetentionPolicy RUNTIME

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

另请参见：

AnnotatedElement

方法详细信息

values

public static final RetentionPolicy[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

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

返回：

an array containing the constants of this enum type, in the order they are declared

---

valueOf

public static RetentionPolicy valueOf(String name)

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

参数：

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

返回：

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

抛出：

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

---

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

---

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

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