Android註解框架實戰-ButterKnife(原創）

文章大綱

1. Android註解框架介紹
2. ButterKnife實戰
3. 項目源碼下載

 

1、框架介紹

爲何要用註解框架？
  在Android開發過程當中，咱們常常性地須要操做組件，操做方法有findViewById, setOnClickListener等等方法，這個過程會讓工程師抓狂的，好在市面已經有大神封裝好的的註解框架能夠幫助開發者簡化一些過程，下面就讓我來給你們介紹一些常見的註解框架。

ButterKnife框架介紹
  首先看下Butterknife，來自Jakewharton大神的力做，特色是接入簡單，依賴一個庫就行了。另外在Android Studio上還有提供一個插件，自動生成註解與類屬性。Butterknife目前支持的註解有: View綁定(Bind)，資源綁定(BindBool, BindColor, BindDimen, BindDrawble, BindInt, BindString)，事件綁定(OnCheckedChanged, OnClick, OnEditorAction, OnFocusChange, OnItemClick, OnItemLongClick, OnItemSelected, OnLongClick, OnPageChange, OnTextChanged, OnTouch)，ButterKnife是在編譯時候生成新的class文件，而不是在運行時處理這個邏輯，因此不影響使用性能。

AndroidAnnotations框架介紹
  該框架的原理跟Butterknife同樣，都是在編譯時生成代碼，不過annotations並非生成代碼供對應的類調用去給帶註解的變量、方法賦值，而是直接生成一個繼承帶註解的類，這個類裏面有對變量賦值，對註解方法調用的代碼。運行時，直接運行的是annotations生成的類，而不是咱們寫的類。

XUtils框架介紹
  xutils的使用方式跟Butterknife同樣，都是在成員變量，方法上添加註釋，而後調用一個方法(xutils是ViewUtils.inject()方法)對成員變量賦值、事件方法設置到view上。不一樣的是，Butterknife是調用自動生成的代碼來賦值，而xutils是經過反射來實現的。

舒適提示：

1. 雖然如今的反射速度也很快了，可是仍是不能跟原生代碼相比，一旦註釋用的多了，這初始化速度會愈來愈慢。經過上面註釋處理的代碼能夠看出，xutils支持的註釋目前主要有UI, 資源，事件，SharedPreference綁定。跟xutils同樣是運行時利用反射去解析註釋的框架還有afinal, roboguice等。
2. 市面上還有不少其餘的註釋框架，可是萬變不離其宗，不是反射就是自動生成代碼。反射功能雖然強大，可是不可取，不只會拖慢速度還會破話程序的封裝性。我的認爲生成代碼的方案比較好，全部的功能都在編譯時作了，並不會影響到用戶的體驗，惟一的缺點就是比反射難實現，不過咱們程序不就是把難處留給本身，把快樂留給用戶麼！

2、ButterKnife實戰

1. 添加xml佈局

 

2. 在app的build.gradle中添加如下依賴

 

3. studio中下載插件

 

 

 

 

 

 

舒適提示：下載後，通常studio會自動提示重啓

3. 添加ButterKnife聲明

 

 

舒適提示：
  Activity ButterKnife.bind(this);必須在setContentView();以後，且父類bind綁定後，子類不須要再bind。Fragment ButterKnife.bind(this, mRootView);這裏的this不能替換成getActivity（）。

4. 獲取組件並添加綁定關係
   右擊佈局，選擇如下內容
   
    

   

選擇如下內容

 

 

選擇後自動生成如下代碼：

 

 

舒適提示：屬性佈局不能用private or static 修飾，不然會報錯

編譯後運行程序，截圖以下圖所示：

 

其餘綁定方式介紹

綁定註解
@BindView---->綁定一個view；id爲一個view 變量
@BindView(R.id.tv_fm1)
TextView tvFm1;
@BindViews ---->綁定多個view；id爲一個view的list變量
@BindViews({ R.id.btn1,R.id.btn2 })
List<Button> buttons;
@BindArray---->綁定string裏面array數組；
@BindArray(R.array.city )
String[] citys ;

@BindBitmap---->綁定圖片資源爲Bitmap；
@BindBitmap(R.mipmap.wifi )
Bitmap bitmap;

@BindBool ---->綁定boolean值

@BindColor ---->綁定color；
@BindColor(R.color.colorAccent)
int black;

@BindDimen ---->綁定Dimen；
@BindDimen(R.dimen.borth_width)
int mBorderWidth;

@BindDrawable ----> 綁定Drawable；
@BindDrawable(R.drawable.test_pic)
Drawable mTestPic;

@BindFloat ---->綁定float

@BindInt ---->綁定int

@BindString ---->綁定一個String id爲一個String變量；
@BindString(R.string.app_name )
String meg;

事件註解
@OnClick---->點擊事件
@OnCheckedChanged ---->選中，取消選中
@OnEditorAction ---->軟鍵盤的功能鍵
@OnFocusChange ---->焦點改變
@OnItemClick item---->被點擊(注意這裏有坑，若是item裏面有Button等這些有點擊的控件事件的，須要設置這些控件屬性focusable爲false)
@OnItemLongClick item---->長按(返回真能夠攔截onItemClick)
@OnItemSelected ---->item被選擇事件
@OnLongClick ---->長按事件
@OnPageChange ---->頁面改變事件
@OnTextChanged ---->EditText裏面的文本變化事件
@OnTouch ---->觸摸事件

綁定view
1）@BindView() : 佈局id 註解
@BindView( R2.id.button)
public Button button;
button 的修飾類型不能是：private 或者 static 。

2）@BindViews(): 佈局內多個控件 id 註解
@BindViews({ R2.id.button1, R2.id.button2, R2.id.button3})
public List<Button> buttonList ;
ButterKnife.bind(this);
buttonList.get( 0 ).setText( "hello 1 ");
buttonList.get( 1 ).setText( "hello 2 ");
buttonList.get( 2 ).setText( "hello 3 ");

綁定資源
1）@BindString() ：綁定string 字符串
@BindString(R2.string.app_name) //綁定資源文件中string字符串
String str;
button.setText( str );

2）@BindArray() : 綁定string裏面array數組
@BindArray(R2.array.city) //綁定string裏面array數組
String [] citys ;
button.setText(citys[0]);

3）@BindBitmap( ) : 綁定Bitmap 資源
@BindBitmap(R2.drawable.bm)//綁定Bitmap 資源
public Bitmap bitmap ;
imageView.setImageBitmap(bitmap);
drawable文件夾下的圖片使用R或R2引用都沒問題；可是mipmap文件夾下的圖片資源引用目前只能使用R

4）@BindColor( ) : 綁定一個顏色值
@BindColor( R2.color.colorAccent ) //具體色值在color文件中
int black ; //綁定一個顏色值
button.setTextColor( black );

3、項目源碼下載

連接：https://pan.baidu.com/s/1it6GSMiigaZOhYm5q8yWYg
提取碼：iqdg

參考文章：

1. https://www.cnblogs.com/alexjie-123/p/6097523.html
2. http://www.javashuo.com/article/p-azdcuffz-a.html