系列阅读
1. 概述
注解相当于一种标记,在程序中加了注解就等于为程序打上了某种标记,没加,则等于没有某种标记,以后,javac编译器,开发工具和其他程序可以用反射来了解你的类及各种元素上有无何种标记,看你有什么标记,就去干相应的事。标记可以加在包,类,字段,方法,方法的参数以及局部变量上
开发中常见注解:
- @Override:作用在方法上的注解。当方法不是重写父类的方法时会报错
- @Deprecated:作用在方法上。标记该方法为作废方法(已过时)
- @SuppressWarnings:作用在方法上,压制警告
应用
- 标记一些信息
- 运行时动态处理
- 编译时动态处理
2. 注解类型
8种基本数据类型,String,Class,enum,annotation,以上类型的数组类型
3. 定义注解
|
|
@interface
使用@interface声明一个注解类
@Target
表示注解的作用目标,是一个枚举值
作用目标 | 说明 |
---|---|
ElementType.FIELD | 作用于成员变量 |
ElementType.METHOD | 作用于方法 |
ElementType.CONSTRUCTOR | 作用于构造方法 |
ElementType.PARAMETER | 作用于方法的参数 |
ElementType.TYPE | 作用于类,接口,enum, Annotation |
@Retention
表示注解的保存策略,也是一个枚举值
注解的保留策略是指,注解是只保留在源代码上,还是保留到class文件上,再或者是类在运行时,可以被类加载器加载到内存中。
如果希望注解被反射,那么注解就要保留到运行时,而不是源代码或类文件上。
指定注解的保留策略需要使用元注解@Retention,它有一个value属性,类型为RetentionPolicy类型,RetentionPolicy是枚举类型
保存策略 | 说明 |
---|---|
RetentionPolicy.SOURCE | 注解只保存在源代码中,即.java文件 |
RetentionPolicy.CLASS | 注解保存在字节码中,即.class文件 |
RetentionPolicy.RUNTIME | 注解保存在内存中的字节码,可用于反射 |
注解的属性
|
|
定义注解的属性,有点像java类中的方法,上面的代码定义了一个类型为String类型,注解名为name的属性,default是给注解设置默认值
value属性
|
|
如果注解中有一个名称为value的属性,且你只想设置value属性(即其他属性都采用默认值或者你只有一个value属性),那么可以省略value=部分,例如:@MyAnnotation(“AllenIverson”)
数组类型的属性
|
|
如果数组属性中只有一个元素,这时候属性值部分可以省略大括
4. Annotation
4.1 注解的应用结构图
Annotation
方法声明 | 功能描述 |
---|---|
annotationType() | 获取注解类型 |
4.2 反射注解
类上的注解:使用Class获取
- Class.getAnnotation():获取指定类型的注解
- Class.getAnnotations():获取所有的注解
- Class.getDeclaredAnnotations():获取除了继承得到的所有注解
方法上的注解:使用Method获取
- Method.getAnnotation() :获取方法上指定类型的注解
- Method.getAnnotations():获取所有的注解
- Method.getDeclaredAnnotations():获取除了继承得到的所有注解
构造方法上的注解:使用Constructor获取
- Constructor.getAnnotation()获取指定类型的注解
- Constructor.getAnnotations()获取所有的注解
- Constructor.getDeclaredAnnotations() 获取除了继承得到的所有注解
属性上的注解:使用Field获取
- Field.getAnnotation():获取字段上指定类型的注解
- Field.getAnnotations():获取所有的注解
- Field.getDeclaredAnnotations():获取字段所有的注解
定义注解
使用注解
|
|
通过反射读取注解
|
|
4.3 实现注解小框架
|
|
5. Annotation Processing Tool
编译时注解在项目编译的时候生成新的Java文件,这样可以减少手动的代码输入,而且可以不用使用反射,对程序不会造成性能影响。
AbstractProcessor
注解处理器,javac 自带的一个工具,用来在编译时期扫描处理注解信息
- process()
- init()
- Filer
- Elements
- Messager
Android公共技术点之二-Annotation Processing Tool
6. javapoet
动态生成Java代码,ButterKnife使用了该框架,实现了编译时注解
7. 注解框架
Dagger1
Dagger2
Guice
Butterknife
androidannotations