自己动手打造一个注解框架,彻底摆脱FindViewById

每次写代码的时候,看到一大堆FindViewById()都挺烦的,没有没什么方法能帮我摆脱这种烦恼呢?当然是有的,目前比较流行的时注解框架是Xutils3ButterKnife,接下来我们来分析一下它们是如何实现的.

Xutils3注解实现原理

  1. 首先看一下Xutils3的简单用法
 @ViewInject(R.id.tv_test)
    private TextView mTvTest;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        x.view().inject(this);

        mTvTest.setText("hello ioc");
    }

用法是相当的简单,通过@ViewInject绑定id,然后通过inject(this)注入当前对象,就完成了findViewById的过程.

  1. 查看Xutils原码,看看inject(this)做了什么

        // inject view
        Field[] fields = handlerType.getDeclaredFields();
        if (fields != null && fields.length > 0) {
            for (Field field : fields) {

                Class<?> fieldType = field.getType();
                if (
                /* 不注入静态字段 */     Modifier.isStatic(field.getModifiers()) ||
                /* 不注入final字段 */    Modifier.isFinal(field.getModifiers()) ||
                /* 不注入基本类型字段 */  fieldType.isPrimitive() ||
                /* 不注入数组类型字段 */  fieldType.isArray()) {
                    continue;
                }

                ViewInject viewInject = field.getAnnotation(ViewInject.class);
                if (viewInject != null) {
                    try {
                        View view = finder.findViewById(viewInject.value(), viewInject.parentId());
                        if (view != null) {
                            field.setAccessible(true);
                            field.set(handler, view);
                        } else {
                            throw new RuntimeException("Invalid @ViewInject for "
                                    + handlerType.getSimpleName() + "." + field.getName());
                        }
                    } catch (Throwable ex) {
                        LogUtil.e(ex.getMessage(), ex);
                    }
                }
            }
        } // end inject view

我们发现这里主要是通过反射,先获取该类的所有的属性,然后遍历,找到ViewInject注解,然后获取value值,即对应的viewId,然后再调用FindViewById找到对应的View,

 field.setAccessible(true);
 field.set(handler, view);

然后通过上述代码注入属性,就完成了FindViewById的全过程.仔细一分析,是不是也不是那么难.主要就是利用了java的反射机制,通过动态获取Annotation,然后实现View的注入.

属性注入 : 利用反射去 获取Annotation --> value --> findViewById --> 反射注入属性
事件注入 :利用反射去 获取Annotation --> value --> findViewById --> setOnclickListener --> 动态代理反射执行方法

ButterKnife注解实现原理

  1. 同样的,我们来看一下ButterKnife的简单用法
 @Bind(R.id.tv_test)
    private TextView mTvTest;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ButterKnife.bind(this);
        mTvTest.setText("hello ioc");
    }

也非常简洁,两行代码完成属性注入.(这里使用的7.0.1所以是@Bind而不是@BindView);

  1. 查看源码
    ButterKnife的源码看起来就比较费劲了,主要是通过ButterKnifeProcessor这个类动态解析Annotation注解,在编译时生成xxxxx$$ViewBinder这个类,然后实现FindViewById过程.
public class MainActivity$$ViewBinder<T extends com.example.wenjian.eassyjoke.MainActivity> implements ViewBinder<T> {
  @Override public void bind(final Finder finder, final T target, Object source) {
    View view;
    view = finder.findRequiredView(source, 2131427415, "field 'mTvTest'");
    target.mTvTest = finder.castView(view, 2131427415, "field 'mTvTest'");
  }

  @Override public void unbind(T target) {
    target.mTvTest = null;
  }
}

在这里我们也可以看到为什么声明属性的时候不能private

两者实现的方式有差异,ButterKnife基于编译时注解,相对较为高效

打造自己的注解框架

看了别人的代码,自己也可以动手撸一下了

  1. 首先我们得了解javaAnnatation,在这里我们先参考一下java的@Override
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

这里我们可以知道如何自定义注解
@Target指定注解作用目标,以下是ElementType的几种常用类型

Class, interface (including annotation type), or enum declaration /
TYPE,类
/
* Field declaration (includes enum constants) /
FIELD,属性
/
* Method declaration /
METHOD,方法
/
* Formal parameter declaration /
PARAMETER,参数
/
* Constructor declaration /
CONSTRUCTOR,构造方法
/
* Local variable declaration /
LOCAL_VARIABLE,本地变量
/
* Annotation type declaration /
ANNOTATION_TYPE,注解类型
/
* Package declaration */
PACKAGE,包

@Retention指定何时生效,有以下三种场景

 * Annotations are to be discarded by the compiler.
 */
SOURCE,源码
/**
 * Annotations are to be recorded in the class file by the compiler
 * but need not be retained by the VM at run time.  This is the default
 * behavior.
 */
CLASS,编译时
/**
 * Annotations are to be recorded in the class file by the compiler and
 * retained by the VM at run time, so they may be read reflectively.
 *
 * @see java.lang.reflect.AnnotatedElement
 */
RUNTIME,运行时

2.开始码自己的注解框架
自定义@ViewById

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)  //什么时候生效:运行时
public @interface ViewById {
    int value();
}

实现ViewUtils兼容各种场景

public class ViewUtils {

    public static void inject(Activity activity) {
        inject(new ViewFinder(activity),activity);

    }

    public static void inject(View view) {
        inject(new ViewFinder(view),view);
    }

    public static void inject(View view, Object object) {
        inject(new ViewFinder(view),object);
    }

    private static void inject(ViewFinder finder, Object object) {
        injectField(finder, object);
        injectEvent(finder, object);
    }

通过反射注入属性

 /**
     * 注入属性
     * @param finder
     * @param object
     */
    private static void injectField(ViewFinder finder, Object object) {
        //1.获取class
        Class<?> clazz = object.getClass();

        //2.获取所有的属性
        Field[] fields = clazz.getDeclaredFields();

        for (Field field : fields) {
            ViewById viewById = field.getAnnotation(ViewById.class);
            if (viewById != null) {
                int viewId = viewById.value();
                View view = finder.findViewById(viewId);
                if (view != null) {
                    //设置可以访问所有修饰符  包括private
                    field.setAccessible(true);
                    try {
                        //注入属性
                        field.set(object, view);
                    } catch (IllegalAccessException e) {
                        e.printStackTrace();
                    }
                }
            }
        }
    }

到此已经完成了,我们来验证一下吧

    @ViewById(R.id.tv_test)
    private TextView mTvTest;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ViewUtils.inject(this);
        mTvTest.setText("hello ioc");
    }

Xutils的实现方式差不多,同样是基于反射,重要的是不必依赖第三方库了.你也自己动手实现setOnclickListener,原理是一样的.

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

推荐阅读更多精彩内容