【腾讯Bugly干货分享】深入理解 ButterKnife，让你的程序学会写代码

摘要：这似乎是一个很有意思的话题，如果你的程序足够聪明，它就可以自己写代码那么这么说就是要给生成的代码添加一个属性咯不不不，是添加一组注入关系，后面生成代码时，注解管理器就需要根据这些解析来的关系来组织生成的代码。

本文来自于腾讯bugly开发者社区，非经作者同意，请勿转载，原文地址：http://dev.qq.com/topic/578753c0c9da73584b025875

话说我们做程序员的，都应该多少是个懒人，我们总是想办法驱使我们的电脑帮我们干活，所以我们学会了各式各样的语言来告诉电脑该做什么——尽管，他们有时候也会误会我们的意思。

突然有一天，我觉得有些代码其实，可以按照某种规则生成，但你又不能不写——不是所有的重复代码都可以通过重构并采用高端技术比如泛型来消除的——比如我最痛恨的代码：

TextView textView = (TextView) findViewById(R.id.text_view);
Button button = (Button) findViewById(R.id.button);

这样的代码，你总不能不写吧，真是让人沮丧。突然想到以前背单词的故事：正着背背不过 C，倒着背背不过 V。嗯，也许写 Android app，也是写不过 findViewById 的吧。。

我们今天要介绍的 ButterKnife 其实就是一个依托 Java 的注解机制来实现辅助代码生成的框架，读完本文，你将能够了解到 Java 的注解处理器的强大之处，你也会对 dagger2 和 androidannotations 这样类似的框架有一定的认识。

说真的，我一直对于 findViewById 这个的东西有意见，后来见到了 Afinal 这个框架，于是我们就可以直接通过注解的方式来注入，哇塞，终于可以跟 findViewById 说『Byte Byte』了，真是好开心。

什么？寨见不是介么写么？

不过，毕竟是移动端，对于用反射实现注入的 Afinal 之类的框架，我们总是难免有一种发自内心的抵触，于是。。。

别哭哈，不用反射也可以的~~

这个世界有家神奇的公司叫做 Square，里面有个大神叫 Jake Wharton，开源了一个神奇的框架叫做 ButterKnife，这个框架虽然也采用了注解进行注入，不过人家可是编译期生成代码的方式，对运行时没有任何副作用，果真见效快，疗效好，只是编译期有一点点时间成本而已。

说句题外话，现如今做 Android 如果不知道 Jake Wharton，我觉得面试可以直接 Pass 掉了。。。哈哈，开玩笑啦

怎么介绍一个东西，那真是一个折学问题。别老说我没文化，我的意思是比较曲折嘛。

我们还是要先简单介绍一些 ButterKnife 的基本用法，这些知识你在 ButterKnife 这里也可以看到。

简单来说，使用 ButterKnife 需要三步走：

配置编译环境，由于 Butterknife 用到了注解处理器，所以，比起一般的框架，配置稍微多了些，不过也很简单啦：

buildscript {
    repositories {
      mavenCentral()
    }
    dependencies {
      classpath "com.android.tools.build:gradle:1.3.1"
      classpath "com.neenbedankt.gradle.plugins:android-apt:1.8"
    }
}
apply plugin: "com.neenbedankt.android-apt"
...
dependencies {
    compile "com.jakewharton:butterknife:8.1.0"
    apt "com.jakewharton:butterknife-compiler:8.1.0"
}

用注解标注需要注解的对象，比如 View，比如一些事件方法（用作 onClick 之类的），例：

@Bind(R.id.title)
TextView title;

@OnClick(R.id.hello)
void sayHello() {
    Toast.makeText(this, "Hello, views!", LENGTH_SHORT).show();
    ButterKnife.apply(headerViews, ALPHA_FADE);
}

在初始化布局之后，调用 bind 方法：

setContentView(R.layout.activity_main);
ButterKnife.bind(this);//一定要在 setContentView 之后哈，不然你就等着玩空指针吧

瞧，这时候你要是编译一下，你的代码就能欢快的跑起来啦，什么 findViewById，什么 setOnClickListener，我从来没听说过~

哈，不过你还是要小心一点儿，你要是有本事写成这样，ButterKnife 就说『信不信我报个错给你看啊！』

@Bind(R.id.title)
private TextView title;

@OnClick(R.id.hello)
private void sayHello() {
    Toast.makeText(this, "Hello, views!", LENGTH_SHORT).show();
    ButterKnife.apply(headerViews, ALPHA_FADE);
}

Error:(48, 22) error: @Bind fields must not be private or static. (com.example.butterknife.SimpleActivity.title)
Error:(68, 18) error: @OnClick methods must not be private or static. (com.example.butterknife.SimpleActivity.sayHello)

这又是为神马嘞？如果你知道 ButterKnife 的机制，那么这个问题就很清晰了，前面我们已经提到，ButterKnife 是通过注解处理器来生成辅助代码进而达到自己的注入目的的，那么我们就有必要瞅瞅它究竟生成了什么鬼。

话说，生成的代码就在 build/generated/source/apt 下面，我们就以 ButterKnife 的官方 sample 为例，它生成的代码如下：

让我们看一下 SimpleActivity$$ViewBinder:

public class SimpleActivity$$ViewBinder implements ViewBinder {
  @Override
  public void bind(final Finder finder, final T target, Object source) {
    Unbinder unbinder = new Unbinder(target);
    View view;
    //注入 title，这里的 target 其实就是我们的 Activity
    view = finder.findRequiredView(source, 2130968576, "field "title"");
    target.title = finder.castView(view, 2130968576, "field "title"");
    
    //下面注入 hello 这个 Button，并为其设置 click 事件
    view = finder.findRequiredView(source, 2130968578, "field "hello", method "sayHello", and method "sayGetOffMe"");
    target.hello = finder.castView(view, 2130968578, "field "hello"");
    unbinder.view2130968578 = view;
    view.setOnClickListener(new DebouncingOnClickListener() {
      @Override
      public void doClick(View p0) {
        target.sayHello();
      }
    });
    ...
  }

  ...
}

我们看到这里面有个叫 bind 的方法，这个方法跟我们之前调用的 ButterKnife.bind的关系可想而知——其实，后者只是个引子，调用它就是为了调用生成的代码。什么，不信？好吧，我就喜欢你们这些充满好奇的娃。我们在调用 ButterKnife.bind 之后，会进入下面的方法：

  static void bind(@NonNull Object target, @NonNull Object source, @NonNull Finder finder) {
    Class targetClass = target.getClass();
    try {
      ViewBinder