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()。

  1. 獲取組件並添加綁定關係
    右擊佈局,選擇以下內容
     

選擇以下內容

 
 

選擇後自動生成以下代碼:

 

 

溫馨提示:屬性佈局不能用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.button1R2.id.button2R2.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
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章