ButterKnife原理分析(一)設計思想

用過ButterKnife的同學都知道,它可以方便我們用注解的方式來省去每次用findViewById去獲取View對象等。而其實它的原理也是很簡單的,就是在調用ButterKnife.bind(Object obj, View view)方法時,創建一個對象,這個對象構造方法里面會調用參數view的findViewById來賦值給obj中你注解過的字段(通常是各種View),也就是說ButterKnife把本來我們在自己要顯式實現的findViewById等方法,放到了它自己的一個對象里去實現了。現在我們一步步來實現它的設計思路。

未優化的獲取View實現方式

首先是我們原始的獲取View的方式。

public class TestActivity extends Activity{

  TextView text1;

  @Override protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_test);

    //獲取text1對象
    text1 = (TextView)findViewById(R.id.text1);
    text1.setText("我是測試Text 1");

    //設置btn_1的點擊和長按事件
    Button btn_1 = (Button) findViewById(R.id.btn_1);
    btn_1.setOnClickListener(new View.OnClickListener() {
      @Override public void onClick(View v) {
        Toast.makeText(getApplicationContext(), "點擊btn_1", Toast.LENGTH_SHORT).show();
      }
    });
    btn_1.setOnLongClickListener(new View.OnLongClickListener() {
      @Override public boolean onLongClick(View v) {
        Toast.makeText(getApplicationContext(), "長按btn_1", Toast.LENGTH_SHORT).show();
        return false;
      }
    });

    //設置btn_2的點擊和長按事件
    Button btn_2 = (Button) findViewById(R.id.btn_2);
    btn_2.setOnClickListener(new View.OnClickListener() {
      @Override public void onClick(View v) {
        Toast.makeText(getApplicationContext(), "點擊btn_2", Toast.LENGTH_SHORT).show();
      }
    });
    btn_2.setOnLongClickListener(new View.OnLongClickListener() {
      @Override public boolean onLongClick(View v) {
        Toast.makeText(getApplicationContext(), "長按btn_2", Toast.LENGTH_SHORT).show();
        return false;
      }
    });
  }

}

這是我們最初的編寫方式,簡單直接,我們會想是否能稍微優化一下,是它變得更整潔,于是有了下面的改動。

簡單優化的獲取View實現方式

public class TestActivity extends Activity{

  TextView text1;

  @Override protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_test);

    new TestActivity_ViewBind(this, getWindow().getDecorView());
  }
  
  public void onClick(View view) {
    switch (view.getId()) {
      case R.id.btn_1:

        Toast.makeText(this, "點擊btn_1", Toast.LENGTH_SHORT).show();

        break;
      case R.id.btn_2:

        Toast.makeText(this, "點擊btn_2", Toast.LENGTH_SHORT).show();

        break;
      default:
        break;
    }
  }
  
  public boolean onLongClick(View view) {
    switch (view.getId()) {
      case R.id.btn_1:

        Toast.makeText(this, "長按btn_1", Toast.LENGTH_SHORT).show();

        return true;
      case R.id.btn_2:

        Toast.makeText(this, "長按btn_2", Toast.LENGTH_SHORT).show();

        return true;
      default:
        break;
    }
    return false;
  }

}

public class TestActivity_ViewBind{
    public TestActivity_ViewBind(final TestActivity activity, final View view){

      //獲取text1對象
      activity.text1 = (TextView) view.findViewById(R.id.text1);

      //設置btn_1的點擊和長按事件
      Button btn_1 = (Button) view.findViewById(R.id.btn_1);
      btn_1.setOnClickListener(new View.OnClickListener() {
        @Override public void onClick(View v) {

          activity.onClick(v);

        }
      });
      btn_1.setOnLongClickListener(new View.OnLongClickListener() {
        @Override public boolean onLongClick(View v) {

          activity.onLongClick(v);

          return false;
        }
      });

      //設置btn_2的點擊和長按事件
      Button btn_2 = (Button) view.findViewById(R.id.btn_2);
      btn_2.setOnClickListener(new View.OnClickListener() {
        @Override public void onClick(View v) {

          activity.onClick(v);

        }
      });
      btn_2.setOnLongClickListener(new View.OnLongClickListener() {
        @Override public boolean onLongClick(View v) {

          activity.onLongClick(v);

          return false;
        }
      });
    }
}

看上面,我們把獲取text1和給btn_1,btn_2設置點擊長按事件等操作獨立出來,引出一個TestActivity_ViewBind類負責幫TestActivity做初始化。通過findViewById獲取到text1后賦值給TestActivity對象的text1,同時btn_1,btn_2也是通過findViewById獲取到,然后給它們設置點擊和長按事件,在onClick或onLongClick回調時再去調用TestActivity的onClick或onLongClick方法。這樣TestActivity看起來是不是精簡了不少?但是這樣我們發現還有個問題,就是TestActivity_ViewBind還是得我們自己寫,寫TestActivity_ViewBind這個類比之前正常寫法的工作量反而更大了,除了把部分任務獨立出來之外,好像并沒有什么用處。因此ButterKnife就想到了TestActivity_ViewBind這個類不用我們自己編寫,我給你在編譯時動態創建,而你所要做的就是在之前的TestActivity中加點注解,告訴ButterKnife要給你做什么初始化。

ButterKnife優化的獲取View實現方式

下面就是使用ButterKnife之后的代碼

public class TestActivity extends Activity{

  //加上@BindView注解,內容為text1對應的id(R.id.text1)
  @BindView(R.id.text1) TextView text1;

  @Override protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_test);

    ButterKnife.bind(this);

    text1.setText("我是測試Text 1");

  }

  //加上@OnClick注解,作為點擊事件的回調標記,內容為btn_1和btn_2的id(R.id.btn_1和R.id.btn_2)
  @OnClick({ R.id.btn_1, R.id.btn_2 }) public void onClick(View view) {
    switch (view.getId()) {
      case R.id.btn_1:

        Toast.makeText(this, "點擊btn_1", Toast.LENGTH_SHORT).show();

        break;
      case R.id.btn_2:

        Toast.makeText(this, "點擊btn_2", Toast.LENGTH_SHORT).show();

        break;
      default:
        break;
    }
  }

  //加上OnLongClick注解,作為長按事件的回調標記,內容為btn_1和btn_2的id(R.id.btn_1和R.id.btn_2)
  @OnLongClick({ R.id.btn_1, R.id.btn_2 }) public boolean onLongClick(View view) {
    switch (view.getId()) {
      case R.id.btn_1:

        Toast.makeText(this, "長按btn_1", Toast.LENGTH_SHORT).show();

        return true;
      case R.id.btn_2:

        Toast.makeText(this, "長按btn_2", Toast.LENGTH_SHORT).show();

        return true;
      default:
        break;
    }
    return false;
  }

}

可以看到@BindView(R.id.text1)這個注解,可以標記要findViewById的是R.id.text1這個id,創建之后的對象是賦給text1。@OnClick({ R.id.btn_1, R.id.btn_2 })這個注解,標記的是當發生R.id.btn_1或者R.id.btn_2的點擊事件時回調我標記的這個方法,因此方法名可以是任意的,并不一定是onClick,重要的是看加了什么注解。你可能會想知道幫我生成的這個TestActivity_ViewBind是在哪里了。它的實現是在當前項目模塊(如app)的build目錄下的,具體是

app\build\generated\source\apt\debug\(包名)\TestActivity_ViewBinding.java

我們進去看看它的實現

public class TestActivity_ViewBinding<T extends TestActivity> implements Unbinder {
  protected T target;

  private View view2131558538;

  private View view2131558539;

  @UiThread
  public TestActivity_ViewBinding(final T target, View source) {
    this.target = target;

    View view;
    target.text1 = Utils.findRequiredViewAsType(source, R.id.text1, "field 'text1'", TextView.class);
    view = Utils.findRequiredView(source, R.id.btn_1, "method 'onClick' and method 'onLongClick'");
    view2131558538 = view;
    view.setOnClickListener(new DebouncingOnClickListener() {
      @Override
      public void doClick(View p0) {
        target.onClick(p0);
      }
    });
    view.setOnLongClickListener(new View.OnLongClickListener() {
      @Override
      public boolean onLongClick(View p0) {
        return target.onLongClick(p0);
      }
    });
    view = Utils.findRequiredView(source, R.id.btn_2, "method 'onClick' and method 'onLongClick'");
    view2131558539 = view;
    view.setOnClickListener(new DebouncingOnClickListener() {
      @Override
      public void doClick(View p0) {
        target.onClick(p0);
      }
    });
    view.setOnLongClickListener(new View.OnLongClickListener() {
      @Override
      public boolean onLongClick(View p0) {
        return target.onLongClick(p0);
      }
    });
  }

  @Override
  @CallSuper
  public void unbind() {
    T target = this.target;
    if (target == null) throw new IllegalStateException("Bindings already cleared.");

    target.text1 = null;

    view2131558538.setOnClickListener(null);
    view2131558538.setOnLongClickListener(null);
    view2131558538 = null;
    view2131558539.setOnClickListener(null);
    view2131558539.setOnLongClickListener(null);
    view2131558539 = null;

    this.target = null;
  }
}

看了之后有沒有覺得和我上面寫的TestActivity_ViewBind好像,實現方式是差不多的,當然這些都是動態生成的,不需要我們編寫,感覺解放了雙手啊,而且ButterKnife還更貼心的做了unbind這個釋放引用的實現,防止可能TestActivity_ViewBinding對象沒有被銷毀時,一直持有引用,導致TestActivity內存泄漏的問題。接下來我們分析ButterKnife.bind(this);是怎么實現綁定的

ButterKnife綁定流程

ButterKnife有幾個bind方法,分別對應的是Activity,View,Dialog,Object,也就是說,它能夠給Activity,View,Dialog,Object這些對象中的屬性進行賦值,初始化等操作。

public final class ButterKnife {
  @NonNull @UiThread
  public static Unbinder bind(@NonNull Activity target) {
    View sourceView = target.getWindow().getDecorView();
    return createBinding(target, sourceView);
  }

  @NonNull @UiThread
  public static Unbinder bind(@NonNull View target) {
    return createBinding(target, target);
  }

  @NonNull @UiThread
  public static Unbinder bind(@NonNull Dialog target) {
    View sourceView = target.getWindow().getDecorView();
    return createBinding(target, sourceView);
  }

  @NonNull @UiThread
  public static Unbinder bind(@NonNull Object target, @NonNull Activity source) {
    View sourceView = source.getWindow().getDecorView();
    return createBinding(target, sourceView);
  }

  @NonNull @UiThread
  public static Unbinder bind(@NonNull Object target, @NonNull View source) {
    return createBinding(target, source);
  }

  @NonNull @UiThread
  public static Unbinder bind(@NonNull Object target, @NonNull Dialog source) {
    View sourceView = source.getWindow().getDecorView();
    return createBinding(target, sourceView);
  }

}

可以它們最終都是調用到createBinding(target, sourceView); 也就是說,必須要找到一個View對象,才能在后續的處理中對target的內容進行操作。

public final class ButterKnife {
  private static Unbinder createBinding(@NonNull Object target, @NonNull View source) {
    //找到target所屬的類Class對象,例如TestActivity.class
    Class<?> targetClass = target.getClass();
    if (debug) Log.d(TAG, "Looking up binding for " + targetClass.getName());
    //找到target對應的bind的Class對象的構造器,例如TestActivity_ViewBinding這個類的構造器
    Constructor<? extends Unbinder> constructor = findBindingConstructorForClass(targetClass);

    if (constructor == null) {
      return Unbinder.EMPTY;
    }

    //noinspection TryWithIdenticalCatches Resolves to API 19+ only type.
    try {
      //創建ViewBinding的對象了,例如創建TestActivity_ViewBinding這個對象,調用構造方法
      return constructor.newInstance(target, source);
    } catch (IllegalAccessException e) {
      throw new RuntimeException("Unable to invoke " + constructor, e);
    } catch (InstantiationException e) {
      throw new RuntimeException("Unable to invoke " + constructor, e);
    } catch (InvocationTargetException e) {
      Throwable cause = e.getCause();
      if (cause instanceof RuntimeException) {
        throw (RuntimeException) cause;
      }
      if (cause instanceof Error) {
        throw (Error) cause;
      }
      throw new RuntimeException("Unable to create binding instance.", cause);
    }
  }
  
  @Nullable @CheckResult @UiThread
  private static Constructor<? extends Unbinder> findBindingConstructorForClass(Class<?> cls) {
    //從map中獲取ViewBinding的構造器,避免每次通過反射獲取,算是優化
    Constructor<? extends Unbinder> bindingCtor = BINDINGS.get(cls);
    if (bindingCtor != null) {
      if (debug) Log.d(TAG, "HIT: Cached in binding map.");
      return bindingCtor;
    }
    String clsName = cls.getName();
    //忽略android.和java.包名開頭的類
    if (clsName.startsWith("android.") || clsName.startsWith("java.")) {
      if (debug) Log.d(TAG, "MISS: Reached framework class. Abandoning search.");
      return null;
    }
    
    try {
      //看這里,查找target類對應的ViewBinding類型
      Class<?> bindingClass = Class.forName(clsName + "_ViewBinding");
      //noinspection unchecked
      //獲取構造器
      bindingCtor = (Constructor<? extends Unbinder>) bindingClass.getConstructor(cls, View.class);
      if (debug) Log.d(TAG, "HIT: Loaded binding class and constructor.");
    } catch (ClassNotFoundException e) {
      if (debug) Log.d(TAG, "Not found. Trying superclass " + cls.getSuperclass().getName());
      //如果當前類沒找到,回溯到父類繼續查找
      bindingCtor = findBindingConstructorForClass(cls.getSuperclass());
    } catch (NoSuchMethodException e) {
      throw new RuntimeException("Unable to find binding constructor for " + clsName, e);
    }
    
    //把構造器緩存到map
    BINDINGS.put(cls, bindingCtor);
    return bindingCtor;
  }
  
  
  @VisibleForTesting
  static final Map<Class<?>, Constructor<? extends Unbinder>> BINDINGS = new LinkedHashMap<>();

}

可以發現,其實原理也很簡單,就是獲取target所屬的類,比如說是一個HomeFragment對象的話,就是獲取HomeFragment這個類對象,然后去查找HomeFragment_ViewBinding這個類,如果找到了就反射創建它的構造器,并緩存起來,避免每次去查找了,如果沒找到,找它的父類看有沒有對應的ViewBinding類。有了構造器,就可以反射創建HomeFragment_ViewBinding這個對象了,也就會調用它的構造方法,而構造方法里就是做了哪些初始化設置操作,這樣整個流程就走通了。

ButterKnife功能

  • 除了@BindView和@OnClick,@OnLongClick注解之外,ButterKnife還提供了@OnItemClick,@OnItemLongClick,@OnTouch等注解
  • ButterKnife提供了findById方法,讓我們不用強制類型轉換,它的實現方式是通過泛型實現的
//不用類型轉換
TextView text2 = ButterKnife.findById(this, R.id.text2);

public final class ButterKnife {
  //泛型實現
  public static <T extends View> T findById(@NonNull Activity activity, @IdRes int id) {
    return (T) activity.findViewById(id);
  }
}

  • ButterKnife提供了apply方法,來做一些通用化的設置。例如
List<TextView> viewList = new ArrayList<>();
viewList.add(text1);
viewList.add(text2);
ButterKnife.apply(viewList, new ButterKnife.Action<TextView>() {
  @Override public void apply(@NonNull TextView view, int index) {
    view.setBackgroundDrawable(new ColorDrawable(ContextCompat.getColor(getBaseContext(), android.R.color.darker_gray)));
  }
});

可以對viewList中的TextView進行統一的操作,這里是給它們統一設置背景等。而原理也很簡單,就是簡單的回調而已,所以并沒什么稀奇的。

public final class ButterKnife {
  @UiThread
  public static <T extends View> void apply(@NonNull List<T> list,
      @NonNull Action<? super T> action) {
    //遍歷list,調用action.apply
    for (int i = 0, count = list.size(); i < count; i++) {
      action.apply(list.get(i), i);
    }
  }
}

ButterKnife總結

ButterKnife最大的作用就是方便我們用注解的方式,省去了findViewById操作,還有各種setOnXXXListener操作,是代碼看起來更簡潔,而它的設計思想就是獨立出來一個類負責這些初始化操作,然后又通過注解及注解生成的方式實現它們之間的解耦,只需要調用 ButterKnife.bind(this);,本類壓根不知道誰幫它做了初始化操作的。實現原理其實也很簡單,也不簡單。簡單的是,它給你編譯生成了Bind類,然后查找創建對象,就完成了初始化操作。不簡單的是這個Bind類是怎么生成的,為什么不同注解會有不一樣的內容,下一篇中我們繼續分析。

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,247評論 6 543
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,520評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,362評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,805評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,541評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,896評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,887評論 3 447
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,062評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,608評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,356評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,555評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,077評論 5 364
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,769評論 3 349
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,175評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,489評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,289評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,516評論 2 379

推薦閱讀更多精彩內容