注解分三种,内建注解、元注解、自定义注解
1、内建注解:
@Override
用来标注方法,表示该方法是重写的方法。
@Deprecated
用来表示该元素已过时。
@SuppressWarnings
用来抑制被注解元素及其子元素的编译器警告信息。
该注解有参数,各个参数表示如下:
- deprecation:使用了过时的程序元素。
- unchecked:执行了未检查的转换。
- unused:有程序元素未被使用。
- fallthrough:switch程序块直接通往下一种情况而没有break。
- path:在类路径、源文件路径等中有不存在的路径。
- serial:在可序列化的类上缺少serialVersionUID定义。
- finally:任何finally子句不能正常完成。
- all:所有情况。
2、元注解:
元注解都是用来修饰自定义注解的。
@Target
用于修饰该注解可用于修饰哪类程序元素。
@Target有ElementType类型的唯一value成员变量,该注解的可注解类型被指定:
- ElementType.ANNOTATION_TYPE:注解声明
- ElementType.CONSTRUCTOR:构造方法声明
- ElementType.FIELD:成员变量声明
- ElementType.LOCAL_VARIABLE:局部变量声明
- ElementType.METHOD:方法声明
- ElementType.PACKAGE:包声明
- ElementType.PARAMETER:参数声明
- ElementType.TYPE:类、接口(包括注解)或枚举声明
@Rentention
用于修饰该注解是否被编译器丢弃或保留在class文件中。
@Rentention有RetentionPolicy类型的唯一value成员变量,默认值为RetentionPolicy.CLASS,有如下3个取值:
- RetentionPolicy.CLASS:表示编译器会把被修饰的注解记录在class文件中,但当Java程序运行时,Java虚拟机不再保留注解。
- RetentionPolicy.RUNTIME:表示编译器会把被修饰的注解记录在class文件中,但当Java程序运行时,Java虚拟机会保留注解。
- RetentionPolicy.SOURCE:表示编译器直接丢弃被修饰的注解。
@Documented
用于修饰该注解将被JavaDoc工具提取成文档。
@Inherited
用于修饰该注解将具有继承性,如果该注解修饰每个类,则该注解也将用于该类的子类。
3、自定义注解:
自定义注解是一种接口,但又不同于接口,需要在接口的关键字interface前加@,那么此接口就是一个自定义注解,此注解可用元注解修饰,来完善注解功能。