写这篇文章之前,我们要实现的目标是通过运行时注解实现一个findViewById及setOnClickListener的操作,其他的就自己扩展了。不过我们在开始写这个Demo之前,我们先来了解下Java为我们提供的元注解和相关定义注解的语法。
元注解:
元注解的作用就是负责注解其他注解。Java5.0定义了4个标准的meta-annotation类型,它们被用来提供对其它 annotation类型作说明。Java5.0 定义的元注解:
1.@Target,
2.@Retention,
3.@Documented,
4.@Inherited
这些类型和它们所支持的类在java.lang.annotation包中可以找到。下面我们看一下每个元注解的作用和相应分参数的使用说明。
@Target
说明了Annotation所修饰的对象范围
取值(ElementType)有:
1.TYPE:可用于类、接口、注解类型、枚举
2.FIELD:可用于成员变量、枚举常量
3.METHOD:用于方法,静态方法、非静态方法,不能用于构造方法
4.PARAMETER:用于参数(方法形参)
5.CONSTRUCTOR:用于构造器
6.LOCAL_VARIABLE:用于方法局部变量
7.ANNOTATION_TYPE:用于注解类型
8.PACKAGE:用于包类型
9.TYPE_PARAMETER:用来标注类型参数
10.TYPE_USE:能标注任何类型名称
@Retention
定义了该Annotation被保留的时间长短
1.SOURCE:在源文件中有效(即源文件保留)
2.CLASS:在class文件中有效(即class保留)
3.RUNTIME:在运行时有效(即运行时保留)
@Documented
用于描述其它类型的annotation应该被作为被标注的程序成员的公共API,因此可以被例如javadoc此类的工具文档化。Documented是一个标记注解,没有成员
@Inherited
描述了某个被标注的类型是被继承的(作用于类,方法不继承)
了解了这些之后,我们现在来完成我们开篇说的自定义注解
自定义注解
首先我们先了解下我实现的项目的结构,anolibrary是一个library工程,就是我们定义注解及帮助类的地方。
首先我们看下BindView和OnClick的类里面我们怎么定义的
其实没做什么操作,就是基于上面的元注解定义了两个注解而已,可以从类名看出来,BindView是做findViewById的操作的,而OnClick是用来做setOnClickListener的~~~
好啦,来看我们的帮助类干了什么
从上面的帮助类我们可以看到基本的操作,从bind方法理获取绑定的activity,然后调用initialization方法,在这个方法里面就是我们的反射的相关代码啦,注释很详细,了解反射的同学应该都能看懂了哇~
ok,我们怎么使用呢~
返回我们的项目工程,在MainActivity这样就行了,在onCreate中直接ButterKnife.bind(this)就行,可以看出,我这里写了一个TextView,一个ImageView两个BindView注解,分别绑定了一个TextView和一个ImageView,一个OnClick的注解,在这个里面给TextView设置了新的文字,给ImageView设置了一张图片。运行工程,点击事件之前的页面~
点击这个点击测试的按钮后
可以看出,这个点击事件调用成功了,文字改变了,图片也加载出来了~~~
ok,收工(过两天写编译时注解的相关Demo)~