Android注解使用之ButterKnife 8.0注解使用介绍

来源:互联网 发布:学linux能干哪些工作 编辑:程序博客网 时间:2024/03/28 19:18

Android注解使用之ButterKnife 8.0注解使用介绍

前言:

     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.)使用之前
复制代码
public class ExampleActivity extends AppCompatActivity {    private final static String TAG = ExampleActivity.class.getSimpleName();    String butterKnifeStr;    Drawable butterKnifeDrawable;    Button butterKnifeBtn;    ImageView butterKnifeIv;    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_butter_knife);        initResource();        initViews();    }    private void initViews() {        butterKnifeBtn = (Button) findViewById(R.id.btn_butter_knife);        butterKnifeBtn.setOnClickListener(new View.OnClickListener() {            @Override            public void onClick(View v) {                Log.e(TAG, "onButterKnifeBtnClick");            }        });        butterKnifeIv = (ImageView) findViewById(R.id.iv_butter_knife);        butterKnifeBtn.setText(butterKnifeStr);        butterKnifeIv.setImageDrawable(butterKnifeDrawable);    }    private void initResource() {        butterKnifeStr = getString(R.string.title_btn_butter_knife);        butterKnifeDrawable = getDrawable(R.mipmap.ic_launcher);    }}
复制代码
2.)使用之后
复制代码
public class ButterKnifeActivity extends AppCompatActivity {    private final static String 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    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_butter_knife);        unbinder = ButterKnife.bind(this);        initViews();    }    private void initViews() {        butterKnifeBtn.setText(butterKnifeStr);        butterKnifeIv.setImageDrawable(butterKnifeDrawable);    }    @OnClick(R.id.btn_butter_knife)    public void onButterKnifeBtnClick(View view) {        Log.e(TAG, "onButterKnifeBtnClick");    }    @Override    protected void 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

复制代码
class ExampleActivity extends Activity {  @BindView(R.id.title) TextView title;  @BindView(R.id.subtitle) TextView subtitle;  @BindView(R.id.footer) TextView footer;  @Override public void onCreate(Bundle savedInstanceState) {    super.onCreate(savedInstanceState);    setContentView(R.layout.simple_activity);    ButterKnife.bind(this);    // TODO Use fields...  }}
复制代码

Fragment:由于不同的视图生命周期,所以需要在onCreateView bind,在onDestroyView unbind

复制代码
public class FancyFragment extends 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 public void onDestroyView() {    super.onDestroyView();    unbinder.unbind();  }}
复制代码

ViewHolder

复制代码
public class MyAdapter extends BaseAdapter {  @Override public View 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;  }  static class 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<TextView> 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)    int colorPrimary;//color注解使用    @BindDimen(R.dimen.activity_horizontal_margin)    Float spacer;
复制代码
6.)单事件注入

一个控件指定一个事件回调

复制代码
    /**     * 带参数     */    @OnClick(R.id.btn_butter_knife)    public void onButterKnifeBtnClick() {    }    /**     * 带参数     */    @OnClick(R.id.btn_butter_knife)    public void onButterKnifeBtnClick(View view) {        Log.e(TAG, "onButterKnifeBtnClick");    }    /**     * 带参数     * @param button     */    @OnClick(R.id.btn_butter_knife)    public void onButterKnifeBtnClick(Button button) {        Log.e(TAG, "onButterKnifeBtnClick");    }
复制代码

也可以多个控件指定一个事件回调

复制代码
    /**     * 两个不同的button都相应onButterKnifeBtnClick事件回调     *     * @param button     */    @OnClick({R.id.btn_butter_knife, R.id.btn_butter_knife1})    public void onButterKnifeBtnClick(Button button) {        Log.e(TAG, "onButterKnifeBtnClick");    }
复制代码

自定义的控件不通过ID也可以绑定到自己的事件

复制代码
public class FancyButton extends Button {  @OnClick  public void onClick() {    // TODO do something!  }}
复制代码
7.)多事件回调

有一些View的listener是有多个回调方法的,比如EditText添加addTextChangedListener

复制代码
 editText.addTextChangedListener(new TextWatcher() {            @Override            public void beforeTextChanged(CharSequence s, int start, int count, int after) {            }            @Override            public void onTextChanged(CharSequence s, int start, int before, int count) {            }            @Override            public void afterTextChanged(Editable s) {            }        });
复制代码

可以使用注解方式改成如下

复制代码
    @OnTextChanged(value = R.id.nameEditText, callback = OnTextChanged.Callback.BEFORE_TEXT_CHANGED)    void beforeTextChanged(CharSequence s, int start, int count, int after) {    }    @OnTextChanged(value = R.id.nameEditText, callback = OnTextChanged.Callback.TEXT_CHANGED)    void onTextChanged(CharSequence s, int start, int before, 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);static final ButterKnife.Action<View> DISABLE = new ButterKnife.Action<View>() {  @Override public void apply(View view, int index) {    view.setEnabled(false);  }};static final ButterKnife.Setter<View, Boolean> ENABLED = new ButterKnife.Setter<View, Boolean>() {  @Override public void set(View view, Boolean value, int index) {    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版本的,但是都是差不多的

干我们这行,啥时候懈怠,就意味着长进的停止,长进的停止就意味着被淘汰,只能往前冲,直到凤凰涅槃的一天!
分类: Android使用注解
标签: BufferKnife, Android BufferKnife
好文要顶关注我收藏该文
总李写代码
关注 - 0
粉丝 - 173
+加关注
5
0
«上一篇:Android线程管理之ThreadPoolExecutor自定义线程池
»下一篇:Android混合开发之WebView使用总结
posted @ 2016-06-28 09:07 总李写代码 阅读(3189) 评论(3)编辑收藏
0 0
原创粉丝点击