让偷懒更彻底——用Butterknife 来为recyclerview 打造通用适配器(上)

背景

随着recyclerview 的越来越普及，其高度的易用性，让我们越来越爱不释手，当然网上也出现了很多类似的通用适配器，让我们更加方便的使用它，今天我们这里介绍一种新的recyclerview的通用适配器的实现思路——把recyclerview和ButterKnife结合起来使用(ps:因为公司开发一直使用butterknife，才有了这种想法)。

---

首先贴上我的实现效果：

代码用法使用：

ModelRecyclerAdapter adapter = new ModelRecyclerAdapter(MyImageViewHolder.class, datas);        recyclerView.setAdapter(adapter);

其中datas就是我们的数据，当然为了通用是泛型的，这边是传入的一个String的list，最关键的是我的MyViewHolder.class类了，他就是我们的核心点了，在这个类里面封装了我们所有数据展示和点击事件。
首先是item布局代码，我这边为了简单，就用了一个imageview,
在其中我用Picasso去加载了一张图片，然后给每个位置设置了点击效果展示当前position。
R.layout.item_list：

<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="120dp"    android:layout_height="120dp"    android:background="@android:color/black"    android:paddingLeft="8dp"    android:paddingTop="8dp">    <ImageView        android:id="@+id/iv_item1"        android:layout_width="match_parent"        android:layout_height="match_parent"        android:background="@android:color/white"        android:padding="12dp"        android:scaleType="centerCrop" /></LinearLayout>

我们绑定事件的viewholder类：

 /**     * 我们的实际使用中的viewhoder     * 用注释item的布局文件，在这个类的实现中，我们可以绑定点击事件，更新数据     */    @RecyclerItemViewId(R.layout.item_list)    public static class MyViewHolder extends ModelRecyclerAdapter.ModelViewHolder<String> {        @BindView(R.id.iv_item1)        ImageView imageView;        /**         * 可以对itemview的任何一个view绑定监听，这里只是以onclick为例，当然也可以绑定onTouch,onLongClick等         */        @OnClick(R.id.iv_item1)        void onclick() {            Toast.makeText(imageView.getContext(), position + " 点击~", Toast.LENGTH_SHORT).show();        }        public int position;        public MyViewHolder(View itemView) {            super(itemView);        }        /**         * 绑定我们的数据         *         * @param item    这是数据         * @param adapter adapter 对象         * @param context context对象         * @param positon 当前位置         */        @Override        public void convert(String item, ModelRecyclerAdapter adapter, Context context, int positon) {            this.position = positon;            Picasso.with(context).load(item).into(imageView);        }    }

代码很清晰有木有！？我们只需要在这个类里面完成布局的绑定，数据的绑定，监听的绑定，然后设置给recyclerview的时候只需2行代码即可！教练，这波我要偷懒！

设计思路分析：

我们在为recyclerview定制adpter的时候，必须继承自Recyclerview.Adapter<>而这个泛型中需要传入Recyclerview.viewholder的实现类，那么这个viewholder类是什么呢？其实这个类在构造的时候，需要传入一个itemview，这个view就相当于我们使用listview和gridview中的convertview，而在listview中，我们复用的单位是convertview，而在recyclerview中，我们复用的单位是这个viewholder，itemview就是其中一个成员变量，下面我们首先用原始的方式写出我们demo里面那个图片实例展示：

public class MyHolder extends RecyclerView.ViewHolder {        /**         * 构造方法，传入view即我们listview的convertview         *         * @param itemView         */        public MyHolder(View itemView) {            super(itemView);        }    }    public class MyAdapter extends RecyclerView.Adapter<MyHolder> {        List<String> datas = new ArrayList<>();        public MyAdapter(List<String> data) {            this.datas = data;        }        @Override        public MyHolder onCreateViewHolder(ViewGroup parent, int viewType) {            View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_list, parent, false);            MyHolder holder = new MyHolder(itemView);//完成对holder的创建，中间互用逻辑RecyclerView帮我们完成了            return holder;        }        @Override        public void onBindViewHolder(MyHolder holder, final int position) {            //这里完成数据的绑定与事件的监听            ImageView imageView = (ImageView) holder.itemView.findViewById(R.id.iv_item1);            imageView.setOnClickListener(new View.OnClickListener() {                @Override                public void onClick(View v) {                    Toast.makeText(v.getContext(), "点击 " + position, Toast.LENGTH_SHORT).show();                }            });            Picasso.with(holder.itemView.getContext()).load(datas.get(position)).into(imageView);        }        @Override        public int getItemCount() {            return datas.size();        }    }

由此可见，viewholder类才是我们的核心出发点，我只要在这个类里面完成我们的数据绑定，监听，即可，所以我们现在这么写：

ModelAdapter.ModelviewHolder：

 /**     * hodler抽象类，支持任何数据类型     *     * @param <T>     */    public static abstract class ModelViewHolder<T> extends RecyclerView.ViewHolder {        public ModelViewHolder(View itemView) {            super(itemView);        }        /**         * 这个是我们真正在实际使用的类中的绑定数据的方法         *         * @param item    bean类型         * @param adapter adpter对象         * @param context context对象         * @param positon 位置         */        public abstract void convert(T item, ModelRecyclerAdapter adapter, Context context, int positon);    }

下面是我们的modeladapter类的核心代码：

/** * RecyclerView 通用适配器第一版 * Created by cd5160866 on 16/5/10. */public class ModelRecyclerAdapter<T> extends RecyclerView.Adapter<ModelRecyclerAdapter.ModelViewHolder> {    protected Context mContext;    /**     * 通过注释的方式加入的布局item的layoutId     */    protected int mLayoutId;    /**     * viewholder的实现类类名     */    private Class<? extends ModelViewHolder> viewHolderClass;    /**     * 数据 即我们的任何类型的bean     */    protected List<T> mDatas = new ArrayList<>();    public ModelRecyclerAdapter(Class<ModelViewHolder> viewHolderClass, List<T> Datas) {        this.viewHolderClass = viewHolderClass;        this.mLayoutId = viewHolderClass.getAnnotation(RecyclerItemViewId.class)//获取我们的layoutid，我们的类注释后面的部分                .value();        mDatas = Datas;    }    @Override    public ModelViewHolder onCreateViewHolder(final ViewGroup parent, int viewType) {        ModelViewHolder viewHolder = null;        if (mContext == null)            mContext = parent.getContext();        try {            View converView = LayoutInflater.from(parent.getContext()).inflate(mLayoutId, parent, false);            viewHolder = viewHolderClass.getConstructor(View.class).newInstance(converView);            ButterKnife.bind(viewHolder, converView);//将viewhodler于我们的view绑定起来        } catch (Exception e) {            e.printStackTrace();        }        return viewHolder;    }    @Override    public void onBindViewHolder(ModelViewHolder holder, int position) {        holder.convert(mDatas.get(position), this, mContext, position);//这里更新数据    }    @Override    public int getItemCount() {        return mDatas.size();    }}

首先我们看这个ModelAdapter的第20行，也就是我们的构造的方法，这个方法接收两个参数，其中第二个参数不用多说，当然是我们的数据，第一个参数也就是我们的ModelViewhodler的实现类，adpter会根据这类来创建viewholder，再看第22行，这一行就是我们获取我们的itemId的核心代码，这个布局id不是通过构造方法传进来的，那是怎么获得的呢?没错!就是java注解(Annotation)，至于为何用注解，分析完成后我们就知道了，下面我们新建一个Annotation：

@Retention(RUNTIME)public @interface RecyclerItemViewId {    int value();//我们注解后面使用id值}

关于注解的用法，可以参考：深入理解java注解
所以在最文章最开头我们自己实现的那个ModelViewHolder的实现类上面就是这么写：

 @RecyclerItemViewId(R.layout.item_list)    public static class MyImageViewHolder extends ModelRecyclerAdapter.ModelViewHolder<String> {         //.....    }

然后我们再回过头来看ModelRecyclerAdapter的第22行，我们也就明白了是啥意思了，

 this.mLayoutId = viewHolderClass.getAnnotation(RecyclerItemViewId.class).value();

我们通过传入的我们自己的实现类名去获取我们自定义的注解，再去获取注解的值，也就是我们的layoutId，拿到id以后，当然就是我们在onCreateViewHolder方法中去创建我们的itemview，也就是第34行，再往下看第35行，在这一行我们当然的思路就是要用itemview去创建我们的viewholder实例，因为我们自己的Modelviewhodler是个抽象类，无法直接new,我们当然只能通过它的子类来创建实例，即我们只能通过我们传进来的实现类的类名去获取他的构造方法，当然viewholder本身构造需要view作为参数，所以这里我们需要获取它带View.class的构造方法，所以综合起来，代码就是这么写：

View converView = LayoutInflater.from(context).inflate(mLayoutId, parent, false);            viewHolder = viewHolderClass.getConstructor(View.class).newInstance(converView);

说到最后，当然是我们的butterKnife了，只需一行代码，把我们的viewholder和convertview绑定起来：

ButterKnife.bind(viewHolder, converView);//将viewhodler于我们的view绑定起来

至此，我们就能向一开始一样，在viewholder这个类里面对itemview中的任何一个view进行点击，长按，触摸等各种监听，demo为了简单直观，只写了一个onclick事件：

   /**         * 可以对itemview的任何一个view绑定监听，这里只是以onclick为例，当然也可以绑定onTouch,onLongClick等         */        @OnClick(R.id.iv_item1)        void onclick() {            Toast.makeText(imageView.getContext(), position + " 点击~", Toast.LENGTH_SHORT).show();        }

再回过头来看我们的adapter的代码，去看看45行，也就是onBindViewHolder方法，当然，在这里我们的完成数据的绑定与更新：

@Override    public void onBindViewHolder(ModelViewHolder holder, int position) {        holder.convert(mDatas.get(position), this, mContext, position);//这里更新数据    }

这里调用了我们的viewholder这个抽象方法，我们因此在我们的自己实现的viewholder类里面去实现这个方法完成对我们数据的绑定，比如，我的demo里面依旧是用Picasso去加载一直图片~至此，我们的ModelRecyclerAdapter核心逻辑完成，此外我们再给他封装一些方法，方便他添加数据和删除数据~所以完整代码如下：

最终完成！ ModelRecyclerAdapter：

/** * RecyclerView 通用适配器第一版 * Created by cd5160866 on 16/5/10. */public class ModelRecyclerAdapter<T> extends RecyclerView.Adapter<ModelRecyclerAdapter.ModelViewHolder> {    protected Context mContext;    /**     * 通过注释的方式加入的布局item的layoutId     */    protected int mLayoutId;    /**     * viewholder的实现类类名     */    private Class<? extends ModelViewHolder> viewHolderClass;    /**     * 数据 即我们的任何类型的bean     */    protected List<T> mDatas = new ArrayList<>();    public ModelRecyclerAdapter(Class<ModelViewHolder> viewHolderClass) {        this.viewHolderClass = viewHolderClass;        this.mLayoutId = viewHolderClass.getAnnotation(RecyclerItemViewId.class)                .value();    }    public ModelRecyclerAdapter(Class<ModelViewHolder> viewHolderClass, List<T> Datas) {        this.viewHolderClass = viewHolderClass;        this.mLayoutId = viewHolderClass.getAnnotation(RecyclerItemViewId.class)//获取我们的layoutid，我们的类注释后面的部分                .value();        mDatas = Datas;    }    @Override    public ModelViewHolder onCreateViewHolder(final ViewGroup parent, int viewType) {        ModelViewHolder viewHolder = null;        if (mContext == null)            mContext = parent.getContext();        try {            View converView = LayoutInflater.from(parent.getContext()).inflate(mLayoutId, parent, false);            viewHolder = viewHolderClass.getConstructor(View.class).newInstance(converView);            ButterKnife.bind(viewHolder, converView);//将viewhodler于我们的view绑定起来        } catch (Exception e) {            e.printStackTrace();        }        return viewHolder;    }    @Override    public void onBindViewHolder(ModelViewHolder holder, int position) {        holder.convert(mDatas.get(position), this, mContext, position);//这里更新数据    }    @Override    public int getItemCount() {        return mDatas.size();    }    public void add(int positon, T data) {        mDatas.add(positon, data);        notifyItemInserted(positon);        new Handler().postDelayed(new Runnable() {            @Override            public void run() {                notifyDataSetChanged();            }        }, 500);    }    public void add(T data) {        mDatas.add(data);        notifyDataSetChanged();    }    public void add(List<T> data) {        mDatas.clear();        mDatas.addAll(data);        notifyDataSetChanged();    }    public void remove(int position) {        mDatas.remove(position);        notifyItemRemoved(position);        new Handler().postDelayed(new Runnable() {            @Override            public void run() {                notifyDataSetChanged();            }        }, 500);    }    public void replace(int position, T data) {        mDatas.remove(position);        mDatas.add(position == 0 ? position : position - 1, data);        notifyDataSetChanged();    }    public void addAll(List<T> datas) {        mDatas.addAll(datas);        notifyDataSetChanged();    }    public void clear() {        mDatas.clear();        notifyDataSetChanged();    }    public List<T> getItems() {        return mDatas;    }    /**     * hodler抽象类，支持任何数据类型     *     * @param <T>     */    public static abstract class ModelViewHolder<T> extends RecyclerView.ViewHolder {        public ModelViewHolder(View itemView) {            super(itemView);        }        /**         * 这个是我们真正在实际使用的类中的绑定数据的方法         *         * @param item    bean类型         * @param adapter adpter对象         * @param context context对象         * @param positon 位置         */        public abstract void convert(T item, ModelRecyclerAdapter adapter, Context context, int positon);    }}

声明一下的是第59行的add方法和83行的remove方法是先调用notifyItemRemoved(position)是为了保留插入动画和删除动画效果，但是这个貌似会让position错位，因此再延时去调动notifyDataSetChanged()保证位置正常。

至此我们也就明白了，我们创建我们的recyclerAdapter的时候，只需要在构造方法中传入viewholder的实现类即可，我们在这个类里面完成了对item布局的绑定，事件的监听，数据的绑定，一个类解决所有问题，确实是剩下了不少事，代码也能精简不少。
具体使用方法，大家有兴趣的可以参考demo。

整篇文章跨度较大，包含了java注解，recyclerView，Butterknife,其是网上有很多通用适配器的实现方式，今天这里只是一种实现思路，至此分析完成，有问题请随时沟通，下篇，我将继续在此基础上，为我们的Recyclerview简洁的添加Header，footer和emptyview，祝贺大家寒假愉快，新年加油！↖(^ω^)↗

相关链接：

demo下载

关于butterknife