注解的使用
java.lang.annotation.Retention

使用 Retention 的包

包	描述
java.beans	包含与开发 beans 相关的类——基于 JavaBeans 体系结构的组件。
java.io	通过数据流、序列化和文件系统提供系统输入和输出。
java.lang	提供对 Java 编程语言的设计至关重要的类。
java.lang.annotation	为 Java 编程语言注解工具提供库支持。
javax.annotation.processing	用于声明注解处理器和允许注解处理器与注释处理工具环境进行通信的工具。
javax.management	为 Java 管理扩展提供核心类。
javax.swing	提供一组“轻量级”（全 Java 语言）组件，尽可能在所有平台上以相同的方式工作。
jdk.jfr	这个包提供类来创建事件和控制飞行记录器。

Retention 在 java.beans 中的用法

具有类型为 Retention 的注解的 java.beans 中的类

修饰符和类型	类	描述
@interface	BeanProperty	用于为自动生成的BeanInfo 类指定一些属性相关信息的注解。
@interface	ConstructorProperties	构造方法上的注释，显示该构造方法的参数如何对应于构造对象的 getter 方法。
@interface	JavaBean	用于为自动生成的BeanInfo 类指定一些类相关信息的注解。
@interface	Transient	指示当 Introspector 构造与带注解的代码元素关联的 PropertyDescriptor 或 EventSetDescriptor 类时，应使用给定的 value 声明名为“瞬态”的属性。

Retention 在 java.io 中的用法

具有类型为 Retention 的注解的 java.io 中的类

修饰符和类型	类	描述
@interface	Serial	指示带注解的字段或方法是 Java 对象序列化规范 定义的 序列化机制 的一部分。

Retention 在 java.lang 中的用法

具有类型为 Retention 的注解的 java.lang 中的类

修饰符和类型	类	描述
@interface	Deprecated	注释为 @Deprecated 的程序元素是不鼓励程序员使用的。
@interface	FunctionalInterface	一种信息性注解类型，用于指示接口类型声明旨在成为功能接口由 Java 语言规范定义。
@interface	Override	指示方法声明旨在重写超类型中的方法声明。
@interface	SafeVarargs	程序员断言带注解的方法或构造方法的主体不会对其可变参数参数执行潜在的不安全操作。
@interface	SuppressWarnings	指示要在编译时在带注解的元素中以及在带注解的元素中包含的所有元素中抑制的警告。

Retention 在 java.lang.annotation 中的用法

具有类型为 Retention 的注解的 java.lang.annotation 中的类

修饰符和类型	类	描述
@interface	Documented	如果注释 @Documented 存在于注释接口的声明中A，那么元素上的任何 @A 注释都被视为元素公共契约的一部分。
@interface	Inherited	表示自动继承注解。
@interface	Native	指示可以从本机代码引用定义常量值的字段。
@interface	Repeatable	注释接口 java.lang.annotation.Repeatable 用于指示它（元）注释其声明的注释接口是 repeatable 。
@interface	Retention	指示带有注解的注解要保留多长时间。
@interface	Target	指示注解适用的上下文。

Retention 在 javax.annotation.processing 中的用法

具有类型为 Retention 的注解的 javax.annotation.processing 中的类

修饰符和类型	类	描述
@interface	Generated	Generated 注解用于标记已经生成的源代码。
@interface	SupportedAnnotationTypes	用于指示注解处理器支持哪些注解的注解。
@interface	SupportedOptions	用于指示注解处理器支持哪些选项的注解。
@interface	SupportedSourceVersion	用于指示注解处理器支持的最新源版本的注解。

Retention 在 javax.management 中的用法

具有类型为 Retention 的注解的 javax.management 中的类

修饰符和类型	类	描述
@interface	ConstructorParameters	构造方法上的注释，显示该构造方法的参数如何对应于构造对象的 getter 方法。
@interface	DescriptorKey	描述注解元素如何与 Descriptor 中的字段相关的元注释。
@interface	MXBean	用于将接口显式标记为 MXBean 接口或不是 MXBean 接口的注解。

Retention 在 javax.swing 中的用法

具有类型为 Retention 的注解的 javax.swing 中的类

修饰符和类型	类	描述
@interface	SwingContainer	用于为自动生成的 BeanInfo 类指定一些挥杆相关信息的注释。

Retention 在 jdk.jfr 中的用法

具有类型为 Retention 的注解的 jdk.jfr 中的类

修饰符和类型	类	描述
@interface	BooleanFlag	事件字段注解，指定该值为布尔标志，true 或 false 值。
@interface	Category	事件注解，以人类可读路径的格式将事件类型与类别相关联。
@interface	ContentType	元注解，指定一个注解表示一种内容类型，例如时间跨度或频率。
@interface	DataAmount	事件字段注解，指定一个值表示一个数据量（例如，字节）。
@interface	Description	使用一两句话描述元素的注解。
@interface	Enabled	事件注解，确定是否应默认启用事件。
@interface	Experimental	指定元素是实验性的并且可能会更改，恕不另行通知的注解。
@interface	Frequency	事件字段注解，指定该值为频率，以 Hz 为单位测量。
@interface	Label	为元素设置人类可读名称的注释（例如，"Maximum Throughput"）。
@interface	MemoryAddress	事件字段注解，指定值为内存地址。
@interface	MetadataDefinition	用于定义新型事件元数据的元注解。
@interface	Name	为元素设置默认名称的注解。
@interface	Percentage	用于分数的事件字段注解，通常在 0.0 和 1.0 之间，以指定该值为百分比。
@interface	Period	事件注解，指定周期性事件的默认设置值。
@interface	Registered	事件注解，用于程序化事件注册。
@interface	Relational	关系注释的元注释，用于注解。
@interface	SettingDefinition	指定应使用事件类中的方法来过滤事件的注解。
@interface	StackTrace	事件注解，确定事件默认情况下是否具有堆栈跟踪。
@interface	Threshold	事件注解，指定不记录事件的默认持续时间（例如，"20 ms"）。
@interface	Timespan	事件字段注解，指定该值为持续时间。
@interface	Timestamp	事件字段注解，指定值为时间点。
@interface	TransitionFrom	事件字段注解，指定事件从线程转换。
@interface	TransitionTo	事件字段注解，指定事件将很快过渡到一个线程。
@interface	Unsigned	事件字段注解，指定该值是无符号数据类型。