Android ButterKnife注入架構

標籤：

常常聽到這麼一個口號，叫做“努力做個愛偷懶的程式猿”。顯然，Android ButterKnife也在一定程度上協助了你成為一名偷懶的程式猿。作為Android開發人員，你肯定對findViewById()，setOnClickListener()，setOnClickListener()等等非常熟悉，久而久之，是不是厭煩了這些東西，簡單沒營養，又不得不寫，這時候，諸如Android ButterKnife，AndroidAnnotations等開源架構就出現了。

ButterKnife新特性：

    1、支援 Activity 中的 View 注入

    2、支援 View 中的 View 注入

    3、支援 View 事件回呼函數注入（@OnLongClick  @OnFocusChanged @OnItemClick @OnItemLongClick @OnCheckedChanged等等）

 

今天，我們來講一下Android ButterKnife的使用，Android ButterKnife是一個專註於Android系統的View注入架構，可以減少至少一半的代碼量。

首先第一步，肯定是引用Library咯~

    1、匯入butterknife-7.0.1.jar，butterknife-7.0.1.jar

    我使用的AndroidStudio開發，是如果你使用的是Eclipse，那麼還需要進行下面的配置

    2、右擊項目->屬性->Java Compiler → Annotation Processing ，選中"Enable project specific settings".

    3、展開Annotation Processing，點擊Factory Path，選中Enable project specific settings，然後點擊Add JARs…，選中libs下的Butter Knife jar包

除了onClick外，其他事件的回呼函數綁定也是如此，就不一一詳細介紹了。配置完畢，給個例子，大家就懂了。

   

首先，來看看xml布局檔案，這裡只是定義簡單的幾個Button控制項

[html] view plain copy 

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
2.     xmlns:app="http://schemas.android.com/apk/res-auto"  
3.     android:layout_width="match_parent"  
4.     android:layout_height="match_parent"  
5.     android:orientation="vertical">  
6.   
7.     <Button  
8.         android:id="@+id/btn1"  
9.         android:layout_width="wrap_content"  
10.         android:layout_height="wrap_content" />  
11.   
12.     <Button  
13.         android:id="@+id/btn2"  
14.         android:layout_width="wrap_content"  
15.         android:layout_height="wrap_content" />  
16.   
17.     <Button  
18.         android:id="@+id/btn3"  
19.         android:layout_width="wrap_content"  
20.         android:layout_height="wrap_content" />  
21.   
22.     <Button  
23.         android:id="@+id/btn4"  
24.         android:layout_width="wrap_content"  
25.         android:layout_height="wrap_content" />  
26. </LinearLayout>  

 

在Activity中，進行註解的綁定。

[html] view plain copy 

1. package com.newland.adsl;  
2.   
3. import android.support.design.widget.TextInputLayout;  
4. import android.support.v7.app.ActionBarActivity;  
5. import android.os.Bundle;  
6. import android.view.View;  
7. import android.view.ViewGroup;  
8. import android.widget.BaseAdapter;  
9. import android.widget.Button;  
10. import android.widget.TextView;  
11. import android.widget.Toast;  
12.   
13. import butterknife.Bind;  
14. import butterknife.ButterKnife;  
15. import butterknife.OnClick;  
16.   
17.   
18. public class MainActivity extends ActionBarActivity {  
19.   
20.     @Bind(R.id.btn1)  
21.     Button btnOne;  
22.   
23.     @Bind(R.id.btn2)  
24.     Button btnTwo;  
25.   
26.     @Bind(R.id.btn3)  
27.     Button btnThree;  
28.   
29.     @Bind(R.id.btn4)  
30.     Button btnFour;  
31.   
32.     @Override  
33.     protected void onCreate(Bundle savedInstanceState) {  
34.         super.onCreate(savedInstanceState);  
35.         setContentView(R.layout.activity_main);  
36.         ButterKnife.bind(this); // 綁定註解  
37.          btnOne.setText("按鈕-1");  
38.         btnTwo.setText("按鈕-2");  
39.         btnThree.setText("按鈕-3");  
40.         btnFour.setText("按鈕-4");  
41.     }  
42.   
43.     @OnClick(R.id.btn1) // 不帶參數  
44.     public void btnOne() {  
45.         Toast.makeText(MainActivity.this, "Toast comes out", Toast.LENGTH_SHORT).show();  
46.     }  
47.   
48.   
49.     @OnClick(R.id.btn2)// 帶有Button參數  
50.     public void btnTwo(Button button) {  
51.         button.setText("Hello!");  
52.     }  
53.   
54.     @OnClick({R.id.btn3, R.id.btn4}) // 同時綁定多個控制項  
55.     public void btnThreeAndFour(Button button) {  
56.         button.setText("World!");  
57.     }  
58. }  

在onCreate()裡面，setContentView()之後，一定不要忘記的是進行綁定註解

[java] view plain copy 

1. ButterKnife.bind(this); // 綁定註解  

@Bind(R.id.btn1) 這就把下面的變數名與控制項id綁定了，就相當於執行了findViewById()

@OnClick(R.id.btn2) 這是繫結控制項的點擊事件，函數裡面執行的就是點擊事件觸發後要做的事，相當於setOnClickListener(new OnClickListener( onClick( ... ... )));

以上就是實現在Activity下的綁定，當然，在ViewHolder模式下和Fragement也可以綁定。

ViewHolder模式下綁定：

[java] view plain copy 

1. public class MyAdapter extends BaseAdapter {  
2.         @Override  
3.         public View getView(int position, View view, ViewGroup parent) {  
4.             ViewHolder holder;  
5.             if (view != null) {  
6.                 holder = (ViewHolder) view.getTag();  
7.             } else {  
8.                 view = getLayoutInflater().inflate(R.layout.design_navigation_item, parent, false);  
9.                 holder = new ViewHolder(view);  
10.                 view.setTag(holder);  
11.             }  
12.             holder.name.setText("Inject");  
13.             return view;  
14.         }  
15.   
16.         @Override  
17.         public long getItemId(int position) {  
18.             return position;  
19.         }  
20.   
21.         @Override  
22.         public Object getItem(int position) {  
23.             return null;  
24.         }  
25.   
26.         @Override  
27.         public int getCount() {  
28.             return 0;  
29.         }  
30.   
31.         class ViewHolder {  
32.             @Bind(R.id.title)  
33.             TextView name;  
34.   
35.             public ViewHolder(View view) {  
36.                 ButterKnife.bind(this, view);  
37.             }  
38.         }  
39.     }  

Fragement下的綁定：

[java] view plain copy 

1. public class MyFragment extends Fragment {  
2.     @Bind(R.id.button1)  
3.     Button button1;  
4.     @Bind(R.id.button2)  
5.     Button button2;  
6.   
7.     @Override  
8.     public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {  
9.         View view = inflater.inflate(R.layout.fragment, container, false);  
10.         ButterKnife.bind(this, view);  
11.         // TODO Use fields...  
12.         return view;  
13.     }  
14. }  

 

順便提一點，每個需要綁定註解的Activity都得執行ButterKnife.bind(this);如果怕忘了怎麼辦？寫個BaseActivity，繼承Activity，在BaseActivity的onCreate函數裡面進行綁定，那麼我們只要把自己寫的Activity來繼承BaseActivity就行了，當然，BaseActivity還可以實現其他一些通用的東西。

 

這裡要強調的一點是，如果你使用AndroidStudio直接通過build.gradle添加 compile ‘com.jakewharton:butterknife:6.1.0‘ 來引入ButterKnife的話，那麼就會有一些變動了，如下：

[java] view plain copy 

1. @InjectView(R.id.hello)  
2. TextView hello;  
3. @Override  
4. protected void onCreate(Bundle savedInstanceState) {  
5.     super.onCreate(savedInstanceState);  
6.     ButterKnife.inject(this);  
7. }  

這就是butterknife:6.1.0和butterknife-7.0.1.jar 因為版本不同產生的區別。

Android ButterKnife注入架構