接口的使用
java.lang.annotation.Annotation

使用 Annotation 的包

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

Annotation 在 java.beans 中的用法

java.beans 中实现 Annotation 的类

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

Annotation 在 java.io 中的用法

java.io 中实现 Annotation 的类

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

Annotation 在 java.lang 中的用法

java.lang 中实现 Annotation 的类

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

java.lang 中的方法，类型参数为 Annotation

修饰符和类型	方法	描述
<A extends Annotation> A	Class.getAnnotation(Class<A> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T	Module.getAnnotation(Class<T> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<A extends Annotation> A	Package.getAnnotation(Class<A> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<A extends Annotation> A[]	Class.getAnnotationsByType(Class<A> annotationClass)	返回带有此元素的 associated 注释。
<A extends Annotation> A[]	Package.getAnnotationsByType(Class<A> annotationClass)	返回带有此元素的 associated 注释。
<A extends Annotation> A	Class.getDeclaredAnnotation(Class<A> annotationClass)	如果此类注解为 directly present ，则返回此元素针对指定类型的注解，否则为 null。
<A extends Annotation> A	Package.getDeclaredAnnotation(Class<A> annotationClass)	如果此类注解为 directly present ，则返回此元素针对指定类型的注解，否则为 null。
<A extends Annotation> A[]	Class.getDeclaredAnnotationsByType(Class<A> annotationClass)	如果此类注解是 directly present 或 indirectly present ，则返回此元素的指定类型的注解。
<A extends Annotation> A[]	Package.getDeclaredAnnotationsByType(Class<A> annotationClass)

java.lang 中返回 Annotation 的方法

修饰符和类型	方法	描述
Annotation[]	Class.getAnnotations()	返回此元素上的 present 注释。
Annotation[]	Module.getAnnotations()	返回此元素上的 present 注释。
Annotation[]	Package.getAnnotations()	返回此元素上的 present 注释。
<A extends Annotation> A[]	Class.getAnnotationsByType(Class<A> annotationClass)	返回带有此元素的 associated 注释。
<A extends Annotation> A[]	Package.getAnnotationsByType(Class<A> annotationClass)	返回带有此元素的 associated 注释。
Annotation[]	Class.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
Annotation[]	Module.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
Annotation[]	Package.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
<A extends Annotation> A[]	Class.getDeclaredAnnotationsByType(Class<A> annotationClass)	如果此类注解是 directly present 或 indirectly present ，则返回此元素的指定类型的注解。
<A extends Annotation> A[]	Package.getDeclaredAnnotationsByType(Class<A> annotationClass)

java.lang 中的方法参数，类型参数为 Annotation

修饰符和类型	方法	描述
boolean	Class.isAnnotationPresent(Class<? extends Annotation> annotationClass)	如果指定类型的注解在此元素上为 present，则返回 true，否则返回 false。
boolean	Package.isAnnotationPresent(Class<? extends Annotation> annotationClass)	如果指定类型的注解在此元素上为 present，则返回 true，否则返回 false。

Annotation 在 java.lang.annotation 中的用法

java.lang.annotation 中实现 Annotation 的类

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

返回类型中包含 Annotation 类型参数的 java.lang.annotation 中的方法

修饰符和类型	方法	描述
Class<? extends Annotation>	Annotation.annotationType()	返回该注解的注解。
Class<? extends Annotation>	IncompleteAnnotationException.annotationType()	返回带有缺失元素的注解的 Class 对象。

java.lang.annotation 中的构造函数参数，类型参数为 Annotation

修饰符	构造方法	描述
	IncompleteAnnotationException(Class<? extends Annotation> annotationType, String elementName)	构造一个 IncompleteAnnotationException 以指示指定的注解中缺少命名元素。

Annotation 在 java.lang.reflect 中的用法

java.lang.reflect 中的方法，类型参数为 Annotation

修饰符和类型	方法	描述
<T extends Annotation> T	AccessibleObject.getAnnotation(Class<T> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T	AnnotatedElement.getAnnotation(Class<T> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T	AnnotatedType.getAnnotation(Class<T> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T	Constructor.getAnnotation(Class<T> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T	Executable.getAnnotation(Class<T> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T	Field.getAnnotation(Class<T> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T	Method.getAnnotation(Class<T> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T	Parameter.getAnnotation(Class<T> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T	RecordComponent.getAnnotation(Class<T> annotationClass)	如果此类注解为 present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T[]	AccessibleObject.getAnnotationsByType(Class<T> annotationClass)	返回带有此元素的 associated 注释。
default <T extends Annotation> T[]	AnnotatedElement.getAnnotationsByType(Class<T> annotationClass)	返回带有此元素的 associated 注释。
<T extends Annotation> T[]	Executable.getAnnotationsByType(Class<T> annotationClass)	返回带有此元素的 associated 注释。
<T extends Annotation> T[]	Field.getAnnotationsByType(Class<T> annotationClass)	返回带有此元素的 associated 注释。
<T extends Annotation> T[]	Parameter.getAnnotationsByType(Class<T> annotationClass)	返回带有此元素的 associated 注释。
<T extends Annotation> T	AccessibleObject.getDeclaredAnnotation(Class<T> annotationClass)	如果此类注解为 directly present ，则返回此元素针对指定类型的注解，否则为 null。
default <T extends Annotation> T	AnnotatedElement.getDeclaredAnnotation(Class<T> annotationClass)	如果此类注解为 directly present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T	Parameter.getDeclaredAnnotation(Class<T> annotationClass)	如果此类注解为 directly present ，则返回此元素针对指定类型的注解，否则为 null。
<T extends Annotation> T[]	AccessibleObject.getDeclaredAnnotationsByType(Class<T> annotationClass)	如果此类注解是 directly present 或 indirectly present ，则返回此元素的指定类型的注解。
default <T extends Annotation> T[]	AnnotatedElement.getDeclaredAnnotationsByType(Class<T> annotationClass)	如果此类注解是 directly present 或 indirectly present ，则返回此元素的指定类型的注解。
<T extends Annotation> T[]	Parameter.getDeclaredAnnotationsByType(Class<T> annotationClass)	如果此类注解是 directly present 或 indirectly present ，则返回此元素的指定类型的注解。

java.lang.reflect 中返回 Annotation 的方法

修饰符和类型	方法	描述
Annotation[]	AccessibleObject.getAnnotations()	返回此元素上的 present 注释。
Annotation[]	AnnotatedElement.getAnnotations()	返回此元素上的 present 注释。
Annotation[]	AnnotatedType.getAnnotations()	返回此元素上的 present 注释。
Annotation[]	Parameter.getAnnotations()	返回此元素上的 present 注释。
Annotation[]	RecordComponent.getAnnotations()	返回此元素上的 present 注释。
<T extends Annotation> T[]	AccessibleObject.getAnnotationsByType(Class<T> annotationClass)	返回带有此元素的 associated 注释。
default <T extends Annotation> T[]	AnnotatedElement.getAnnotationsByType(Class<T> annotationClass)	返回带有此元素的 associated 注释。
<T extends Annotation> T[]	Executable.getAnnotationsByType(Class<T> annotationClass)	返回带有此元素的 associated 注释。
<T extends Annotation> T[]	Field.getAnnotationsByType(Class<T> annotationClass)	返回带有此元素的 associated 注释。
<T extends Annotation> T[]	Parameter.getAnnotationsByType(Class<T> annotationClass)	返回带有此元素的 associated 注释。
Annotation[]	AccessibleObject.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
Annotation[]	AnnotatedElement.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
Annotation[]	AnnotatedType.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
Annotation[]	Constructor.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
Annotation[]	Executable.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
Annotation[]	Method.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
Annotation[]	Parameter.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
Annotation[]	RecordComponent.getDeclaredAnnotations()	返回此元素上的 directly present 注释。
<T extends Annotation> T[]	AccessibleObject.getDeclaredAnnotationsByType(Class<T> annotationClass)	如果此类注解是 directly present 或 indirectly present ，则返回此元素的指定类型的注解。
default <T extends Annotation> T[]	AnnotatedElement.getDeclaredAnnotationsByType(Class<T> annotationClass)	如果此类注解是 directly present 或 indirectly present ，则返回此元素的指定类型的注解。
<T extends Annotation> T[]	Parameter.getDeclaredAnnotationsByType(Class<T> annotationClass)	如果此类注解是 directly present 或 indirectly present ，则返回此元素的指定类型的注解。
Annotation[][]	Constructor.getParameterAnnotations()	返回 Annotation 数组的数组，这些数组表示形式参数上的注释，按声明顺序，由该对象表示的 Executable 。
abstract Annotation[][]	Executable.getParameterAnnotations()	返回 Annotation 数组的数组，这些数组表示形式参数上的注释，按声明顺序，由该对象表示的 Executable 。
Annotation[][]	Method.getParameterAnnotations()	返回 Annotation 数组的数组，这些数组表示形式参数上的注释，按声明顺序，由该对象表示的 Executable 。

java.lang.reflect 中的方法参数，类型参数为 Annotation

修饰符和类型	方法	描述
boolean	AccessibleObject.isAnnotationPresent(Class<? extends Annotation> annotationClass)	如果指定类型的注解在此元素上为 present，则返回 true，否则返回 false。
default boolean	AnnotatedElement.isAnnotationPresent(Class<? extends Annotation> annotationClass)	如果指定类型的注解在此元素上为 present，则返回 true，否则返回 false。

Annotation 在 javax.annotation.processing 中的用法

javax.annotation.processing 中实现 Annotation 的类

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

javax.annotation.processing 中的方法参数，类型参数为 Annotation

修饰符和类型	方法	描述
Set<? extends Element>	RoundEnvironment.getElementsAnnotatedWith(Class<? extends Annotation> a)	返回使用给定注释接口注释的元素。
default Set<? extends Element>	RoundEnvironment.getElementsAnnotatedWithAny(Set<Class<? extends Annotation>> annotations)	返回使用一个或多个给定注释接口注释的元素。

Annotation 在 javax.lang.model 中的用法

javax.lang.model 中的方法，类型参数为 Annotation

修饰符和类型	方法	描述
<A extends Annotation> A	AnnotatedConstruct.getAnnotation(Class<A> annotationType)	如果这样的注释是 present ，则返回此构造的指定类型的注解，否则返回 null 。
<A extends Annotation> A[]	AnnotatedConstruct.getAnnotationsByType(Class<A> annotationType)	返回带有此构造的 associated 注释。

javax.lang.model 中返回 Annotation 的方法

修饰符和类型	方法	描述
<A extends Annotation> A[]	AnnotatedConstruct.getAnnotationsByType(Class<A> annotationType)	返回带有此构造的 associated 注释。

Annotation 在 javax.lang.model.element 中的用法

javax.lang.model.element 中的方法，类型参数为 Annotation

修饰符和类型	方法	描述
<A extends Annotation> A	Element.getAnnotation(Class<A> annotationType)	如果这样的注释是 present ，则返回此构造的指定类型的注解，否则返回 null 。
<A extends Annotation> A[]	Element.getAnnotationsByType(Class<A> annotationType)	返回带有此构造的 associated 注释。

javax.lang.model.element 中返回 Annotation 的方法

修饰符和类型	方法	描述
<A extends Annotation> A[]	Element.getAnnotationsByType(Class<A> annotationType)	返回带有此构造的 associated 注释。

Annotation 在 javax.lang.model.type 中的用法

javax.lang.model.type 中的方法，类型参数为 Annotation

修饰符和类型	方法	描述
<A extends Annotation> A	TypeMirror.getAnnotation(Class<A> annotationType)	如果这样的注释是 present ，则返回此构造的指定类型的注解，否则返回 null 。
<A extends Annotation> A[]	TypeMirror.getAnnotationsByType(Class<A> annotationType)	返回带有此构造的 associated 注释。

javax.lang.model.type 中返回 Annotation 的方法

修饰符和类型	方法	描述
<A extends Annotation> A[]	TypeMirror.getAnnotationsByType(Class<A> annotationType)	返回带有此构造的 associated 注释。

Annotation 在 javax.management 中的用法

javax.management 中实现 Annotation 的类

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

Annotation 在 javax.swing 中的用法

javax.swing 中实现 Annotation 的类

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

Annotation 在 jdk.jfr 中的用法

jdk.jfr 中实现 Annotation 的类

修饰符和类型	类	描述
@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	事件字段注解，指定该值是无符号数据类型。

jdk.jfr 中的方法，类型参数为 Annotation

修饰符和类型	方法	描述
<A extends Annotation> A	EventType.getAnnotation(Class<A> annotationClass)	如果直接存在具有相同名称的注解元素，则返回指定类型的第一个注释，否则返回 null 。
<A extends Annotation> A	SettingDescriptor.getAnnotation(Class<A> annotationType)	如果具有相同名称的注解元素可用，则返回指定类型的第一个注释，否则返回 null。
<A extends Annotation> A	ValueDescriptor.getAnnotation(Class<A> annotationType)	如果此值描述符直接存在具有相同名称的注解元素，则返回指定类型的第一个注释，否则返回 null。

jdk.jfr 中的方法参数，类型参数为 Annotation

修饰符和类型	方法	描述
final <A> A	AnnotationElement.getAnnotation(Class<? extends Annotation> annotationType)	如果存在具有相同名称的 AnnotationElement，则返回指定类型的第一个注释，否则返回 null。

jdk.jfr 中的构造函数参数，类型参数为 Annotation

修饰符	构造方法	描述
	AnnotationElement(Class<? extends Annotation> annotationType)	创建一个注解元素以用于动态定义的事件。
	AnnotationElement(Class<? extends Annotation> annotationType, Object value)	创建一个注解元素以用于动态定义的事件。
	AnnotationElement(Class<? extends Annotation> annotationType, Map<String,Object> values)	创建一个注解元素以用于动态定义的事件。