04.手写ButterKnife(ButterKnife源码阅读)-低调大师

04.手写ButterKnife(ButterKnife源码阅读)

2018-04-25 606

源码地址：https://github.com/renzhenming/MyButterknife

相信大多数安卓人员开发中都在使用ButterKnife进行代码生成。使用ButterKnife有几个好处，第一，提高开发效率，可以一键生成布局中所有的View对象或者设置View的点击事件，这两个功能是我们最常用的。第二，不会影响app运行效率，ButterKnife采用编译时注解的方式生成代码，相对于XUtils的注解方式，在效率上有很大的优势，看过Xutils源码的话你会发现，里边的注解是反射的方式实现的，而反射在一定程度上是会增大运行的开销的。

ButterKnife的作者是就职于谷歌的JakeWharton，在GitHub上可以看到完整的代码，https://github.com/JakeWharton/butterknife/tree/master/butterknife-annotations/src/main/java/butterknife，ButterKnife的功能是相当多的，不止是我们最长用的bindView set onClick等，看看这些注解就大概知道它所涉及到的功能点

826815906.png

今天打算实现的是其中一个BindView注解，后期可能会实现onClick方法，借此来加深一下编译时注解的使用

当我们在一个Activity中使用ButterKnife.bind（）之后，重新编译会生成这样一个类，xxxx_ViewBinding,xxxx代表的是当前Activity的名字，这个类是什么样的有什么作用，我们简单拷贝一个来看

public final class MainActivity_ViewBinding implements Unbinder {
  private MainActivity target;

  MainActivity_ViewBinding(MainActivity target) {
    this.target = target;
    target.world = Utils.findViewById(target,2131427424);
    target.bitch = Utils.findViewById(target,2131427425);
  }

  @Override
  @CallSuper
  public final void unbind() {
    target.world = null;
    target.bitch = null;
  }
}

从这个类上可以看到，使用ButterKnife并非不用findViewById了，而是把这个工作交给了编译器去自动生成，然后在bind方法调用的时候，反射一次创建这个自动生成的类的对象从而实现view注入的功能，那么为什么编译时会自动生成类呢，这要用到注解的知识，接下来我们开始自己手写一个简单的ButterKnife工具

我们仿照JakeWharton的分包形式，创建一个butterknife-annotation和butterknife-compiler的Java library（butterknife-compiler必须时Java library，因为注解生成器需要继承AbstractProcessor，这个类只有Java工程可以引用到），我们在butterknife-annotation中创建注解BindView

/**
 * Created by renzhenming on 2018/4/24.
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.CLASS)
public @interface BindView {
    int value();
}

在butterknife-compiler中创建注解生成器


/**
 * Created by renzhenming on 2018/4/24.
 * AbstractProcessor这个类是Java中的，只能在ava Library中使用
 */
@AutoService(Processor.class)
public class ButterKnifeProcessor extends AbstractProcessor {

    private Filer mFiler;
    private Elements mElementUtils;

    /**
     * init()方法会被注解处理工具调用，并输入ProcessingEnviroment参数。
     * ProcessingEnviroment提供很多有用的工具类Elements, Types 和 Filer
     * @param processingEnv 提供给 processor 用来访问工具框架的环境
     */
    @Override
    public synchronized void init(ProcessingEnvironment processingEnv) {
        super.init(processingEnv);
        mFiler = processingEnv.getFiler();
        mElementUtils = processingEnv.getElementUtils();
    }

    /**
     * 指定使用的Java版本，通常这里返回SourceVersion.latestSupported()，默认返回SourceVersion.RELEASE_6
     * @return  使用的Java版本
     */
    @Override
    public SourceVersion getSupportedSourceVersion() {
        return SourceVersion.latestSupported();
    }

    /**
     * 这里必须指定，这个注解处理器是注册给哪个注解的。注意，它的返回值是一个字符串的集合，包含本处理器想要处理的注解类型的合法全称
     * @return  注解器所支持的注解类型集合，如果没有这样的类型，则返回一个空集合
     */
    @Override
    public Set<String> getSupportedAnnotationTypes() {
        //仿照Butternife源码
        Set<String> types = new LinkedHashSet<>();
        for (Class<? extends Annotation> annotation: getSupportAnnotations()){
             types.add(annotation.getCanonicalName());
        }
        return types;
    }

    private Set<Class<? extends Annotation>> getSupportAnnotations() {
        Set<Class<? extends Annotation>> annotations = new LinkedHashSet<>();
        annotations.add(BindView.class);
        return annotations;
    }
    /**
     * 这相当于每个处理器的主函数main()，你在这里写你的扫描、评估和处理注解的代码，以及生成Java文件。
     * 输入参数RoundEnviroment，可以让你查询出包含特定注解的被注解元素
     * @param set   请求处理的注解类型
     * @param roundEnvironment  有关当前和以前的信息环境
     * @return  如果返回 true，则这些注解已声明并且不要求后续 Processor 处理它们；
     *          如果返回 false，则这些注解未声明并且可能要求后续 Processor 处理它们
     *
     *          这里的log信息只能在gradle console中看到，Android logcat看不到。要注意
     */
    @Override
    public boolean process(Set<? extends TypeElement> set, RoundEnvironment roundEnvironment) {
          ...........................
    }
}

注意注解生成器的这个library build.gradle的配置

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
    //AutoService注解使用
    compile 'com.google.auto.service:auto-service:1.0-rc3'
    //自动生成类相关
    compile 'com.squareup:javapoet:1.7.0'
    compile project(':butterknife-annotation')
}
//解决 错误: 编码GBK的不可映射字符 的报错
tasks.withType(JavaCompile){
    options.encoding='UTF-8'
}
//android studio不完全能兼容Java8，所以指定编译版本位1.7
sourceCompatibility = "1.7"
targetCompatibility = "1.7"

在我们项目主工程的app 配置文件build.gradle中设置依赖

compile project(':butterknife-annotation')
compile project(':butterknife-compiler')

这时候编译一下工程就可以执行到ButterKnifeProcessor 的process方法中了，如果看不到打印，检查两点
第一：目标文件（bind绑定的activity）是否相比于上一次编译有修改，如果代码没有改变，不会重新编译
第二：因为是Java library中打印的log，在Android studio的logcat中是无法看到的，你需要到Gradle Console中去看

process方法有执行了，那么进行下一步，编写自动生成类的代码,在process方法中加入如下代码

//------------获取注解-----------

        Set<? extends Element> elements = roundEnvironment.getElementsAnnotatedWith(BindView.class);
        //LinkedHashMap输出和输入的顺序相同，先输入就先输出
        Map<Element,List<Element>> elementsMap = new LinkedHashMap<>();
        for (Element element : elements) {
            //这里会把所有跟注解有关的field全部拿到，包括各个类中的field,也就是说在
            //编译时，项目中所有涉及到这个注解的地方的所有field都在这个Set中返回了，
            //我们需要手动进行分类
            System.out.println("-----------------------"+element.getSimpleName());
            //得到的enclosingElement是这个field所在类的类名
            Element enclosingElement = element.getEnclosingElement();
            System.out.println("------------enclosingElement-----------"+enclosingElement.getSimpleName());
            //以类名位key值存储一个类中所有的field到集合中
            List<Element> bindViewElements = elementsMap.get(enclosingElement);
            if (bindViewElements == null){
                bindViewElements = new ArrayList<>();
                elementsMap.put(enclosingElement,bindViewElements);
            }
            bindViewElements.add(element);
        }

        //------------生成代码-----------

        for (Map.Entry<Element,List<Element>> entry:elementsMap.entrySet()){
            Element enclosingElement = entry.getKey();
            List<Element> bindViewElements = entry.getValue();

            ClassName unbinderClassName = ClassName.get("com.rzm.butterknife","Unbinder");
            System.out.println("------------Unbinder-----------"+unbinderClassName.simpleName());
            //得到类名的字符串
            String activityName = enclosingElement.getSimpleName().toString();
            ClassName activityClassName = ClassName.bestGuess(activityName);
            //拼装这一行代码：public final class xxx_ViewBinding implements Unbinder
            TypeSpec.Builder classBuilder = TypeSpec.classBuilder(activityName+"_ViewBinding")
                    //类名前添加public final
                    .addModifiers(Modifier.FINAL,Modifier.PUBLIC)
                    //添加类的实现接口
                    .addSuperinterface(unbinderClassName)
                    //添加一个成员变量，这个名字target是仿照butterknife
                    .addField(activityClassName,"target",Modifier.PRIVATE);

            //实现Unbinder的方法
            //CallSuper这个注解不像Override可以直接拿到，需要用这种方式
            ClassName callSuperClass = ClassName.get("android.support.annotation","CallSuper");
            MethodSpec.Builder unbindMethod = MethodSpec.methodBuilder("unbind")//和你创建的Unbinder中的方法名保持一致
                    .addAnnotation(Override.class)
                    .addAnnotation(callSuperClass)
                    .addModifiers(Modifier.FINAL, Modifier.PUBLIC);

            //添加构造函数
            MethodSpec.Builder constructMethodBuilder = MethodSpec.constructorBuilder()
                    .addParameter(activityClassName,"target");
            constructMethodBuilder.addStatement("this.target = target");
            for (Element bindViewElement : bindViewElements) {
                String fieldName = bindViewElement.getSimpleName().toString();

                //在构造方法中添加初始化代码
                ClassName utilsClassName = ClassName.get("com.rzm.butterknife", "Utils");
                BindView annotation = bindViewElement.getAnnotation(BindView.class);
                int resId = annotation.value();
                constructMethodBuilder.addStatement("target.$L = $T.findViewById(target,$L)",fieldName,utilsClassName,resId);

                //在unbind方法中添加代码 target.textView1 = null;
                //不能用addCode,因为它不会在每一行代码后加分号和换行
                unbindMethod.addStatement("target.$L = null",fieldName);
            }
            classBuilder.addMethod(constructMethodBuilder.build());


            classBuilder.addMethod(unbindMethod.build());

            //开始生成
            try {

                //得到包名
                String packageName = mElementUtils.getPackageOf(enclosingElement)
                        .getQualifiedName().toString();

                JavaFile.builder(packageName,classBuilder.build())
                        //添加类的注释
                        .addFileComment("butterknife 自动生成")
                        .build().writeTo(mFiler);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
        return false;

创建一个butterknife安卓library,创建类ButterKnife,实现bind方法,通过反射将自动生成的类生成注入view

public class ButterKnife {

    public static Unbinder bind(Activity activity){
        try {
            Class<? extends Unbinder> clazz = (Class<? extends Unbinder>) Class.forName(activity.getClass().getName() + "_ViewBinding");
            //构造函数

            Constructor<? extends Unbinder> unbinderConstuctor = clazz.getDeclaredConstructor(activity.getClass());
            Unbinder unbinder = unbinderConstuctor.newInstance(activity);
            return unbinder;
        } catch (Exception e) {
            e.printStackTrace();
        }
        return Unbinder.EMPTY;
    }
}

Unbinder
···
public interface Unbinder {

//仿照butterknife源码

@UiThread
void unbind();

Unbinder EMPTY = new Unbinder() {
    @Override
    public void unbind() {

    }
};

}
···
Utils

public class Utils {
    public static <T extends View> T findViewById(Activity activity,int viewId){
        return (T)activity.findViewById(viewId);
    }
}

测试一下使用

public class MainActivity extends AppCompatActivity {

    @BindView(R.id.text1)
    TextView world;

    @BindView(R.id.text2)
    TextView bitch;


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

重新编译一下，可以看到自动生成的类

828223296.png

运行成功，至此我们不需要写findViewById也可以得到view对象了

微信关注我们

原文链接：https://yq.aliyun.com/articles/657339

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

原码，补码，反码

点击关注异步图书，置顶公众号每天与你分享 IT好书技术干货职场知识机器数一个数在计算机中的二进制表示形式, 叫做这个数的机器数。机器数是带符号的，在计算机用一个数的最高位存放符号, 正数为0, 负数为1. 真值因为第一位是符号位，所以机器数的形式值就不等于真正的数值。例如上面的有符号数 10000011，其最高位1代表负，其真正数值是 -3 而不是形式值131（10000011转换成十进制等于131）。所以，为区别起见，将带符号位的机器数对应的真正数值称为机器数的真值。原码, 反码, 补码基本概念原码原码(true form)是一种计算机中对数字的二进制定点表示方法。原码表示法在数值前面增加了一位符号位（即最高位为符号位）：正数该位为0，负数该位为1（0有两种表示：+0和-0），其余位表示数值的大小。原码的优点简单直观；例如，我们用8位二进制表示一个数，+11的原码为00001011，-11的原码就是10001011 原码的缺点原码不能直接参加运算，可能会出错。例如数学上，1+(-1)=0，而在二进制中00000001+10000001=10000010，换算成...

2018-04-26

583

版权声明：本文为博主原创文章，未经博主允许不得转载。 https://blog.csdn.net/a724888/article/details/80100185 这位大侠，这是我的公众号：程序员江湖。分享程序员面试与技术的那些事。干货满满，关注就送。本文主要介绍了Java中的回调机制，以及Java多线程中类似回调的机制。具体代码在我的GitHub中可以找到 https://github.com/h2pl/MyTech 文章首发于我的个人博客： https://h2pl.github.io/2018/04/26/javase9 更多关于Java后端学习的内容请到我的CSDN博客上查看：https://blog.csdn.net/a724888 模块间的调用本部分摘自https://www.cnblogs.com/xrq730/p/6424471.html 在一个应用系统中，无论使用何种语言开发，必然存在模块之间的调用，调用的方式分为几种：（1）同步调用同步调用是最基本并且最简单的一种调用方式，类A的方法a()调用类B的方法b()，一直等待b()方法执行完毕，a()方法继续...

2018-04-26

595

资源下载

更多资源

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称，一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能，例如代码缩略图，Python的插件，代码段等。还可自定义键绑定，菜单和工具栏。Sublime Text 的主要功能包括：拼写检查，书签，完整的 Python API ， Goto 功能，即时项目切换，多选择，多窗口等等。Sublime Text 是一个跨平台的编辑器，同时支持Windows、Linux、Mac OS X等操作系统。