Android注解使用快速入门

原创 2016年02月16日 23:08:13

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

注解在Android应用开发当中,使用还是很广泛的。很多热门的框架都使用了注解,例如,butterknife ,retrofit,一些主流的数据库框架等。

一个完整的注解应用通常由注解接口定义、注解事件处理器、注解应用场景类三部分组成。


1.注解接口定义

定义注解格式:

public @interface 注解名 {定义体}

注解参数的可支持数据类型:

1.所有基本数据类型(int,float,boolean,byte,double,char,long,short)
2.String类型
3.Class类型
4.enum类型
5.Annotation类型
6.以上所有类型的数组

package com.chen.annotation;

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";
}

其中,

@Target

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

取值(ElementType)有:
1.CONSTRUCTOR:用于描述构造器
2.FIELD:用于描述域
3.LOCAL_VARIABLE:用于描述局部变量
4.METHOD:用于描述方法
5.PACKAGE:用于描述包
6.PARAMETER:用于描述参数
7.TYPE:用于描述类、接口(包括注解类型) 或enum声明

@Retention

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

取值(RetentionPoicy)有:
1.SOURCE:在源文件中有效(即源文件保留)
2.CLASS:在class文件中有效(即class保留)
3.RUNTIME:在运行时有效(即运行时保留)

2.注解事件处理器

编写注解事件处理器,通过反射获得场景类对象的annotation的source对象。并且为source对象调用setOnClickListener方法进行事件绑定。

package com.chen.annotation;

import android.view.View;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Method;
import java.lang.reflect.Proxy;

/**
 * Created by chenzhaohua on 16/1/31.
 */
public class ActionListenerInstaller {

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

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

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

            if (listener != null) {
                try {
                    Field f = clientClass.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);

    }

}

3.注解应用场景类

注解应用场景类中,只需要调用处理器中的processAnnotations方法,通过反射完成click事件的绑定。

同时为click事件指定source控件,添加事件处理函数onBtnClick。

这样一个简单的Android注解应用就完成了。

package com.chen.annotation;

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 事件发生了");
    }

}
版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/czhpxl007/article/details/50677112

Android-注解详解

Android-注解详解背景上一章,我们研究了 Java注解 的用法;紧跟着这章研究一下Android相关的注解的使用,比如我们熟悉的ButterKnife就是使用注解的方式实现对其使用,掌握注解的使...
  • u014610664
  • u014610664
  • 2016-12-06 11:34:32
  • 4798

android注解使用详解(图文)

在使用Java的SSH框架的时候,一直在感叹注解真是方便啊,关于注解的原理,大家可以参考我的另一片文章Java注解详解。最近有时间研究了android注解的使用,今天与大家分享一下。android中注...
  • u012702547
  • u012702547
  • 2015-08-08 10:45:59
  • 6798

Android通过注解初始化View

Android通过注解的方式来初始化View,替代findViewById。几行代码实现最简单注解,提高工作效率。...
  • zhangweiwtmdbf
  • zhangweiwtmdbf
  • 2014-06-12 14:42:24
  • 24965

AndroidAnnotation常用注解使用说明

简介 AndroidAnnotations是一个开源框架,通过使用它开放出来的注解api,可以大大的减少无关痛痒的代码量,简洁代码。 官方文档(github链接) 第三方库导入 ...
  • u013164293
  • u013164293
  • 2016-05-12 20:15:53
  • 913

Android 中注解的使用

> 转载请标明出处: [http://blog.csdn.net/airsaid/article/details/78017487](http://blog.csdn.net/airsaid/arti...
  • Airsaid
  • Airsaid
  • 2017-09-18 11:40:49
  • 547

Android 如何编写基于编译时注解的项目

本文已在CSDN《程序员》杂志刊登。 本文已授权微信公众号:鸿洋(hongyangAndroid)在微信公众号平台原创首发。 转载请标明出处: http://blog.csd...
  • lmj623565791
  • lmj623565791
  • 2016-07-20 12:09:38
  • 31722

使用Android注解来改善代码

昨晚看到一篇好文章,然后是英文的,所以决定翻译分享给大家,这是原文链接:http://www.michaelevans.org/blog/2015/07/14/improving-your-code-...
  • abren32
  • abren32
  • 2015-07-21 13:59:30
  • 1744

Android中使用注解替代枚举

枚举最大的作用是提供了类型安全。为了弥补Android平台不建议使用枚举的缺陷,官方推出了两个注解,IntDef和StringDef,用来提供编译期的类型检查。 首先,引入依赖包: compi...
  • hp910315
  • hp910315
  • 2016-08-07 18:21:58
  • 3128

这些高效的Android注解,你有使用过么?

介绍几个support library 19.1中的注解,这几个注解在项目中非常有用,而且library本身也是用了这些注解。让我们来研究下。 在项目中使用这些注解很简单,只需要在build.grad...
  • IceDream_hong
  • IceDream_hong
  • 2015-03-06 19:04:02
  • 11755

Android注解应用

在看一些项目的源代码时经常会遇到注释的应用,这里做一些总结。 用一个例子来说明吧: 一、注解使用 使用开源框架LiteOrm来定义一张数据库表: import ...
  • DawnRanger
  • DawnRanger
  • 2015-02-03 12:55:19
  • 1044
收藏助手
不良信息举报
您举报文章:Android注解使用快速入门
举报原因:
原因补充:

(最多只允许输入30个字)