xUtils -- view模块分析

简介

xUtils是Android的工具库，其中包含有View、Bitmap、Db、Http四个模块。

本篇主要争对xUtils的2.6.14版本和xUtils3版本的View模块做个分析。

View模块主要提供功能有View布局的绑定，事件的绑定。而在xUtils2.6.14中还提供资源绑定等功能。

使用

@ContentView(R.layout.activity_main)
public class MainActivity extends Activity {

    @ViewInject(R.id.btn)
    Button btn;

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

        x.view().inject(this);

    }


    @Event(value = R.id.btn, type = View.OnLongClickListener.class)
    private boolean onBtnClick(View view) {
        Toast.makeText(MainActivity.this, "onBtnClick", Toast.LENGTH_SHORT).show();
        return true;
    }
}

简要分析

主要通过注解，反射，动态代理的技术。

在定义View时添加注解，确定所要注入的id等信息，并在Activity启动的onCreate方法执行注入x.view().inject(this);，而对于事件的绑定则还需要通过动态代理来实现。

图片很好概括了这个过程，图片来自于xUtils 源码解析

关于注解的文章：
Java注解实践
公共技术点之 Java 注解 Annotation

关于反射的文章：
公共技术点之 Java反射 Reflection

关于动态代理的文章：
公共技术点之 Java 动态代理
Java 动态代理机制分析及扩展

xUtils2.6.14和xUtils3分析

两者都支持注解ContentView、View、Event。

但是2.6.14版本支持注解资源，还有preference，这些功能在xUtils3被移除掉。

xUtils2.6.14和xUtils3的View部分变化主要在Event部分，对比两个版本View模块注解，可以发现2.6.14版本的事件注解类型多，而且扩展性不高，

先看下xUtils2.6.14事件注解

// xUtils2.6.14
@Target(ElementType.ANNOTATION_TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface EventBase {
    Class<?> listenerType();

    String listenerSetter();

    String methodName();
}

// onClick方法注解 其他注解类似
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@EventBase(
        listenerType = View.OnClickListener.class,
        listenerSetter = "setOnClickListener",
        methodName = "onClick")
public @interface OnClick {
    int[] value();

    int[] parentId() default 0;
}

再看下xUtils3的事件注解：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Event {

    /** * 控件的id集合, id小于1时不执行ui事件绑定. * * @return */
    int[] value();

    /** * 控件的parent控件的id集合, 组合为(value[i], parentId[i] or 0). * * @return */
    int[] parentId() default 0;

    /** * 事件的listener, 默认为点击事件. * * @return */
    Class<?> type() default View.OnClickListener.class;

    /** * 事件的setter方法名, 默认为set+type#simpleName. * * @return */
    String setter() default "";

    /** * 如果type的接口类型提供多个方法, 需要使用此参数指定方法名. * * @return */
    String method() default "";
}

xUtils3通过使用一个注解表示事件。

看下主要函数：

private static void injectObject(Object handler, ViewFinder finder) {

        Class<?> handlerType = handler.getClass();

        // inject ContentView
        ContentView contentView = handlerType.getAnnotation(ContentView.class);
        // ...
        Method setContentViewMethod = handlerType.getMethod("setContentView", int.class);
        setContentViewMethod.invoke(handler, contentView.value());
        // ...  

        // inject view
        Field[] fields = handlerType.getDeclaredFields();
        if (fields != null && fields.length > 0) {
            for (Field field : fields) {
                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);
                        }
                    } catch (Throwable e) {
                        LogUtils.e(e.getMessage(), e);
                    }
                } else {

                    // inject resourse
                    ResInject resInject = field.getAnnotation(ResInject.class);
                    if (resInject != null) {
                        try {
                            Object res = ResLoader.loadRes(
                                    resInject.type(), finder.getContext(), resInject.id());
                            if (res != null) {
                                field.setAccessible(true);
                                field.set(handler, res);
                            }
                        } catch (Throwable e) {
                            LogUtils.e(e.getMessage(), e);
                        }
                    } else {

                        // inject preference
                        // ...
                        field.set(handler, preference);
                        // ...
                    }
                }
            }
        }

        // inject event
        Method[] methods = handlerType.getDeclaredMethods();
        if (methods != null && methods.length > 0) {
            for (Method method : methods) {
                Annotation[] annotations = method.getDeclaredAnnotations();
                if (annotations != null && annotations.length > 0) {
                    for (Annotation annotation : annotations) {
                        Class<?> annType = annotation.annotationType();
                        if (annType.getAnnotation(EventBase.class) != null) {
                            method.setAccessible(true);
                            try {
                                // ...
                                for (int i = 0; i < len; i++) {
                                    ViewInjectInfo info = new ViewInjectInfo();
                                    info.value = Array.get(values, i);
                                    info.parentId = parentIdsLen > i ? (Integer) Array.get(parentIds, i) : 0;
                  // 动态代理处理                  EventListenerManager.addEventMethod(finder, info, annotation, handler, method);
                                }
                            } catch (Throwable e) {
                                LogUtils.e(e.getMessage(), e);
                            }
                        }
                    }
                }
            }
        }
    }

而对于这一个过程分析及实现的有
打造IOC框架 上
打造IOC框架 下

总结

本篇博客简单分析xUtils的view注入过程，和对xUtils版本改进后的理解。

View的注入使用了注解和反射等技术，在开发过程中难免会造成资源浪费以及效率低下，但是这一过程涉及到Java的注解和反射以及动态代理等技术，还是非常值得去学习，而不是只会使用。

最后，如哪里不足或者分析错误，非常欢迎指正，谢谢。