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

文章大綱

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

 

一、框架介紹

為什么要用注解框架？
  在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. 市面上還有很多其他的注釋框架，但是萬變不離其宗，不是反射就是自動生成代碼。反射功能雖然強大，但是不可取，不僅會拖慢速度還會破話程序的封裝性。個人認為生成代碼的方案比較好，所有的功能都在編譯時做了，並不會影響到用戶的體驗，唯一的缺點就是比反射難實現，不過我們程序不就是把難處留給自己，把快樂留給用戶么！

二、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 );

三、項目源碼下載

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

參考文章：

1. https://www.cnblogs.com/alexjie-123/p/6097523.html
2. https://www.cnblogs.com/SongYongQian/p/7967202.html