什么是注解Annontation?
Annontation是Java5开始引入的新特征,中文名称叫注解。它提供了一种安全的类似注释的机制,用来将任何的信息或元数据(metadata)与程序元素(类、方法、成员变量等)进行关联。为程序的元素(类、方法、成员变量)加上更直观更明了的说明,这些说明信息是与程序的业务逻辑无关,并且供指定的工具或框架使用。Annontation像一种修饰符一样,应用于包、类型、构造方法、方法、成员变量、参数及本地变量的声明语句中。
Java注解是附加在代码中的一些元信息,用于一些工具在编译、运行时进行解析和使用,起到说明、配置的功能。注解不会也不能影响代码的实际逻辑,仅仅起到辅助性的作用。包含在 java.lang.annotation 包中。注解(annotation),是一种代码级别的说明,和类 接口平级关系。注解(Annotation)相当于一种标记,在程序中加入注解就等于为程序打上某种标记,标记以后,Javac编译器、开发工具和其他程序可以通过反射来了解你的类及各种元素上有无标记,看你的程序有什么标记,就去干相应的事。
注解的原理:
注解本质是一个继承了Annotation 的特殊接口,其具体实现类是Java 运行时生成的动态代理类。而我们通过反射获取注解时,返回的是Java 运行时生成的动态代理对象$Proxy1。通过代理对象调用自定义注解(接口)的方法,会最终调用AnnotationInvocationHandler 的invoke 方法。该方法会从memberValues 这个Map 中索引出对应的值。而memberValues 的来源是Java 常量池。
注解的用处:
1、生成文档。这是最常见的,也是java 最早提供的注解。常用@author和@version 等
2、跟踪代码依赖性,实现替代配置文件功能。比如Dagger 2 依赖注入,未来java 开发,将大量注解配置,具有很大用处;
3、在编译时进行格式检查。如@override 放在方法前,如果你这个方法并不是覆盖了超类方法,则编译时就能检查出。
自定义注解
1.格式:注解的本质上就是一个接口,注解中的方法叫注解属性
public @interface 注解名{
//注解属性
}
2.注解属性定义格式:
注解属性类型 属性名();
注解属性类型 属性名() default 默认值;
注解属性类型
1 | 基本类型 |
int i() 或 int i() default 默认值; |
2 | String |
String s() |
3 | Class类型 |
Class c() |
4 | 注解类型 |
Override o() |
5 | 枚举(Enum)类型 |
Color c();Sex s(); |
6 | 以上类型的一维数组类型 |
String[] str() |
自定义注解:
自定义注解类编写的一些规则:
1. Annotation 型定义为@interface, 所有的Annotation 会自动继承java.lang.Annotation这一接口,并且不能再去继承别的类或是接口.
2. 参数成员只能用public 或默认(default) 这两个访问权修饰
3. 参数成员只能用基本类型byte、short、char、int、long、float、double、boolean八种基本数据类型和String、Enum、Class、annotations等数据类型,以及这一些类型的数组.
4. 要获取类方法和字段的注解信息,必须通过Java的反射技术来获取 Annotation 对象,因为你除此之外没有别的获取注解对象的方法
5. 注解也可以没有定义成员,,不过这样注解就没啥用了
PS:自定义注解需要使用到元注解
1.常见标准的注解Annotation
1 |
@author |
用来标识对象的作者名 |
|
2 |
@version |
用于标识对象的版本号 |
|
3 |
@Override |
描述方法的重写 |
是一个标记类型注解,java 编译器将以一个编译错误来警示 |
4 |
@Deprecated |
标记过时 |
是一种标记类型注解,过时不推荐使用了 |
5 |
@SuppressWarnings |
压制警告 |
|
6 |
@FunctionalInterface |
函数式接口 |
|
7 |
@Test |
测试注解 |
2.元注解:定义在注解上的注解(修饰注解的注解)
Java.lang.annotation 提供了四种元注解,专门注解其他的注解(在自定义注解的时候,需要使用到元注解)。
@Target |
注解用于什么地方 |
默认值为任何元素,表示该注解用于什么地方。值为:ElementType的枚举值 |
@Retention |
什么时候使用该注解 |
定义该注解保留到那个代码阶段。值为:RetentionPolicy类型 |