概念
代码中一种特殊的标记,这些标记可以在编译、类加载、运行时被读取,并执行相应的处理。通过注解开发人员可以在不改变原有逻辑的情况下,在源文件中嵌入一些补充的信息。
- 注解本质上上一个接口,该接口默认继承java.lang.annotation.Annotation,程序可以通过反射来获取指定元素的Annotation对象,通过这个对象获取注解里的元数据。
- 注解不影响代码的执行,如果希望让程序中的注解在运行时起一定的作用,只有通过某种配套的工具对注解中的信息进行访问和处理,统称为APT(Annotation Processing Tool)
- 注解不支持继承
元注解
概念:用于修饰、描述注解的注解,有6个
- @Target:描述注解能够作用的位置
只有一个参数value, 取值可以是ElementTYPE.ANNOTATION_TYPE/CONSTRUCTOR/FIELD/LOCAL_VARIBALE/METHOD/PACKAGE/PARAMETER/TYPE/TYPE_PARAMETER/TYPE_USER等 - @Retention:描述注解能被保留的阶段
一共有三个值RetentionPolicy.SOURCE/CLASS/RUNTIME,默认是CLASS
1、SOURCE:注解只保留在源文件中,注解将会被编译器丢弃,不会保存在class文件和jvm中。
2、CLASS: 注解信息会保存在源码和class文件中,不会加载到jvm中。
3、RUNTIME:源码、class和jvm中都会保留注解,如SpringMVC中的@controller、@Autowired、 - @Documented:描述注解是否被抽取到api文档中
- @Inherited:描述注解能否被子类继承
java中的内置注解:
@Override:重写父类方法
@Deprecated:表示某个类、方法等已过时
@SuppressWarning:压制告警,一般传一个参数"all"压制所有的警告
@FunctionalInterface:函数式接口
自定义注解:
元注解
public @interface 注解名称() {
属性列表
}
属性:接口中的抽象方法的名字就是属性的名字,返回值就是属性的类型。
- 属性的返回类型限制:基本数据类型、String、枚举enum、注解Annotation、Class、以上类型的数组。
- 定义了属性后,在使用时需要给属性赋值,如 age=12。
- 若使用default关键字给属性默认初始化,则使用注解时,可以不进行属性的赋值,使用默认值。
- 如果只有一个属性需要赋值,并且属性的名称是value是,则赋值时value可以省略,直接定义值即可。
- 数组赋值使用 {} 进行赋值,除非只有一个元素时可以省略大括号。
eg:自定义注解
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Test {
String value() defalut "cc"'
int age defalue 1;
boolean isOk;
String[] path() default {};
}
- 自定义注解时不得继承其他注解或接口
- 注解的每个参数对应着注解中的方法名。
- 注解类体中,每一个方法实际上声明了一个注解参数。方法名就是参数名,返回值类型就是参数类型。
- 访问修饰权限:public或者默认default
- 注解元素必须要有默认值。在定义注解的默认值中指定,或者在使用注解的时候指定。非基本类型不能默认null。
解析注解:
在程序中获取注解中定义的属性值,关键在于实现自定义注解器。也可以称为APT工具。