Android RecyclerView 数据绑定实例代码
作者:lypeer
前言
在上一个项目里有很多很多很多很多的RecyclerView,然后我需要写很多很多很多很多的Adapter和Viewholder——多倒没问题,但是里面有很多重复的代码这就不能忍了!每一个Adapter和ViewHolder其实做的事情非常的像:视图绑定,数据绑定,点击事件分发。还有啥?既然它们做的事情都一样,为啥我们还要傻傻的继续写着重复的代码?
正文
BaseAdapter
通常我们要创建一个RecyclerView.Adapter是怎么做的?
- 接收一个数据列表
- 重写getItemCount()方法,确定Item的个数
- 重写onCreateViewHolder()方法,绑定Layout,新建一个我们自己写的RecyclerView.ViewHolder
- 重写onBindViewHolder()方法,进行数据和视图绑定
- 由于RecyclerView没有写点击事件,把点击事件分发出去
基本上就是这个套路,或者再加一个refreshData()的方法——传新的数据进来然后notifyDataSetChanged()。基于这些点,我写了一个BaseAdapter基类:
/** * Adapter基类. * 适用于只有单个Item的RecyclerView. * * Created by lypeer on 16-5-24. */ public abstract class BaseAdapter<V> extends RecyclerView.Adapter<RecyclerView.ViewHolder> { /** * 装载了每个Item的Value的列表 */ private List<V> mValueList; /** * 我写的一个接口,通过回调分发点击事件 */ private OnItemClickListener<V> mOnItemClickListener; @Override public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { return createViewHolder(parent.getContext(), parent); } @Override @SuppressWarnings("unchecked")//一定会是BaseViewHolder的子类,因为createViewHolder()的返回值 public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) { //BaseViewHolder是我抽象出来的RecyclerView.ViewHolder的基类,下面会有详细讲解 ((BaseViewHolder) holder).setData(mValueList.get(position), position, mOnItemClickListener); } /** * 设置每个Item的点击事件 * @param listener */ public void setOnClickListener(OnItemClickListener<V> listener) { this.mOnItemClickListener = listener; } /** * 刷新数据 * @param valueList 新的数据列表 */ public void refreshData(List<V> valueList) { this.mValueList = valueList; notifyDataSetChanged(); } @Override public int getItemCount() { return mValueList == null ? 0 : mValueList.size(); } /** * 生成ViewHolder * @param context * @param parent * @return */ protected abstract BaseViewHolder createViewHolder(Context context, ViewGroup parent); }
它的子类在继承它的时候需要指定泛型的具体类型,因为不同的Item也许其数据类型并不一样,这样就可以适应更多的Item。另外,其中提到了一个接口OnItemClickListener,这个接口很简单:
/** * 点击事件的接口 * Created by lypeer on 16-5-24. */ public interface OnItemClickListener<V> { /** * 当item被点击的时候进行事件分发 * * @param itemValue 点击的item传递的值 * @param viewID 点击控件的id * @param position 被点击的item的位置 */ void onItemClick(V itemValue, int viewID, int position); }
在使用它的时候同样需要使用泛型——原因和上面一样。
通过上面的BaseAdapter,我们把很多的共有操作都封装在了基类里面,而它的子类只需要根据需要新建不同的ViewHolder就行了——当然,这个viewHolder必须继承自BaseViewHolder,而BaseViewHolder是什么下面会有详细讲解。接下来是一个例子,假设我们现在在一个界面要有一个RecyclerView,它的每个Item的数据是一个String值,那么怎么使用我们的BaseAdapter简化开发过程呢?
public class SampleAdapter extends BaseAdapter<String> { @Override protected BaseViewHolder createViewHolder(Context context, ViewGroup parent) { //SampleViewHolder继承自BaseViewHolder return new SampleViewHolder(context, parent); } }
是的,你没有看错!就只有这么几行代码!5秒完成!惊喜么?!
你只需要新建一个SampleAdapter继承自BaseAdapter,然后指定其泛型为String,再return new SampleViewHolder(context, parent) , 就完成了整个操作。
但是,有些读者也许会有疑惑:也许我们需要在SampleViewHolder里面做很多的操作呢?那岂不是只是把代码转换了一个地方而已,实质上并没有什么优化之处。
然而并不是。
BaseViewHolder
我一直认为,将ViewHolder写在Adapter里面是挺不明智的一个做法。这样的话Adapter这个类的职责太重了,它做得事情太多了,从数据接收到界面绑定,从控件初始化到点击事件分发,它简直什么都做完了。而这样是很不好的。很轻易的,一个比较复杂的RecyclerView的Adapter的代码就能达到成百上千行,这很可怕,这意味着这个类将变得冗杂且难以维护。那么怎么避免这种情况发生呢?我选择了将ViewHolder分离,同时加重ViewHolder的职责,使它们能比较均衡。
直接看BaseViewHolder的代码:
/** * ViewHolder基类 * * Created by lypeer on 16-5-27. */ public abstract class BaseViewHolder<V> extends RecyclerView.ViewHolder { public BaseViewHolder(Context context, ViewGroup root, int layoutRes) { super(LayoutInflater.from(context).inflate(layoutRes, root, false)); //这里使用了ButterKnife来进行控件的绑定 ButterKnife.bind(this, itemView); } /** * 方便其子类进行一些需要Context的操作. * * @return 调用者的Context */ public Context getContext() { return itemView.getContext(); } /** * 抽象方法,绑定数据. * 让子类自行对数据和view进行绑定 * * @param itemValue Item的数据 * @param position 当前item的position * @param listener 点击事件监听者 */ protected abstract void bindData(V itemValue, int position, OnItemClickListener listener); /** * 用于传递数据和信息 * * @param itemValue * @param position * @param listener */ public void setData(V itemValue, int position, OnItemClickListener listener) { bindData(itemValue, position, listener); } }
BaseViewHolder同样采用了泛型,以适应不同的数据类型。同时,我在BaseViewHolder里面使用了ButterKnife来简化代码,从此再也不用反反复复的findViewById了。
另外,大家可以看到BaseViewHolder里面的构造方法中传入了三个参数,但是在上面BaseAdapter的例子里面SampleViewHolder的构造方法我们却只传入了它的前两个构造参数,而第三个参数layoutRes并没有传进去,这是怎么回事呢?是上面写错了么?当然不是。BaseViewHolder的构造方法中有三个传参是因为它需要三个传参,而它的子类只有两个传参是因为它只能有两个传参。_BaseViewHolder必须要满足它的super构造,所以必须要有那三个参数,而它的子类如果那三个参数都是由外界传进来的,那么它怎么进行针对那个布局进行特异化的操作?它必须在类里面显式的指定Layout ID_——这其实是我很想优化的一个地方,因为这样的话子类继承BaseViewHolder之后还要修改它的构造方法,这是比较让人不省心的,但是目前还没有想到什么好点子来优雅地优化它。
BaseViewHolder里面有两个看起来很像的方法:setData()和bindData(),然而实际上除了传参相同,它们其他方面根本完全不一样。setData()方法是一个public的方法,可以由BaseViewHolder的子类的对象调用,其作用是从外部传入数据,以供ViewHolder所hold的那个view初始化,它可以说是一座传输信息的桥梁;而getData()是一个抽象的方法,它的具体实现在每一个BaseViewHolder的子类中,这些子类在这个方法里面进行控件的绑定和初始化,以及对控件的点击事件的处理等等。
说到点击事件的处理,它的子类应该怎么完成这件事呢?通过OnItemClickListener。我们可以借助于OnItemClickListener的接口回调来将需要处理的点击事件传递到外界,然后由外界进行处理。那么如果有多个控件的点击事件需要处理怎么办?不用担心,因为在OnItemClickListener的onClick方法中你需要传入点击的控件的id,这样一来就可以在外界进行对传入id的判断,从而针对不同的id执行不同的点击事件了。
接下来通过一个例子来看下具体怎么用,就是上面的那个SampleViewHolder吧:
public class SampleViewHolder extends BaseViewHolder<String> { //一个普通的可点击的TextView @Bind(R.id.is_tv_content) TextView mIsTvContent; public SampleViewHolder(Context context, ViewGroup root) { //修改了构造方法,在这里显式指定Layout ID super(context, root, R.layout.item_sample); } @Override protected void bindData(final String itemValue, final int position, final OnItemClickListener listener) { //在这里完成控件的初始化,将其与数据绑定 if (itemValue != null) { mIsTvContent.setText(itemValue); } //如果需要有点击事件,就通过listener把它传递出去 mIsTvContent.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { //如果外界没有调用BaseAdapter.setOnClickListener(), //listener就为null if(listener == null){ return; } //listener不为null就将这个事件传递给外界处理 listener.onItemClick(itemValue , v.getId() , position); } }); } }
同样很简单方便快捷清晰。但是还是有几点值得注意的地方。首先,不能忘了修改构造方法,显式的在super里面指定Layout ID,不然下一步都没法做,那就懵逼了。另外,在调用listener.onClick()方法的时候必须进行listener的验空——因为listener真的有可能为空!这样的话非常容易产生空异常导致程序崩溃。
宾果,就这样,SampleViewHolder就完成了,同样几乎不费吹灰之力。
结语
这篇博文的目的是分享一些我总结出来的东西,希望能让大家的开发加速那么一点点。当然,这里面也许还有我没发现的bug什么的,如果大家在使用的过程中发现了问题请不要客气,狠狠地砸给我吧!
最后还是再总结一下在有了BaseAdapter和BaseViewHolder的情况下怎么最快的搞定RecyclerView的那一套:
ViewHolder相关
新建 XXXViewHolder 继承自BaseViewHolder,指定泛型类型(也就是Item中数据的数据类型)。
删掉构造方法中的layoutRes参数,在super里面显式指定Layout ID。
用ButterKnife绑定控件。
在bindData()方法中完成控件的初始化以及点击事件的传递(别忘了listener的验空)
Adapter相关
新建 XXXAdapter 继承自BaseAdapter,指定泛型类型(也就是Item中数据的数据类型)。
return new XXXViewHolder(context, parent);
外界相关
绑定RecyclerView,新建XXXAdapter。
调用 BaseAdapter.refreshData()方法传入数据列表。
如果有对点击事件处理的需求,则调用BaseAdapter.setOnClickListener()方法。
目前我只做了针对RecyclerView中单个的Item的BaseAdapter,但是BaseViewHolder使可以通用的,并且其在多Item下也可以大大的简化Adapter的体积。
以上就是对Android RecyclerView 数据绑定的资料整理,后续继续补充相关资料谢谢大家对本站的支持!