尊重原创
这篇文章主要讲解注解实现findViewById的功能,首先我们来熟悉一下在java中怎么定义一个注解和解析一个注解
注解的概念是在jdk5.0中提出来的,在java.lang的包中已经定义了三个注解:Override,Deprecated,SuppressWarnings
Override相信大家非常熟悉,就是表明这个方法是改写了父类的方法
Deprecated表示在新版本的 jdk中已经不建议使用这个方法或者属性
SuppressWarning就是屏蔽掉一些警告
知道了注解的概念后,我们就来自定义注解
注解的定义和接口的接口非常像,在interface的前面多了一个@
public @interface TestPerson
{
}
千万不能把前面的@符号弄掉了,弄掉了就成了接口的定义了,上面是一个最简单注解的定义,当然注解和类一样,也可以定义属性,如下:
public @interface TestPerson
{
//name既是这个注解的属性,也是注解的方法,调用name()返回值就是name
String name() default "gavin";
}
我现在想定义两个注解,一个注解用来说明某个类的意义,另一个注解用来说明类中的某个方法由谁测试的,便于追究责任,定义如下:
//用来标注某个类是用来干嘛的
public @interface ClassFunction
{
String value() default "";
}
//用来标注类中的方法是被谁测试的
public @interface TestPerson
{
//name是属性而不是方法,gavin是它的默认值,在定义的时候可以不用给定默认值
String name() default "gavin";
}
那么怎么限定一个注解是用在类上还是用在方法上?比如Override就是用在方法上的注解,Deprecated是既可以用在方法上面,也可以用在类上面,我们直接看看Override是怎么实现的吧
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}
我们发现这两个注解在定义的过程中都使用了其他的注解,像Target和Retention这种注解叫做元注解,我们分别看看它们的意思吧
Target注解的功能就是表明你这个注解是用在什么地方的,它的值是一个枚举型
1.CONSTRUCTOR:用于描述构造器
2.FIELD:用于描述域
3.LOCAL_VARIABLE:用于描述局部变量
4.METHOD:用于描述方法
5.PACKAGE:用于描述包
6.PARAMETER:用于描述参数
7.TYPE:用于描述类、接口(包括注解类型) 或enum声明
Retention注解的功能差不多说明的就是你的注解的生命周期吧,就是什么时候失效,它的值如下
1.SOURCE:在源文件中有效(即源文件保留)
2.CLASS:在class文件中有效(即class保留)
3.RUNTIME:在运行时有效(即运行时保留)
我就介绍这两个元注解吧,其他的感觉也用的不是很多,如果你感兴趣可以自己Google一下
那么我们就完善我们自己的注解吧
@Target(ElementType.METHOD)//作用于方法
@Retention(RetentionPolicy.RUNTIME)//在运行时有效(即运行时保留)
public @interface TestPerson
{
//name是属性而不是方法,gavin是它的默认值,在定义的时候可以不用给定默认值
String name() default "gavin";
}
@Target(ElementType.TYPE)//作用于类上
@Retention(RetentionPolicy.RUNTIME)//在运行时有效(即运行时保留)
public @interface ClassFunction
{
String value() default "";
}
那么我们就来使用一下我们的注解吧
@ClassFunction("用于描述一个人的基本信息")
public class Person
{
private static final String TAG = "Person";
@TestPerson(name="jj")
public void setName()
{
}
}
这里要说明一点就是:如果某个注解属性使用value作为名称如ClassFunction中的value,那么赋值的时候可以直接@ClassFunction("用于描述一个人的基本信息"),但是如果你使用的是其他名称,那么必须@TestPerson(name="jj")这样调用
以上就是定义一个注解的过程,下面我们来解析一个注解
定义一个TestPerson注解
/**
* com.annotation.TestPerson
* @author yuanzeyao <br/>
* create at 2014年5月21日 下午1:30:14
*/
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestPerson {
String name();
}
然后再Person类中加入注解
public class Person {
private static final String TAG = "Person";
@TestPerson(name="gavin")
public void getName()
{
}
}
解析注解
public class Main {
private static final String TAG = "Main";
public static void main(String[] args)
{
Person person=new Person();
//获得Person对应的Class
Class<Person> clazz=Person.class;
try {
//找到getName方法
Method method=clazz.getMethod("getName",null);
//判断是否被TestPerson标注
if(method.isAnnotationPresent(TestPerson.class))
{
//调用getName方法
method.invoke(person, null);
//得到TestPerson注解的实例
TestPerson test=method.getAnnotation(TestPerson.class);
//获得其name属性
String name=test.name();
System.out.println("this method is test by-->"+name);
}
} catch (SecurityException e) {
} catch (NoSuchMethodException e) {
} catch (IllegalArgumentException e) {
} catch (IllegalAccessException e) {
} catch (InvocationTargetException e) {
}
}
}
已经将定义注解和解析注解讲解完了,下面来具体分析一下怎么在Android中使用注解来代替findViewById
定义一个注解
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface InjectView
{
//id就是控件id,在某一个控件上使用注解标注其id
int id() default -1;
}
在Activity中加入注解
public class MainActivity extends Activity
{
public static final String TAG="MainActivity";
//标注TextView的id
@InjectView(id=R.id.tv_img)
private TextView mText;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
try {
autoInjectAllField(this);
} catch (IllegalAccessException e) {
} catch (IllegalArgumentException e) {
}
if(mText!=null)
mText.setText("Hello Gavin");
}
public void autoInjectAllField(Activity activity) throws IllegalAccessException, IllegalArgumentException
{
//得到Activity对应的Class
Class clazz=this.getClass();
//得到该Activity的所有字段
Field []fields=clazz.getDeclaredFields();
Log.v(TAG, "fields size-->"+fields.length);
for(Field field :fields)
{
//判断字段是否标注InjectView
if(field.isAnnotationPresent(InjectView.class))
{
Log.v(TAG, "is injectView");
//如果标注了,就获得它的id
InjectView inject=field.getAnnotation(InjectView.class);
int id=inject.id();
Log.v(TAG, "id--->"+id);
if(id>0)
{
//反射访问私有成员,必须加上这句
field.setAccessible(true);
//然后对这个属性复制
field.set(activity, activity.findViewById(id));
}
}
}
}
}