15-注解分类

10.2.6　注解分类

注解按照使用方式和用途来分，主要包含3大类：内建注解、元注解和自定义注解。

1．内建注解

内建注解又称为基本注解，位于java.lang包下，系统提供的内建注解主要有以下3个。

• @Override：用于重写父类方法。
• @Deprecated：用于标识方法已经过时。
• @SurppressWarnings：用于取消编译器报警。

2．元注解

元注解又称为注解上的注解，是在注解上添加的注解，主要用于修饰其他的注解。元注解位于java.lang.annotation子包中，系统提供的元注解主要有4个。

• @Target：使用该注解标注元素可能的类型（如类、函数和表达式等）。
• @Retention：指定该注解是否需要在编译后被存储到相应的Class文件中，以及在它运行时是否可以通过反射获取元数据（默认为true）。
• @Repeatable：允许在单个元素上多次使用该注解。
• @MustBeDocumented：该注解是公有API的一部分，用来指定被修饰的注解将被JavaDoc工具提取成文档。

3．自定义注解

自定义注解类似于新创建的接口文件，但为了区分传统的接口，声明自定义注解时需要使用关键字@interface来定义。