背景

隨著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，祝賀大家寒假愉快，新年加油！↖(^ω^)↗

相關連結：