Android,几分钟教你怎么应用自定义注解

相信各位Android程序猿都了解过 **ButterKnife** 这个高效的注解,对于 **InjectView** 高效的替代findViewId更是熟之又熟。以下代码:
@InjectView(R.id.textview)
private TextView textView;
好了,今天目的不是为了介绍 **ButterKnife** 这个框架哈。这次写的文章主要是为了介绍注解基本概念,同时用案例实现注解代替findViewId、setContentView。

一、注解作用

在Java开发中,注解一般有一下功能:
(1) **标识 **
在jdk中,类似我们比较常见的注解有Override,Deprecated,SuppressWarnings,这些作用只是作为标识,删除对程序没影响。他们的作用分别为:
Override 表示这个方法重写了父类的方法
Deprecated 表示jdk中不建议使用这个方法或者属性
SuppressWarnings 表示屏蔽了某些警告

(2)运行时处理
这个编译器默认的做法,编译器会通过class文件,逐个逐个的遍历class的属性和方法,即运行时处理。

(3)编译时处理
在运行之前,有学过C的程序猿就会知道,编译器在运行之前,编译的时候会将include进来的*.h文件进行引入。同理例如你在代码中引入注解,编译器会在编译的时候,在注解的属性引入在进行编译。

二、注解基础

首先

这里先看下定义的一个注解

public @interface ViewInject {  
  int value() default  -1;
}
这上面记得要添加一个@喔,不然就变成了定义了一个接口。在这里,value()不是代表一个方法,而是代表一个属性,其中value是属于整形的属性,默认值为1。
其次

这里先看下定义的一个注解的时候,添加元注解

@Target({ElementType.FIELD, ElementType.PARAMETER, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface ViewInject {
    int value() default  -1;
}

上面的代码举例了在定义注解的时候,常见的元注解Target和Retention,这里说明下:
(一)Target ->注解工表明应用在什么地方
1.CONSTRUCTOR:用于描述构造器
2.FIELD:用于描述域
3.LOCAL_VARIABLE:用于描述局部变量
4.METHOD:用于描述方法
5.PACKAGE:用于描述包
6.PARAMETER:用于描述参数
7.TYPE:用于描述类、接口(包括注解类型) 或enum声明
(二)Retention ->注解的功能差不多说明的就是你的注解的生命周期
1.SOURCE:在源文件中有效(即源文件保留)
2.CLASS:在class文件中有效(即class保留)
3.RUNTIME:在运行时有效(即运行时保留)

最后

综合上面的说明,以下代码说明:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface LayouyInject {
    int value() default -1;
}
这个注解作用域在类中(待会看实例就知道为什么),并且只要在运行时就有效,定义了一个默认属性value。

三、实战注解

在第一段的时候,我们说过ButterKnife注解可以直接秒杀findViewId,这一瞬间代码简洁了很多。现在我们动手不用框架,自己写一个注解实现这个功能,重在实践嘛~现在贴上代码,注释都写的比较清楚哈。

(一)定义一个基础的Activity

用于初始化解析注解,分别设置布局与初始化view,代码如下:

package cn.wsy.myretrofit.annotation;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;

import java.lang.reflect.Field;

/**
 * Created by wsy on 2016/8/18.
 */
public class InjectActivity extends AppCompatActivity {

    private int mLayoutId = -1;

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

    /**
     * 解析注解view id
     */
    private void displayInjectView() {
        if (mLayoutId <=0){return ;}
        Class<?> clazz = this.getClass();
        Field[] fields = clazz.getDeclaredFields();//获得声明的成员变量
        for (Field field : fields) {
            //判断是否有注解
            try {
                if (field.getAnnotations() != null) {
                    if (field.isAnnotationPresent(ViewInject.class)) {//如果属于这个注解
                        //为这个控件设置属性
                        field.setAccessible(true);//允许修改反射属性
                        ViewInject inject = field.getAnnotation(ViewInject.class);
                        field.set(this, this.findViewById(inject.value()));
                    }
                }
            } catch (Exception e) {
//                throw new InterruptedException("not found view id!");
                Log.e("wusy", "not found view id!");
            }
        }
    }

    /**
     * 注解布局Layout id
     */
    private void displayInjectLayout() {
        Class<?> clazz = this.getClass();
        if (clazz.getAnnotations() != null){
            if (clazz.isAnnotationPresent(LayouyInject.class)){
                LayouyInject inject = clazz.getAnnotation(LayouyInject.class);
                mLayoutId = inject.value();
                setContentView(mLayoutId);
            }
        }

    }
}

首先,这里是根据映射实现设置控件的注解。作为程序猿的各位应该知道,java中使用反射的机制,效率性能并不高。所以真正开发的时候,需要根据需求去思考怎么样的实现方式哈,这里笔者只是举例子实现注解。**ButterKnife**官方申明不是通过反射机制,因此效率会高点。
(二)应用注解
package cn.wsy.myretrofit;

import android.os.Bundle;
import android.widget.TextView;

import cn.wsy.myretrofit.annotation.InjectActivity;
import cn.wsy.myretrofit.annotation.LayouyInject;
import cn.wsy.myretrofit.annotation.ViewInject;

@LayouyInject(R.layout.activity_main)
public class MainActivity extends InjectActivity {

    @ViewInject(R.id.textview)
    private TextView textView;

    @ViewInject(R.id.textview1)
    private TextView textview1;

    @ViewInject(R.id.textview2)
    private TextView textview2;

    @ViewInject(R.id.textview3)
    private TextView textview3;

    @ViewInject(R.id.textview4)
    private TextView textview4;

    @ViewInject(R.id.textview5)
    private TextView textview5;

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

       //设置属性
        textView.setText("OK");
        textview1.setText("OK1");
        textview2.setText("OK2");
        textview3.setText("OK3");
        textview4.setText("OK4");
        textview5.setText("OK5");

    }

}

上面直接继承InjectActivity即可,文章上面也有说过:LayouyInject为什么作用域是TYPE,首先在加载view的时候,肯定是优先加载布局啊,**ButterKnife**也不例外。因此选择作用域在描述类,并且存在运行时。

三、总结

今天大概归纳了日常注解常用的元注解,并且用反射机制的方式,实现了控件与布局的注解,希望可以帮到读者理解,谢谢!

傻小孩b mark
共勉,写给在成长路上奋斗的你

喜欢就为我点下喜欢吧:-D,感谢各位读者阅读。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,425评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,058评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,186评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,848评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,249评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,554评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,830评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,536评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,239评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,505评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,004评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,346评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,999评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,060评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,821评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,574评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,480评论 2 267

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,563评论 25 707
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,099评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,355评论 6 343
  • 也许以后细细打量这条小巷的机会大概也是会少了吧,所以今天不妨提笔记记这条小巷的风情。 入口的那家花店也算是这条小巷...
    流年飞萤阅读 317评论 5 3
  • 今天天气特别凉爽,外面下着时断时续的雨。你在家里时它下得正浓,你出去时,它几乎没下,多么完美的配合。 孩子们很乖,...
    华丽的美丽丽阅读 236评论 0 0