android annotation注解的浅层次理解

在java中有annotation这个东西，因为平时用的也并不是太多，所以一直不是很理解，今天特意花了几个小时看了下相关的知识点，熟悉了一下annotation的简单用法。

annotation简答直接用法如下：

一个自定义的annotation主要包括三部分：annotation的定义，annotation的使用，annotation的处理；事实上整个注解机制重点在于最后反射对注解值的使用。

第一步：定义如下：

package com.example.annotationtest.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

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

其中包括三个重要的原生注解@Target 、@Retention、@interface

@Target表明的是注解的类型，即类注解、方法注解、字段注解等

@Retention表明的是注解的使用范围，即在源码中的注解、在Runtime的注解等

@interface是一个自定义注解需要的标志，每个自定义的注解都会有相同的格式

第二步：使用的时候注意@Target中所定义的值（以上定义的是类的注解，所以可以按如下方法使用)

package com.example.annotationtest;

import com.example.annotationtest.annotation.ContentView;
import com.example.annotationtest.annotation.ViewUtils;

import android.app.Activity;
import android.os.Bundle;

@ContentView(R.layout.activity_main)
public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ViewUtils.inject(this);
    }
}

其中主要注意两处，第一处是MainActivity之上的@ContentView(R.layout.activity_main)这里代表使用ContentView的注解，第二处是ViewUtils.inject(this),这里是第三步的功能，主要是执行该注解的过程。

第三步：最重要的一步，就是通过反射来执行该注解

package com.example.annotationtest.annotation;

import android.app.Activity;

import java.lang.reflect.Method;

public class ViewUtils {
    public static void inject(Activity activity) {
        injectObject(activity);
    }

    private static void injectObject(Object handler) {
        Class<?> handlerType = handler.getClass();
        ContentView contentView = handlerType.getAnnotation(ContentView.class);
        if (contentView != null) {
            try {
                Method setContentViewMethod = handlerType.getMethod("setContentView", int.class);
                setContentViewMethod.invoke(handler, contentView.value());
            } catch (Throwable e) {
                e.printStackTrace();
            }
        }
    }
}

与普通的反射唯一的不同之处就是，多了从Annotation中拿到其value的一步。

ContentView contentView = handlerType.getAnnotation(ContentView.class);//这是拿到Annotation

<pre name="code" class="java">contentView.value() //这是拿到在第一步中赋的值

总共就上面三步，就是一个简单的注解实现通常安卓开发中需要用到的setContentView(R.layout.activity_main);的功能

代码亲测可用