Android注解使用之ButterKnife 8.0注解使用介绍
原文来自https://www.cnblogs.com/whoislcj/p/5620128.html，感谢分享！如有侵权，请联系删除。
前言：
App项目开发大部分时候还是以UI页面为主，这时我们需要调用大量的findViewById以及setOnClickListener等代码，控件的少的时候我们还能接受，控件多起来有时候就会有一种想砸键盘的冲动。所以这个时候我们想着可以借助注解的方式让我们从这种繁重的工作中脱离出来，也让代码变得更加简洁，便于维护，今天主要学习一下只专注View、Resource、Action注解框架ButterKnife。
ButterKnife介绍
ButterKnife是一个专注于Android系统的View、Resource、Action注入框架。
官网：http://jakewharton.github.io/butterknife/
gitHub：https://github.com/JakeWharton/butterknife/
ButterKnife使用前后对比：
看看没有使用View注解之前我们是如何做的
1.）使用之前
publicclassExampleActivityextends AppCompatActivity {
privatefinalstaticString TAG = ExampleActivity.class.getSimpleName();
String butterKnifeStr;
Drawable butterKnifeDrawable;
Button butterKnifeBtn;
ImageView butterKnifeIv;
@Override
protectedvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_butter_knife);
initResource();
initViews();
}
privatevoid initViews() {
butterKnifeBtn = (Button) findViewById(R.id.btn_butter_knife);
butterKnifeBtn.setOnClickListener(new View.OnClickListener() {
@Override
publicvoid onClick(View v) {
Log.e(TAG, "onButterKnifeBtnClick");
}
});
butterKnifeIv = (ImageView) findViewById(R.id.iv_butter_knife);
butterKnifeBtn.setText(butterKnifeStr);
butterKnifeIv.setImageDrawable(butterKnifeDrawable);
}
privatevoid initResource() {
butterKnifeStr = getString(R.string.title_btn_butter_knife);
butterKnifeDrawable = getDrawable(R.mipmap.ic_launcher);
}
}
2.）使用之后
publicclassButterKnifeActivityextends AppCompatActivity {
privatefinalstaticString TAG = ButterKnifeActivity.class.getSimpleName();
private Unbinder unbinder;
@BindString(R.string.title_btn_butter_knife)
String butterKnifeStr;
@BindDrawable(R.mipmap.ic_launcher)
Drawable butterKnifeDrawable;
@BindView(R.id.btn_butter_knife)
Button butterKnifeBtn;
@BindView(R.id.iv_butter_knife)
ImageView butterKnifeIv;
@Override
protectedvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_butter_knife);
unbinder = ButterKnife.bind(this);
initViews();
}
privatevoid initViews() {
butterKnifeBtn.setText(butterKnifeStr);
butterKnifeIv.setImageDrawable(butterKnifeDrawable);
}
@OnClick(R.id.btn_butter_knife)
publicvoid onButterKnifeBtnClick(View view) {
Log.e(TAG, "onButterKnifeBtnClick");
}
@Override
protectedvoid onDestroy() {
super.onDestroy();
unbinder.unbind();
}
}
3.）ButterKnife 优势
通过上面使用前后对比来分析下ButterKnife优势
强大的View绑定和Click事件处理功能，简化代码，提升开发效率
方便的处理Adapter里的ViewHolder绑定问题
运行时不会影响APP效率，使用配置方便
代码清晰，可读性强
使用前后对比之后有没有觉得非常的简单易用。接下来来看下具体怎么使用的？
ButterKnife如何使用：
1.）在Project的build.gradle中添加如下配置
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
}
}
2.）在Module的build.gradle添加如下配置
apply plugin: 'com.neenbedankt.android-apt'
android {
...
}
dependencies {
compile 'com.jakewharton:butterknife:8.1.0'
apt 'com.jakewharton:butterknife-compiler:8.1.0'
}
3.）注入和重置注入
Activity
classExampleActivityextends Activity {
@BindView(R.id.title) TextView title;
@BindView(R.id.subtitle) TextView subtitle;
@BindView(R.id.footer) TextView footer;
@Override publicvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.simple_activity);
ButterKnife.bind(this);
// TODO Use fields... }
}
Fragment：由于不同的视图生命周期，所以需要在onCreateView bind，在onDestroyView unbind
publicclassFancyFragmentextends Fragment {
@BindView(R.id.button1) Button button1;
@BindView(R.id.button2) Button button2;
private Unbinder unbinder;
@Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fancy_fragment, container,false);
unbinder = ButterKnife.bind(this, view);
// TODO Use fields...return view;
}
@Override publicvoid onDestroyView() {
super.onDestroyView();
unbinder.unbind();
}
}
ViewHolder
publicclassMyAdapterextends BaseAdapter {
@Override publicView getView(int position, View view, ViewGroup parent) {
ViewHolder holder;
if(view !=null) {
holder = (ViewHolder) view.getTag();
} else {
view = inflater.inflate(R.layout.whatever, parent,false);
holder =new ViewHolder(view);
view.setTag(holder);
}
holder.name.setText("John Doe");
// etc...return view;
}
staticclass ViewHolder {
@BindView(R.id.title) TextView name;
@BindView(R.id.job_title) TextView jobTitle;
public ViewHolder(View view) {
ButterKnife.bind(this, view);
}
}
}
4.）view注入 @BindView，@BindViews
@BindView(R.id.btn_butter_knife)
Button butterKnifeBtn;
@BindViews({R.id.tv_butter_knife1,R.id.tv_butter_knife2,R.id.tv_butter_knife3})
List textViews;
5.）Resource注入
@BindString(R.string.title_btn_butter_knife)
String butterKnifeStr;//string注解使用 @BindDrawable(R.mipmap.ic_launcher)
Drawable butterKnifeDrawable;//Drawable注解使用 @BindBitmap(R.mipmap.ic_launcher)
Bitmap butterKnifeBitmap;;//Bitmap注解使用 @BindArray(R.array.day_of_week)
String weeks[];//数组 @BindColor(R.color.colorPrimary)
intcolorPrimary;//color注解使用 @BindDimen(R.dimen.activity_horizontal_margin)
Float spacer;
6.）单事件注入
一个控件指定一个事件回调
/** * 带参数
*/ @OnClick(R.id.btn_butter_knife)
publicvoid onButterKnifeBtnClick() {
}
/** * 带参数
*/ @OnClick(R.id.btn_butter_knife)
publicvoid onButterKnifeBtnClick(View view) {
Log.e(TAG, "onButterKnifeBtnClick");
}
/** * 带参数
* @param button
*/ @OnClick(R.id.btn_butter_knife)
publicvoid onButterKnifeBtnClick(Button button) {
Log.e(TAG, "onButterKnifeBtnClick");
}
也可以多个控件指定一个事件回调
/** * 两个不同的button都相应onButterKnifeBtnClick事件回调
*
* @param button
*/ @OnClick({R.id.btn_butter_knife, R.id.btn_butter_knife1})
publicvoid onButterKnifeBtnClick(Button button) {
Log.e(TAG, "onButterKnifeBtnClick");
}
自定义的控件不通过ID也可以绑定到自己的事件
publicclassFancyButtonextends Button {
@OnClick
publicvoid onClick() {
// TODO do something! }
}
7.）多事件回调
有一些View的listener是有多个回调方法的,比如EditText添加addTextChangedListener
editText.addTextChangedListener(new TextWatcher() {
@Override
publicvoidbeforeTextChanged(CharSequence s,intstart,intcount,int after) {
}
@Override
publicvoidonTextChanged(CharSequence s,intstart,intbefore,int count) {
}
@Override
publicvoid afterTextChanged(Editable s) {
}
});
可以使用注解方式改成如下
@OnTextChanged(value = R.id.nameEditText, callback = OnTextChanged.Callback.BEFORE_TEXT_CHANGED)
voidbeforeTextChanged(CharSequence s,intstart,intcount,int after) {
}
@OnTextChanged(value = R.id.nameEditText, callback = OnTextChanged.Callback.TEXT_CHANGED)
voidonTextChanged(CharSequence s,intstart,intbefore,int count) {
}
@OnTextChanged(value = R.id.nameEditText, callback = OnTextChanged.Callback.AFTER_TEXT_CHANGED)
void afterTextChanged(Editable s) {
}
8.）选择性注入
默认情况下,@Bind和listener的注入都是必须的,如果target view没有被发现,则会报错. 为了抑制这种行为,可以用@Optional注解来标记field和方法,让注入变成选择性的,如果targetView存在,则注入, 不存在,则什么事情都不做.或者使用Android's "support-annotations" library.中的@Nullable来修饰
@Nullable @BindView(R.id.might_not_be_there)
TextView mightNotBeThere;@Optional @OnClick(R.id.maybe_missing)
void onMaybeMissingClicked() {
// TODO ...}
9.）ButterKnife.apply()函数
可以通过ButterKnifeapply()函数对view集合元素或者单个view的Action, Setter和Property进行修改
ButterKnife.apply(nameViews, DISABLE);
ButterKnife.apply(nameViews, ENABLED, false);staticfinalButterKnife.Action DISABLE =newButterKnife.Action() {
@Override publicvoidapply(View view,int index) {
view.setEnabled(false);
}
};staticfinalButterKnife.Setter ENABLED =newButterKnife.Setter() {
@Override publicvoidset(View view, Boolean value,intindex) { view.setEnabled(value); }};
ButterKnife.apply(nameViews, View.ALPHA,
0.0f);
10.）ButterKnife.findById()
ButterKnife 也提供了findById函数，通过findById()可以获取Activity、Dialog、View中的view，并且是泛型类型不需要强转
View view = LayoutInflater.from(context).inflate(R.layout.thing,null);
TextView firstName = ButterKnife.findById(view, R.id.first_name);
TextView lastName = ButterKnife.findById(view, R.id.last_name);
ImageView photo = ButterKnife.findById(view, R.id.photo);
ButterKnife自动生成插件安装：
在AndroidStudio->File->Settings->Plugins->搜索Zelezny下载添加就行 ，可以快速生成对应组件的实例对象，不用手动写。使用时，在要导入注解的Activity 或 Fragment 或 ViewHolder的layout资源代码上，右键——>Generate——Generate ButterKnife Injections，然后就出现如图的选择框。
插件gitHub地址：https://github.com/avast/android-butterknife-zelezny
上面给了一个使用流程图，不过流程图不会针对最新的8.0.1版本的，但是都是差不多的
