Android 注解解析及使用

注解是一系列元数据，它提供数据用来解释程序代码，但是注解并非是所解释代码的一部分。注解对于代码的运行效果没有直接影响。

通俗易懂点讲，注解就是一种标签，对类、方法、属性等赋予的一种代码级解释，对代码的运行效果没有丝毫影响。

那么问题来了，既然对代码没有丝毫影响，为什么要用它呢？我们带着问题来进行下面的阅读。

下面我们会讲到一些注解的实际使用场景，大家先了解注解的一些概念及方法。

下面我们来讲一下android中常见的注解，带大家先有个基本认识。

@override：当子类重写父类的方法时，用于标识继承自父类的方法。

@deprecate：用于标记一些过时的方法，相信大家都不陌生，比如我们调用一些过时的api，中间会有一条删除线。

@SupressWarnings: 忽略警告。all表示忽略全部警告。

元注解是用于注解注解的注解。

听起来可能有点拗口，元注解就是在我们定义的注解上添加的注解即为元注解，元注解一共有四个，大家别慌，我们一个一个来看。

1.@Retention

该注解用于标识我们的定义的注解的过期时间。一共有三个值：

RetentionPolicy.SOURCE：源码阶段，就是说我们在代码编写阶段有效。

RetentionPolicy.CLASS：编译阶段，代码编译前有效。

RetentionPolicy.RUNTIME：运行时阶段，代码会一直有效，生命周期很长。

2.@Target

该注解用于标识我们定义的注解的使用场景，比如方法名上，类上等。下面是它可以使用场景的值：                  ElementType.ANNOTATION_TYPE 可以给一个注解进行注解
ElementType.CONSTRUCTOR 可以给构造方法进行注解
ElementType.FIELD 可以给属性进行注解
ElementType.LOCAL_VARIABLE 可以给局部变量进行注解
ElementType.METHOD 可以给方法进行注解
ElementType.PACKAGE 可以给一个包进行注解
ElementType.PARAMETER 可以给一个方法内的参数进行注解
ElementType.TYPE 可以给一个类型进行注解，比如类、接口、枚举

3.@Documented

文档相关，将注解中的元素包含到 Javadoc 中去。

4.@inherit

如果一个超类被 @Inherited 注解过的注解进行注解的话，那么如果它的子类没有被任何注解应用的话，那么这个子类就继承了超类的注解。

我们想自定义一个注解的话，跟接口类似，用关键字@interface。

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface MyAnnotation {
    int getAge() default 0; //方法可以设置默认值
}

上面我们一定一个注解为MyAnnotation，定义这个注解我们使用场景为给属性添加并且一直有效。

那么我们接下来使用这个注解，我们定义个user类。

public class User {
    @MyAnnotation(getNum = 20)
    private int age;
    public int getAge() {
        return age;
    }
    public void setAge(int age) {
        this.age = age;
    }
}

我们给字段属性age设置了注解，并且值为20；那么我们接下来实现代码获取到这个20.

public static void main(String[] args) throws NoSuchFieldException {
        //获取user类对象
        Class userClass = User.class;
        //获取user类的age属性值
        Field ageField = userClass.getDeclaredField("age");
        //判断该属性值是否包含MyAnnotation注解
        boolean isExit = ageField.isAnnotationPresent(MyAnnotation.class);
        if (isExit){
            //如果包含，获取到注解
            MyAnnotation annotation = ageField.getAnnotation(MyAnnotation.class);
            //获取到注解值
            int num = annotation.getNum();
            System.out.println("num:" + num);
        }
    }

这里需要将几个重要方法：

isAnnotationPresent(Annotation.class)：该方法判断是否包含此注解，可以用在类，属性，方法等。

getAnnotation(Annotation.class)：该方法获取此注解对象。

那么我们通过上面的例子，基本上是可以使用注解了。下面我们来讲几个android中常用的例子。

我们android中注解，比如Butterknife，Evenbus，GreenDao等。

我们来自己实现一下Butterknife。

首先定义我们的注解，一共俩个，@BindView、@BindLayout.

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
@Documented
public @interface BindView {
    int value();
}

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface BindLayout {
    @LayoutRes
    int value();
}

我们定义了俩个注解，通过名字大家也可以看出，一个为绑定view，一个绑定布局xml。

下面我们来实现activity添加注解。

@BindLayout(R.layout.activity_main)
public class MainActivity extends BaseActivity {
    @BindView(value = R.id.tv)
    TextView textView;
    @Override
    void create(){
        textView.setTextColor(Color.parseColor("#ff0000"));
    }
}

也很简单，我们给textview控件添加id注解，并且oncreate初始化时进行文本变色，给activity添加了布局文件xml申明的注解。

public abstract class BaseActivity extends AppCompatActivity {
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        bindLayout();
        bind();
        create();
    }
    abstract void create();
    protected void bind(){
        Class aClass = this.getClass();
        Field[] declaredFields = aClass.getDeclaredFields();
        for (Field field : declaredFields){
            boolean isExit = field.isAnnotationPresent(BindView.class);
            if (isExit){
                BindView annotation = field.getAnnotation(BindView.class);
                int resId = annotation.value();
                try {
                    Method method = aClass.getMethod("findViewById", int.class);
                    method.setAccessible(true);
                    Object invoke = method.invoke(this, resId);
                    field.setAccessible(true);
                    field.set(this,invoke);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
        }
    }
    protected void bindLayout(){
        Class aClass = this.getClass();
        BindLayout bindLayout = (BindLayout) aClass.getAnnotation(BindLayout.class);
        if (bindLayout != null){
            int layoutId = bindLayout.value();
            try {
                Method method = aClass.getMethod("setContentView", int.class);
                method.setAccessible(true);
                method.invoke(this, layoutId);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

我们的BaseActivity中做了绑定view跟layout的初始化操作，通过反射来获取到setContentView方法跟findViewById方法进行设置我们的注解值的。代码很全很清晰，如果大家有不清楚的，可以参考我的下一篇，反射篇。

如果帮到大家，请大家帮忙点个赞，大家的关注和支持是我坚持下去的动力。