Android Annotation使用小技巧

  • 背景
  • 定义
  • 组成部分
  • 环境配置
  • 注解类型
  • 注解使用注意事项


背景

在Java中,注解(Annotation)引入始于Java5,用来描述Java代码的元信息,通常情况下注解不会直接影响代码的执行,尽管有些注解可以用来做到影响代码执行。包含在Java.lang.annotation中。

定义

注解是那些插入到源码中用于某种工具处理的标签。在java语言中,注解被当作一个修饰符使用的,每个注解的名称前面都加上了@符号。注解自身并不会做任何事情,它需要通过注解事件处理器处理后,才会有用。

组成部分

——注解接口定义;
——注解事件处理器;
——注解应用场景类;
1.注解接口定义
定义注解的格式:

public @interface 注解名 {定义体}

注:当我们使用@interface关键字定义一个注解时,该注解隐含地继承了Java.lang.annotation.Annotation接口:
例:
第一步打开Android studio定义接口

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface ActionListener {
    public String source() default "nothing";
}

插图:

android transitionManager的使用 android annotation_android


@Target:注解的作用目标

@Target说明了Annotation所修饰的对象范围:Annotation可被用于packages、types(类、接口、枚举、Annotation类型)、类型成员(方法、构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、catch参数)。

@Retention:注解的保留位置

@Retention定义了该Annotation被保留的时间长短:某些Annotation仅出现在源代码中,而被编译器丢弃;而另一些却被编译在class文件中;编译在class文件中的Annotation可能会被虚拟机忽略,而另一些在class被装载时将被读取(请注意并不影响class的执行,因为Annotation与class在使用上是被分离的)。

2.注解事件处理器
编写注解事件处理器,通过反射获得场景类对象的annotation的source对象。并且为source对象调用setOnClickListener方法进行事件绑定。
第二步:对对象进行事件绑定,添加监听事件

import android.view.View;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Method;
import java.lang.reflect.Proxy;
public class ActionListenerInstaller {

    public static void processAnnotations(Object client) {
        Class<?> client = client.getClass();

        for (Method m : client.getDeclaredMethods()) {

            //获取指定Annotation对象
            ActionListener listener = m.getAnnotation(ActionListener.class);

            if (listener != null) {
                try {
                    Field f = client.getDeclaredField(listener.source());
                    f.setAccessible(true);
                    //控件对象
                    Object focusView = f.get(client);
                    //addListenr函数添加监听,当click事件发生时,调用 onBtnClick() 函数
                    addListenr(focusView, client, m);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }

        }

    }

    private static void addListenr(final Object focusView, final Object client, final Method m) throws Exception {

        InvocationHandler handler = new InvocationHandler() {
            @Override
            public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
                //场景类调用 onBtnClick() 方法
                return m.invoke(client);
            }
        };

        Object onClickListenr = Proxy.newProxyInstance(null, new Class[]{View.OnClickListener.class}, handler);

        Method setOnClickListenerMethod = focusView.getClass().getMethod("setOnClickListener", View.OnClickListener.class);

        setOnClickListenerMethod.invoke(focusView, onClickListenr);

    }

}

插图:

android transitionManager的使用 android annotation_java_02


3.注解应用场景类

第三步:注解应用场景类中,只需要调用处理器中的processAnnotations方法,通过反射完成click事件的绑定,同时为click事件指定source控件,添加事件处理函数onBtnClick。这样一个简单的Android注解应用就完成了。

import android.app.Activity;
import android.os.Bundle;
import android.widget.Button;
public class MainActivity extends Activity {
private Button test_btn;
@Override
protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        test_btn = (Button) findViewById(R.id.test_btn);
        ActionListenerInstaller.processAnnotations(this);
    }
    @ActionListener(source = "test_btn")
    public void onBtnClick() {
        android.util.Log.d("czh","CLICK 事件发生了");
    }
}

插图:

android transitionManager的使用 android annotation_事件处理_03


运行结果插图:

android transitionManager的使用 android annotation_android_04

环境配置

使用Android注解前需要导入相关的包:

compile ‘com.android.support:support-annotations:latest.integration’

注:如果我们已经引入了appcompat则没有必要再次引用support-annotations,因为appcompat默认包含了对其引用。

注解类型

Android注解给我们提供了三种主要和其他注释供我们使用:

  • IntDef和StringDef注解;
  • 资源类型注解;
  • Null注解;
  • 其他实用注解

注解使用注意事项

在开发自定义注解时,需要注意以下几点:

  • 1.注解的实效范围
  • 2.注解适用的程序元素种类
  • 3.注解里的方法和字段只能用public 或abstract
  • 4.注解里的字段必须初始化