Java自定义注解和反射的简单使用

注解的作用或者意义是什么？

注解本身没有任何意义，单独的注解就是一种注释，他需要结合其他如反射、插桩等技术才有意义。

Java 注解（Annotation）又称 Java 标注，是 JDK1.5 引入的一种注释机制。是元数据的一种形式，提供有关于程序但不属于程序本身的数据。注解对它们注解的代码的操作没有直接影响。 

元注解

在定义注解时，注解类也能够使用其他的注解声明。对注解类型进行注解的注解类，我们称之为 meta-annotation（元注解）。声明的注解允许作用于哪些节点使用@Target声明；保留级别由@Retention 声明。其中保留级别如下。

·RetentionPolicy.SOURCE：标记的注解仅保留在源级别中，并被编译器忽略。

·RetentionPolicy.CLASS：标记的注解在编译时由编译器保留，但 Java 虚拟机(JVM)会忽略。

·RetentionPolicy.RUNTIME：标记的注解由 JVM 保留，因此运行时环境可以使用它。

SOURCE < CLASS < RUNTIME，即CLASS包含了SOURCE，RUNTIME包含SOURCE、CLASS。

根据注解的保留级别不同，对注解的使用自然存在不同场景。

       

在Android中我们需要设计接口以供使用者调用时，如出现需要对入参进行类型限定，如限定为资源ID、布局ID等类型参数，将参数类型直接给定int即可。然而，我们可以利用Android为我们提供的语法检查注解，来辅助进行更为直接的参数类型检查与提示。

       

同时，我们也可以通过利用@Intdef来定义自己的入参类型检查。

反射

一般情况下，我们使用某个类时必定知道它是什么类，是用来做什么的，并且能够获得此类的引用。于是我们直接对这个类进行实例化，之后使用这个类对象进行操作。

反射则是一开始并不知道我要初始化的类对象是什么，自然也无法使用 new 关键字来创建对象了。这时候，我们使用 JDK 提供的反射 API 进行反射调用。反射就是在运行状态中,对于任意一个类,都能够知道这个类的所有属性和方法;对于任意一个对象,都能够调用它的任意方法和属性;并且能改变它的属性。是Java被视为动态语言的关键。

首先我们自定义一个注解类，来实现Intent跳转传参

//跳转传参注解
//需要反射赋值，使用RUNTIME
@Retention(RetentionPolicy.RUNTIME)
//限定注解范围，field属性、枚举的常量
@Target(ElementType.FIELD)
public @interface Autowired {
    String value() default "mx";
}

第二步，在SecondActivity中，给参数变量加上注解的标记

public class SecondActivity extends AppCompatActivity {
    @Autowired(value = "age")
    private int age;
    @Autowired(value = "name")
    private String name;
    @Autowired(value = "sex")
    private boolean sex;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    }
}

第三步，实现注解工具类，利用反射获取class的属性变量和赋值，具体方法看代码注释

public class AutowiredUtils {

    public static void autowired(Activity activity) {
        //反射获取当前class
        Class<? extends Activity> aClass = activity.getClass();
        //获取intent传递的数据
        Intent intent = activity.getIntent();
        Bundle bundle = intent.getExtras();
        if (bundle == null) {
            return;
        }

        //获得此类所有的成员属性
        Field[] declaredFields = aClass.getDeclaredFields();
        //遍历找出有Autowired注解的成员属性
        for (Field field : declaredFields) {
            if (field.isAnnotationPresent(Autowired.class)) {
                //获取注解类实例
                Autowired annotation = field.getAnnotation(Autowired.class);
                //通过注解类实例，获取传入的key
                String key = TextUtils.isEmpty(annotation.value()) ? field.getName() : annotation.value();

                //只有Parcelable数组类型不能直接设置，其他的都可以
                if (bundle.containsKey(key)) {
                    Object obj = bundle.get(key);
                    //获取数组单个元素的类型
                    Class<?> componentType = field.getType().getComponentType();
                    //判断如果当前成员属性是数组，并且类型是Parcelable的子类，则强转为数组
                    if (field.getType().isArray() && Parcelable.class.isAssignableFrom(componentType)) {
                        Object[] objs = (Object[]) obj;

                        //创建对应类型的数组并由objs拷贝
                        Object[] objects = Arrays.copyOf(objs, objs.length, (Class<? extends Object[]>) field.getType());
                        obj = objects;

                    }
                    //开启获取private成员权限
                    field.setAccessible(true);
                    try {
                        //反射赋值
                        field.set(activity, obj);
                    } catch (IllegalAccessException e) {
                        e.printStackTrace();

                    }
                }
            }
        }
    }
}

最后，在onCreat方法中初始化上述工具类，实现在class的RUNTIME时，自动获取getIntent传值和赋值的操作

public class SecondActivity extends AppCompatActivity {
    //自定义findviewbyid注解类，比较简单，可仿照Autowired注解类的实现
    @InjectView(R.id.tv_age)
    TextView tv_age;
    @InjectView(R.id.tv_name)
    TextView tv_name;
    @InjectView(R.id.tv_sex)
    TextView tv_sex;


    @Autowired(value = "age")
    private int age;
    @Autowired(value = "name")
    private String name;
    @Autowired(value = "sex")
    private boolean sex;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_second);
        InjectUtils.injectView(this);
        AutowiredUtils.autowired(this);

        tv_age.setText(age + "");
        tv_name.setText(name);
        tv_sex.setText(sex ? "男" : "女");
    }
}

当传值较多时，这样操作大大减少了我们代码的行数，使得程序的阅读性提高很多