ButterKnife（黄油刀）基本使用与源码解析

我会带着你远行 2021-11-29 22:40 677阅读 0赞

![logo][]

### 前言 ###

`ButterKnife`又称黄油刀，是一款快速绑定`Android`视图中字段和方法的注解框架，也是`Android`开发中比较常用的一款快速注解框架，通过`ButterKnife`的合理运用，我们可以避免重复地书写`findViewById`，在各种场合下快速地绑定view`中的多种事件`,大大提高开发的效率，它具有如下几点主要的功能：

1.  通过`@BindView`注解消除`findViewById`的使用
2.  将多个`view`组成一个列表或者数组，使用`action`、`setter`、`properties`一次性地操作被分到一组的`view`
3.  通过`@OnClick`注解来消除设置监听器（`Listenter`）时书写的各种匿名内部类
4.  通过为字段添加注解，消除了手动对资源的查找

接下来，我将首先向大家介绍`ButterKnife`的用法，然后针对`ButterKnife`的核心源码展开分析，从源码级别带大家了解`ButterKnife`的原理和结构，本文结构如下：

![image-20190722184602154][]

### 基本使用 ###

在使用`ButterKnife`之前，我们需要先在项目中添加`ButterKnife`的依赖，打开你项目的`build.gradle`文件，添加如下代码：

android {
      ...
      // Butterknife requires Java 8.
      compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
      }
    }
    
    dependencies {
      implementation 'com.jakewharton:butterknife:10.1.0'
      annotationProcessor 'com.jakewharton:butterknife-compiler:10.1.0'
      //如果你使用的是kotlin，把这里的annotationProcessor替换成kapt即可
    }

然后我们就可以开始代码的编写了。

#### 视图绑定（View binding） ####

我们本例针对下图这样一个登录/注册的场景向大家说明我们应该如何通过`ButterKnife`进行视图绑定：

![image-20190721203349736][]

图中一共有4个`View`，分别是用户名输入框（`EditText`）、密码输入框（`EditText`）、登录按钮（`Button`）、注册提示（`TextView`），如果按照传统的视图绑定的方法，我们至少需要写4个`findViewById(id)`来将视图与字段进行绑定，通过`ButterKnife`，我们就可以这样：

public class MyActivity extends Activity {
        
    
        @BindView(R.id.et_username)
        EditText mEtUsername;
        @BindView(R.id.et_password)
        EditText mEtPassword;
        @BindView(R.id.bt_login)
        Button mBtLogin;
        @BindView(R.id.tx_signup)
        TextView mTxSignUp;
    
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
        
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_my);
            ButterKnife.bind(this);
    
        }
    }

可以看到，我们只需要为每一个字段添加一个`@BindView(viewId)`注解，然后在`Activity`的`onCreate（）`方法中进行`ButterKnife.bind(this)`即可，ButterKnife会在编译期间为我们进行自动代码生成，基于上面的注解，ButterKnife会在编译期间为我们生成类似如下代码：

public void bind(MyActivity activity) {
        
      activity.mEtUsername = (android.widget.TextView) activity.findViewById(2130968578);
      activity.mEtPassword = (android.widget.TextView) activity.findViewById(2130968579);
      activity.mBtLogin = (android.widget.TextView) activity.findViewById(2130968577);
      activity.mTxSignUp = (android.widget.TextView) activity.findViewById(2130968567);
    }

可以发现，`ButterKnife`其实是将我们的注解翻译为了`findViewById`这样的语句，然后为我们进行了自动代码生成，从而使我们可以通过更简单的代码完成原来的需求。

#### 资源绑定（Resource binding） ####

我们可以使用`@ BindBool`，`@ LabelColor`，`@ LabelDimen`，`@ LabelDrawable`，`@ LabelInt`，`@ StickString`绑定预定义的资源，将`R.bool.ID,R.Color.ID...`（或您指定的类型）绑定到其对应的字段，比如：

public class MyActivity extends Activity {
        
    
      	//将mUserName字段和string资源文件中的user_name绑定到一起
        @BindString(R.string.user_name)
        String mUserName;
       //将mBackground字段与drawable资源文件中的login_signup_background绑定到一起
        @BindDrawable(R.drawable.login_signup_background)
        Drawable mBackground;
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
        
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_my);
            ButterKnife.bind(this);
    
        }
    }

#### 没有Activity的绑定（Non-Activity binding） ####

上面的例子我们都是在`Activity`中进行的绑定，`ButterKnife`也支持我们在任意对象中进行绑定，只要提供一个根`view`即可，比如：

public class FancyFragment extends Fragment {
        
      @BindView(R.id.button1) Button button1;
      @BindView(R.id.button2) Button button2;
    	
      @Override 
      public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        
        View view = inflater.inflate(R.layout.fancy_fragment, container, false);
        //提供了一个根视图：view，将this与视图view进行了绑定
        ButterKnife.bind(this, view);
        // TODO Use fields...
        return view;
      }
    }

或者我们也可以在`list`的`adapter`中对`view holder`进行绑定：

public class MyAdapter extends BaseAdapter {
        
      @Override 
      public View getView(int position, View view, ViewGroup parent) {
        
        ViewHolder holder;
        if (view != null) {
        
          holder = (ViewHolder) view.getTag();
        } else {
        
          view = inflater.inflate(R.layout.whatever, parent, false);
          holder = new ViewHolder(view);
          view.setTag(holder);
        }
    
        holder.name.setText("John Doe");
        // etc...
    
        return view;
      }
    
      static class ViewHolder {
        
        @BindView(R.id.title) TextView name;
        @BindView(R.id.job_title) TextView jobTitle;
    
        public ViewHolder(View view) {
        
          ButterKnife.bind(this, view);
        }
      }
    }

总之，`ButterKnife.bind`可以在任何可以调用`findViewById`的地方被调用，除此之外，`ButterKnife`还提供了一些其他的关于绑定的`API`：

1.  将`activity`作为根视图绑定任意对象，如果你使用类似`MVC`的项目架构，你可以使用`ButterKnife.bind(this, activity)`将`activity`绑定到其对应的`controller`
2.  使用`ButterKnife.bind（this）`将`View`的子`View`绑定到字段上。比如在`layout`中使用`<merge>`标记并在自定义`View`的构造函数中进行`inflate`，则可以在`inflate`之后立即调用`ButterKnife.bind（this）`。或者，从`XML`中`inflate`的自定义视图类型可以在`onFinishInflate（）`回调中使用ButterKnife.bind（this）。

#### 视图列表（View list） ####

你可以将一组`view`组合成一个列表或者数组，比如：

@BindViews({
         R.id.first_name, R.id.middle_name, R.id.last_name })
    List<EditText> nameViews;

`apply`方法允许您一次对列表中的所有视图执行操作：

ButterKnife.apply(nameViews, DISABLE);
    ButterKnife.apply(nameViews, ENABLED, false);

`Action`和`Setter`接口允许你进行简单的操作：

static final ButterKnife.Action<View> DISABLE = new ButterKnife.Action<View>() {
        
      @Override public void apply(View view, int index) {
        
        view.setEnabled(false);
      }
    };
    static final ButterKnife.Setter<View, Boolean> ENABLED = new ButterKnife.Setter<View, Boolean>() {
        
      @Override public void set(View view, Boolean value, int index) {
        
        view.setEnabled(value);
      }
    };

也可以在`apply`方法中使用`Android`的一些属性（`property`）：

ButterKnife.apply(nameViews, View.ALPHA, 0.0f);

#### 监听器绑定（Listenter binding） ####

可以使用如下方法自动地进行监听器的配置：

@OnClick(R.id.submit)
    public void submit(View view) {
        
      // TODO submit data to server...
    }

监听器中方法的参数都是可选的：

@OnClick(R.id.submit)
    public void submit() {
        
      // TODO submit data to server...
    }

定义一个特殊的类型，他会被自动转换（`cast`）：

@OnClick(R.id.submit)
    public void sayHi(Button button) {
        
      button.setText("Hello!");
    }

在单个绑定中可以指定多个`ID`以进行常见事件处理：

@OnClick({
         R.id.door1, R.id.door2, R.id.door3 })
    public void pickDoor(DoorView door) {
        
      if (door.hasPrizeBehind()) {
        
        Toast.makeText(this, "You win!", LENGTH_SHORT).show();
      } else {
        
        Toast.makeText(this, "Try again", LENGTH_SHORT).show();
      }
    }

自定义的`View`可以绑定到他们自己的监听器（不需要指定的id）：

public class FancyButton extends Button {
        
      @OnClick
      public void onClick() {
        
        // TODO do something!
      }
    }

#### 清除绑定（Binding reset） ####

`Fragment`比`activity`具有更多的生命周期，当在`Fragment`的`onCreateView（）`方法中进行绑定之后，应该在`onDestroyView（）`方法中将`veiw`的值设置为`null`，在`ButterKnife`中，当你调用`bind（）`方法时，`ButterKnife`会返回一个`Unbinder`对象，你可以在合适的生命周期的回调方法中调用`Unbinder.unbind（）`以进行视图的重设，比如：

public class FancyFragment extends Fragment {
        
      @BindView(R.id.button1) Button button1;
      @BindView(R.id.button2) Button button2;
      private Unbinder unbinder;
    
      @Override 
      public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        
        View view = inflater.inflate(R.layout.fancy_fragment, container, false);
        unbinder = ButterKnife.bind(this, view);
        // TODO Use fields...
        return view;
      }
    
      @Override 
      public void onDestroyView() {
        
        super.onDestroyView();
        unbinder.unbind();
      }
    }

#### 可选绑定（Optional binding） ####

默认情况下，`@Bind`以及监听器绑定都是需要的，当找不到目标`view`的时候，`ButterKnife`将会抛出一个异常，为了避免这种情况的发生，也为了创建一个可选的绑定，可以为字段添加一个`@Nullable`注解或者为方法添加一个`@Optional`注解：

@Nullable @BindView(R.id.might_not_be_there) TextView mightNotBeThere;
    
    @Optional @OnClick(R.id.maybe_missing) void onMaybeMissingClicked() {
        
      // TODO ...
    }

注意，推荐使用[`Android's "support-annotations" library`][Android_s _support-annotations_ library]中的`@Nullable`。

#### 多方法的监听器（Multil-method listenter） ####

对应监听器有多个回调方法的注解可以绑定到这多个回调方法中的任意一个，每个注解都有一个绑定的默认回调，使用`callback`参数指定备用项：

@OnItemSelected(R.id.list_view)
    void onItemSelected(int position) {
        
      // TODO ...
    }
    
    @OnItemSelected(value = R.id.maybe_missing, callback = NOTHING_SELECTED)
    void onNothingSelected() {
        
      // TODO ...
    }

### 源码分析 ###

按照官方的说法，`ButterKnife`的代码分为两部分，一部分是编译期间会被执行的，核心代码是`ButterKnifeProcessor`类中的代码，另一部分是在运行期间会被执行的，主要涉及`ButterKnife`类中的代码，整个业务逻辑如下图所示：

![ButterKnife整体流程示意图][ButterKnife]

接下来我将以上图为基础，从源码角度详细地分析`ButterKnife`的实现。

#### 编译期间 ####

在现阶段的`Android`开发中，注解按照被处理时期的不同，分为两种类型，一种是运行时注解，另一种是编译时注解，运行时注解由于性能问题被一些人所诟病。编译时注解的核心依赖`APT(Annotation Processing Tools)`实现，原理是在某些代码元素上（如类型、函数、字段等）添加注解，在编译时编译器会检查`AbstractProcessor`的子类，并且调用该类型的`process`函数，然后将添加了注解的所有元素都传递到`process`方法中，使得开发人员可以在编译器进行相应的处理，我们这里所要分析的`ButterKnife`也不例外，其是利用`Java API`提供的扫描源码并解析注解的框架AbstractProcessor，自定义继承自`AbstractProcessor`类的`ButterKnifeProcessor`类来实现自己解析注解并生成相关代码的逻辑，我们现在就来看一下`ButterKnifeProcessor`的核心源码即`ButterKnifeProcessor.process()`方法，这个方法会在编译期间被`Java api`调用，并且传入所有添加了注解的元素：

public final class ButterKnifeProcessor extends AbstractProcessor {
        
      	...
          
    	  @Override 
        public boolean process(Set<? extends TypeElement> elements, RoundEnvironment env) {
        
            Map<TypeElement, BindingSet> bindingMap = findAndParseTargets(env);
    
            for (Map.Entry<TypeElement, BindingSet> entry : bindingMap.entrySet()) {
        
              TypeElement typeElement = entry.getKey();
              BindingSet binding = entry.getValue();
    
              JavaFile javaFile = binding.brewJava(sdk, debuggable);
              try {
        
                javaFile.writeTo(filer);
              } catch (IOException e) {
        
                error(typeElement, "Unable to write binding for type %s: %s", typeElement, e.getMessage());
              }
            }
    
            return false;
          }
      	...
    }

可以发现，首先调用了`findAndParseTargets(env)`，我们深入其源码分析一下（这部分源码较多，我将重要步骤都写在注释中）：

public final class ButterKnifeProcessor extends AbstractProcessor {
        
      	...
     
        private Map<TypeElement, BindingSet> findAndParseTargets(RoundEnvironment env) {
        
    
          //定义一个Map    
          Map<TypeElement, BindingSet.Builder> builderMap = new LinkedHashMap<>();
          //定义一个Set
          Set<TypeElement> erasedTargetNames = new LinkedHashSet<>();
    
          // 遍历所有被@BindAnim注解修饰的元素
          for (Element element : env.getElementsAnnotatedWith(BindAnim.class)) {
        
            //判断元素是否合法，SuperficialValidation.validateElement(element)是谷歌提高的api
            if (!SuperficialValidation.validateElement(element)) continue;
            try {
        
              //解析Animation类型（被@BindAnim注解修饰）的元素
              parseResourceAnimation(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindAnim.class, e);
            }
          }
    
          // 遍历所有被@BindArray注解修饰的元素
          for (Element element : env.getElementsAnnotatedWith(BindArray.class)) {
        
            //判断元素是否合法，SuperficialValidation.validateElement(element)是谷歌提高的api
            if (!SuperficialValidation.validateElement(element)) continue;
            try {
        
              //解析BindArray类型（被@BindArray注解修饰）的元素
              parseResourceArray(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindArray.class, e);
            }
          }
    
          // 遍历被@BindBitmap 注解修饰的元素
          for (Element element : env.getElementsAnnotatedWith(BindBitmap.class)) {
        
            //逻辑同上，不再赘述
            if (!SuperficialValidation.validateElement(element)) continue;
            try {
        
              parseResourceBitmap(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindBitmap.class, e);
            }
          }
    
          // 遍历被@BindBool注解修饰的元素
          for (Element element : env.getElementsAnnotatedWith(BindBool.class)) {
        
            //逻辑同上，不再赘述
            if (!SuperficialValidation.validateElement(element)) continue;
            try {
        
              parseResourceBool(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindBool.class, e);
            }
          }
    
          // 遍历被@BindColor注解修饰的元素 
          for (Element element : env.getElementsAnnotatedWith(BindColor.class)) {
        
            if (!SuperficialValidation.validateElement(element)) continue;
            try {
        
              parseResourceColor(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindColor.class, e);
            }
          }
    
          // 遍历被@BindDimen注解修饰的元素
          for (Element element : env.getElementsAnnotatedWith(BindDimen.class)) {
        
            if (!SuperficialValidation.validateElement(element)) continue;
            try {
        
              parseResourceDimen(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindDimen.class, e);
            }
          }
    
          //遍历被@BindDrawable注解修饰的元素 
          for (Element element : env.getElementsAnnotatedWith(BindDrawable.class)) {
        
            if (!SuperficialValidation.validateElement(element)) continue;
            try {
        
              parseResourceDrawable(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindDrawable.class, e);
            }
          }
    
          //遍历被@BindFloat注解修饰的元素  
          for (Element element : env.getElementsAnnotatedWith(BindFloat.class)) {
        
            //逻辑同上，不再赘述
            if (!SuperficialValidation.validateElement(element)) continue;
            try {
        
              parseResourceFloat(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindFloat.class, e);
            }
          }
    
          // 遍历被@BindFont注解修饰的元素  
          for (Element element : env.getElementsAnnotatedWith(BindFont.class)) {
        
            if (!SuperficialValidation.validateElement(element)) continue;
            try {
        
              parseResourceFont(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindFont.class, e);
            }
          }
    
          // 遍历被@BindInt注解修饰的元素  
          for (Element element : env.getElementsAnnotatedWith(BindInt.class)) {
        
            if (!SuperficialValidation.validateElement(element)) continue;
            //逻辑同上，不再赘述
            try {
        
              parseResourceInt(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindInt.class, e);
            }
          }
    
          // 遍历被@BindString注解修饰的元素 
          for (Element element : env.getElementsAnnotatedWith(BindString.class)) {
        
            if (!SuperficialValidation.validateElement(element)) continue;
            try {
        
              parseResourceString(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindString.class, e);
            }
          }
    
          // 遍历被@BindView注解修饰的元素
          for (Element element : env.getElementsAnnotatedWith(BindView.class)) {
        
            // 这里没有使用SuperficialValidation.validateElement(element)对元素的合法性进行验证所以之后的处理逻辑可能生成不能解析的View
            try {
        
              parseBindView(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindView.class, e);
            }
          }
    
          // 遍历被@BindFloat注解修饰的元素  Process each @BindViews element.
          for (Element element : env.getElementsAnnotatedWith(BindViews.class)) {
        
            // 这里没有使用SuperficialValidation.validateElement(element)对元素的合法性进行验证所以之后的处理逻辑可能生成不能解析的View
            try {
        
              parseBindViews(element, builderMap, erasedTargetNames);
            } catch (Exception e) {
        
              logParsingError(element, BindViews.class, e);
            }
          }
    
          /**
          LISTENERS的声明如下：
          private static final List<Class<? extends Annotation>> LISTENERS = Arrays.asList(//
          OnCheckedChanged.class, //
          OnClick.class, //
          OnEditorAction.class, //
          OnFocusChange.class, //
          OnItemClick.class, //
          OnItemLongClick.class, //
          OnItemSelected.class, //
          OnLongClick.class, //
          OnPageChange.class, //
          OnTextChanged.class, //
          OnTouch.class //
      );
          */
          for (Class<? extends Annotation> listener : LISTENERS) {
        
            findAndParseListener(env, listener, builderMap, erasedTargetNames);
          }
    
          // 将父类binder与其子类binder关联起来，这是一个基于队列的树遍历，它从根（超类）开始，然后遍历叶子（子类）。
          //将上面的builderMap中的键值对转化到一个队列中
          Deque<Map.Entry<TypeElement, BindingSet.Builder>> entries =
              new ArrayDeque<>(builderMap.entrySet());
          //声明一个Map
          Map<TypeElement, BindingSet> bindingMap = new LinkedHashMap<>();
          //遍历
          while (!entries.isEmpty()) {
        
            //将队首元素取出并删除，得到当前entry(键值对)
            Map.Entry<TypeElement, BindingSet.Builder> entry = entries.removeFirst();
    				//取得当前键值对的键(TypeElement)
            TypeElement type = entry.getKey();
            //取得当前键值对的值(BindingSet.Builder)
            BindingSet.Builder builder = entry.getValue();
    				//寻找当前type的父类
            TypeElement parentType = findParentType(type, erasedTargetNames);
            if (parentType == null) {
        
              //如果当前type的父类为null，即说明当前type类为树的根节点，直接加入到bindingMap中即可
              bindingMap.put(type, builder.build());
            } else {
        
              //尝试从bindingMap中取以parentType为键的值
              BindingSet parentBinding = bindingMap.get(parentType);
              
              if (parentBinding != null) {
        
                //如果取到的值不为null，说明当前type的父类已经被加入到map里面过，也说明parentType类已经是树的根节点了
                
                //将builder的根节点设置为parentBinding
                builder.setParent(parentBinding);
                //将type，builder.build()加入bindingMap
                bindingMap.put(type, builder.build());
              } else {
        
                // Has a superclass binding but we haven't built it yet. Re-enqueue for later.
                //如果取到的值为null，说明当前type的父类没有被加入到过map里面，也说明parentType类不是是树的根节点，所以将entry加入到队列的尾端，等待后面进行处理
                entries.addLast(entry);
              }
            }
          }
    		//将bindingMap返回
          return bindingMap;
      }
    
        ...
    }

可以看到，这里针对不同的注解类型执行了很多形如parseXX（）的方法，作用都是解析特定类型的注解元素，由于篇幅原因这里以`parseBindView（）`为例进行分析：

public final class ButterKnifeProcessor extends AbstractProcessor {
        
      	...
    
        /**
         * @param element：被解析的当前元素(被@BindView修饰的元素)
         * @param builderMap：一个Map
         * @param erasedTargetNames：一个Set
         */
        private void parseBindView(Element element, Map<TypeElement, BindingSet.Builder> builderMap,Set<TypeElement> erasedTargetNames) {
        
          /**
          element.getEnclosingElement()返回包含element的父element，例如像下面这段代码：
    
              package com.lu.aptdemo;
              import com.lu.annotation.AAAAA;
              @AAAAA("this is a class")
              public class Test<T> {
                @AAAAA("this is a field")
                String hello;
                @AAAAA("this is a method")
                public String say(@AAAAA("this is a parameter") String arg1) {
                    return "hello world";
                }
              }
           则有：
           "Test.getEnclosingElement(): aptdemo";
           "hello.getEnclosingElement(): Test";
           "say.getEnclosingElement(): Test";
           "arg1.getEnclosingElement(): say";
    
          */
          TypeElement enclosingElement = (TypeElement) element.getEnclosingElement();
    
          // 对element做合法性验证
          boolean hasError = isInaccessibleViaGeneratedCode(BindView.class, "fields", element)
              || isBindingInWrongPackage(BindView.class, element);
    
          // element.asType()返回的是element的类型信息，包括包名，类(或方法，或参数)名/类
          TypeMirror elementType = element.asType();
          //elementType.getKind()返回element的类型，TypeKind.TYPEVAR表示泛型，即判断当前element元素是否是泛型类型的
          if (elementType.getKind() == TypeKind.TYPEVAR) {
        
            TypeVariable typeVariable = (TypeVariable) elementType;
            //获取此类型变量的上边界
            elementType = typeVariable.getUpperBound();
          }
          //包含完整的包名路径
          Name qualifiedName = enclosingElement.getQualifiedName();
          //获取名字，不带包名
          Name simpleName = element.getSimpleName();
    
          if (!isSubtypeOfType(elementType, VIEW_TYPE) && !isInterface(elementType)) {
        
            //如果当前element不是View的子类且当前element不是一个接口类
            if (elementType.getKind() == TypeKind.ERROR) {
        
              //如果当前element是Error类
              note(element, "@%s field with unresolved type (%s) "
                      + "must elsewhere be generated as a View or interface. (%s.%s)",
                  BindView.class.getSimpleName(), elementType, qualifiedName, simpleName);
            } else {
        
              //否则返回(通过设置 hasError = true)
              error(element, "@%s fields must extend from View or be an interface. (%s.%s)",
                  BindView.class.getSimpleName(), qualifiedName, simpleName);
              hasError = true;
            }
          }
    
    
          if (hasError) {
        
            //返回
            return;
          }
    
          // 获取该element上的@BindView注解中给定的值
          int id = element.getAnnotation(BindView.class).value();
          //尝试从builderMap中获取以enclosingElement（当前element的父元素）为键的值
          BindingSet.Builder builder = builderMap.get(enclosingElement);
          //根据当前element以及给定的值获取resourceId
          Id resourceId = elementToId(element, BindView.class, id);
          if (builder != null) {
        
            //map中获取的值不为null
    
            //从BindingSet.Builder中的缓存map中查找是否已经存在以resourceId为键的值
            String existingBindingName = builder.findExistingBindingName(resourceId);
            if (existingBindingName != null) {
        
              //已经存在，返回
              error(element, "Attempt to use @%s for an already bound ID %d on '%s'. (%s.%s)",
                  BindView.class.getSimpleName(), id, existingBindingName,
                  enclosingElement.getQualifiedName(), element.getSimpleName());
              return;
            }
          } else {
        
            //从builderMap中获取（如果存在）或者创建一个builder(如果是创建了一个builder，将这个builder也要put进builderMap中)
            builder = getOrCreateBindingBuilder(builderMap, enclosingElement);
          }
    
          String name = simpleName.toString();
          TypeName type = TypeName.get(elementType);
          boolean required = isFieldRequired(element);
          //完善builder的信息
          builder.addField(resourceId, new FieldViewBinding(name, type, required));
    
          // 将当前元素的父element添加到erasedTargetNames这个集合中
          erasedTargetNames.add(enclosingElement);
        }
    
        private BindingSet.Builder getOrCreateBindingBuilder(
              Map<TypeElement, BindingSet.Builder> builderMap, TypeElement enclosingElement) {
        
            //尝试从builderMap中获取
            BindingSet.Builder builder = builderMap.get(enclosingElement);
            if (builder == null) {
        
              //如果获取到的为null，进行创建
              builder = BindingSet.newBuilder(enclosingElement);
              //将创建的builder 放进builderMap中
              builderMap.put(enclosingElement, builder);
            }
            return builder;
          }
    		....
    }

这里我单独将`BindingSet.newBuilder(enclosingElement)`方法拎出来分析一下：

final class BindingSet {
        
    	......
    	static Builder newBuilder(TypeElement enclosingElement) {
        
        TypeMirror typeMirror = enclosingElement.asType();
    
        boolean isView = isSubtypeOfType(typeMirror, VIEW_TYPE);
        boolean isActivity = isSubtypeOfType(typeMirror, ACTIVITY_TYPE);
        boolean isDialog = isSubtypeOfType(typeMirror, DIALOG_TYPE);
    
        TypeName targetType = TypeName.get(typeMirror);
        if (targetType instanceof ParameterizedTypeName) {
        
          targetType = ((ParameterizedTypeName) targetType).rawType;
        }
    
        String packageName = getPackage(enclosingElement).getQualifiedName().toString();
        String className = enclosingElement.getQualifiedName().toString().substring(
            packageName.length() + 1).replace('.', '$');
        //这里将bindingClassName设为className + "_ViewBinding"，所以后面在运行期间也应该到className + "_ViewBinding"这个文件中取读取生成的代码
        ClassName bindingClassName = ClassName.get(packageName, className + "_ViewBinding");
    
        boolean isFinal = enclosingElement.getModifiers().contains(Modifier.FINAL);
        return new Builder(targetType, bindingClassName, isFinal, isView, isActivity, isDialog);
      }
    	......	
    }

重点是知道`bindingClassName`最后被设置为了`className + "_ViewBinding"`。

继续看`ButterKnifeProcessor.process()`的源码：

public final class ButterKnifeProcessor extends AbstractProcessor {
        
      	...
          
    	  @Override 
        public boolean process(Set<? extends TypeElement> elements, RoundEnvironment env) {
        
            Map<TypeElement, BindingSet> bindingMap = findAndParseTargets(env);
    				//遍历bindingMap
            for (Map.Entry<TypeElement, BindingSet> entry : bindingMap.entrySet()) {
        
              TypeElement typeElement = entry.getKey();//键
              BindingSet binding = entry.getValue();//值
    					
              JavaFile javaFile = binding.brewJava(sdk, debuggable);
              try {
        
                javaFile.writeTo(filer);
              } catch (IOException e) {
        
                error(typeElement, "Unable to write binding for type %s: %s", typeElement, e.getMessage());
              }
            }
    
            return false;
          }
      	...
    }

`brewJava（）`方法方法主要是对`javapoet`做一系列配置，方便下一步进行代码生成：

JavaFile brewJava(int sdk, boolean debuggable) {
        
    		//调用createType(int sdk, boolean debuggable) 生成类配置
        TypeSpec bindingConfiguration = createType(sdk, debuggable);
        return JavaFile.builder(
        bindingClassName.packageName(), //设置包名
        bindingConfiguration)
            .addFileComment("Generated code from Butter Knife. Do not modify!")
            .build();
      }
    private TypeSpec createType(int sdk, boolean debuggable) {
        
      //设置类名为bindingClassName.simpleName()即className + "_ViewBinding"(在上面分析BindingSet.newBuilder()的时候分析过bindingClassName的值)
        TypeSpec.Builder result = TypeSpec.classBuilder(bindingClassName.simpleName())
            .addModifiers(PUBLIC);
        if (isFinal) {
        
          result.addModifiers(FINAL);
        }
    
    
        if (parentBinding != null) {
        
          result.superclass(parentBinding.bindingClassName);
        } else {
        
          result.addSuperinterface(UNBINDER);
        }
    		//其他对于方法、字段的配置，主要是javapoet的使用，不是本文的重点，这里不展开讲解
    }

主要逻辑是借助`javapoet`库实现了代码的生成，详细配置信息都在`createType()`方法中，由于本文重点不是`javapoet`，所以这里不展开赘述，大家只要明确，`createType()`方法的作用是根据当前元素的信息将`ButterKnife`注解翻译成`java`代码（生成一些类似`findViewById`的代码），将这些`java`代码集成到`className + "_ViewBinding"`这个类中，以便运行时通过反射查找到生成的代码。

执行完`JavaFile javaFile = binding.brewJava(sdk, debuggable)`之后执行了`javaFile.writeTo(filer)`即将生成的代码写为了文件形式，至此，编译期间的代码生成工作已经完成。

#### 运行期间 ####

我们发现，不管是为字段添加绑定还是为方法添加绑定，我们一定要调用`ButterKnife.bind()`方法才能在运行期间让绑定生效，这个方法有多种重载形式：

public static Unbinder bind(@NonNull Activity target) 
    public static Unbinder bind(@NonNull View target)
    public static Unbinder bind(@NonNull Dialog target)
    public static Unbinder bind(@NonNull Object target, @NonNull Activity source)
    public static Unbinder bind(@NonNull Object target, @NonNull Dialog source)
    public static Unbinder bind(@NonNull Object target, @NonNull View source)

一一分析一下源码：

`bind(@NonNull Activity target)` ：

@NonNull
    @UiThread
    public static Unbinder bind(@NonNull Activity target) {
        
      	//获取目标Activity的根View
        View sourceView = target.getWindow().getDecorView();
      	//调用bind(@NonNull Object target, @NonNull View source)
        return bind(target, sourceView);
    }

可以发现最后调用了：