RecyclerView Adapter 優雅封裝，一個Adapter搞定所有列表

專案中，我們用得最多的元素就是列表了，在Android 中，實現列表用原生的RecyclerView就能滿足需求，關於RecyclerView 的基礎使用這裡不做過多的介紹，網上有太多的博文介紹了。本篇文章將介紹自己封裝的一個Adapter,幫你快速高效的新增一個列表(包括單 Item 列表和多item列表)。

理念

1, 構造一個通用的Adapter模版，避免每新增一個列表就要寫一個Adapter,避免寫Adapter中的大量重複程式碼。
2，通過組裝的方式來構建Adapter,將每一種(ViewType不同的)Item抽象成一個單獨元件，Adapter 就是一個殼，我們只需要向Adapter中新增Item就行，這樣做的好處就是減少耦合，去掉一種item 或者新增一種item對於列表是沒有任何影響的。
3,高內聚，低耦合，擴充套件方便。

思路

為每一種 viewType 定義一個Cell,Cell就是上面提到的獨立元件，它負責建立ViewHolder,資料繫結和邏輯處理。它有2個重要的方法，onCreateViewHolder 負責建立ViewHolder,onBindViewHolder負責資料繫結，這兩個方法的定義和生命週期同Adapter種的2個方法一樣，事實上,Adapter 中的onCreateViewHolder和onBindViewHolder 最終呼叫的是Cell中的方法。

一種 ViewType 對應一個Cell
看一個示例：

如上圖：以豆瓣APP的首頁為例，文章包含圖片和視訊的兩個Item 的佈局是不同的，因此，可以新增兩個Cell（ImageCell和VideoCell）來分別處理這兩種Item。

有了Cell之後，要向列表新增新增Header和Footer 的需求就很簡單了，我們直接新增一個HeaderCell和FooterCell 就可以了，也不用更改Adapter程式碼,是不是很方便。此外，還可以用Cell實現列表LoadMore(載入更多)狀態、Loadding（載入中）狀態、Empty(空頁面)狀態、Error(出錯)狀態 View的顯示。

包結構

介紹：1,base:base包下面為Lib的主要程式碼，一個Cell介面和三個抽象類，分別抽取了Adapter,ViewHolder,Cell的公共邏輯。
2,cell:cell包下面有4個cell,分別顯示列表的LoadMore,Loading,Empty,Error狀態。
3,fragment:有一個Fragment抽象類，定義了一個UI模版（不需要額外新增布局檔案），要實現列表的介面只需要繼承AbsBaseFragment，實現幾個方法新增資料就OK。

具體程式碼

1,Cell 介面定義

/**
 * Created by zhouwei on 17/1/19.
 */

public interface Cell {
    /**
     * 回收資源
     *
     */
    public void releaseResource();

    /**
     * 獲取viewType
     * @return
     */
    public  int getItemType();

    /**
     * 建立ViewHolder
     * @param parent
     * @param viewType
     * @return
     */
    public RVBaseViewHolder onCreateViewHolder(ViewGroup parent, int viewType);

    /**
     * 資料繫結
     * @param holder
     * @param position
     */
    public  void onBindViewHolder(RVBaseViewHolder holder, int position);
}複製程式碼

定義了4個方法，除了回收資源的方法releaseResource（），其它三個和Adapter中的一樣。

2,RVBaseCell

/**
 * Created by zhouwei on 17/1/19.
 */

public  abstract class RVBaseCell<T> implements Cell {

    public RVBaseCell(T t){
        mData = t;
    }
    public T mData;

    @Override
    public void releaseResource() {
        // do nothing
        // 如果有需要回收的資源，子類自己實現
    }
}複製程式碼

抽象類，接受一個範型T(Cell接受的資料實體)，實現了releaseResource方法，但什麼事也沒幹，因為有很多簡單的Cell沒有資源回收，就不需要實現。如果子類Cell 有資源回收，重寫這個方法就可以了。

3, RVBaseViewHolder

/**
 * Created by zhouwei on 17/1/19.
 */

public class RVBaseViewHolder extends RecyclerView.ViewHolder{
    private SparseArray<View> views;
    private View mItemView;
    public RVBaseViewHolder(View itemView) {
        super(itemView);
        views = new SparseArray<>();
        mItemView = itemView;

    }

    /**
     * 獲取ItemView
     * @return
     */
    public View getItemView() {
        return mItemView;
    }

    public View getView(int resId) {
        return retrieveView(resId);
    }

    public TextView getTextView(int resId){
        return retrieveView(resId);
    }

    public ImageView getImageView(int resId){
        return retrieveView(resId);
    }

    public Button getButton(int resId){
        return retrieveView(resId);
    }

    @SuppressWarnings("unchecked")
    protected <V extends View> V retrieveView(int viewId){
        View view = views.get(viewId);
        if(view == null){
            view = mItemView.findViewById(viewId);
            views.put(viewId,view);
        }
        return (V) view;
    }

    public void setText(int resId,CharSequence text){
          getTextView(resId).setText(text);
    }

    public void setText(int resId,int strId){
        getTextView(resId).setText(strId);
    }

}複製程式碼

以前寫Adapter的時候，每一種viewType 都對應了一個ViewHolder,其中有大量的findViewById繫結檢視，有了RVBaseViewHolder，再也不需要定義ViewHolder了，通過id獲取View就行，View用SparseArray 儲存進行了複用，避免每一次都find。

4,RVBaseAdapter

/**
 * Created by zhouwei on 17/1/19.
 */

public   abstract class RVBaseAdapter<C extends RVBaseCell>  extends RecyclerView.Adapter<RVBaseViewHolder>{
    public static final String TAG = "RVBaseAdapter";
    protected List<C> mData;

    public RVBaseAdapter(){
        mData = new ArrayList<>();
    }

    public void setData(List<C> data) {
        addAll(data);
        notifyDataSetChanged();
    }

    public List<C> getData() {
        return mData;
    }

    @Override
    public RVBaseViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        for(int i=0;i<getItemCount();i++){
            if(viewType == mData.get(i).getItemType()){
                return mData.get(i).onCreateViewHolder(parent,viewType);
            }
        }

        throw new RuntimeException("wrong viewType");
    }

    @Override
    public void onBindViewHolder(RVBaseViewHolder holder, int position) {
        mData.get(position).onBindViewHolder(holder,position);
    }

    @Override
    public void onViewDetachedFromWindow(RVBaseViewHolder holder) {
        super.onViewDetachedFromWindow(holder);
        Log.e(TAG,"onViewDetachedFromWindow invoke...");
        //釋放資源
        int position = holder.getAdapterPosition();
        //越界檢查
        if(position<0 || position>=mData.size()){
            return;
        }
        mData.get(position).releaseResource();
    }


    @Override
    public int getItemCount() {
        return mData == null ? 0:mData.size();
    }

    @Override
    public int getItemViewType(int position) {
        return mData.get(position).getItemType();
    }

    /**
     * add one cell
     * @param cell
     */
    public void add(C cell){
         mData.add(cell);
         int index = mData.indexOf(cell);
         notifyItemChanged(index);
    }

    public void add(int index,C cell){
        mData.add(index,cell);
        notifyItemChanged(index);
    }

    /**
     * remove a cell
     * @param cell
     */
    public void remove(C cell){
        int indexOfCell = mData.indexOf(cell);
        remove(indexOfCell);
    }

    public void remove(int index){
        mData.remove(index);
        notifyItemRemoved(index);
    }

    /**
     *
     * @param start
     * @param count
     */
    public void remove(int start,int count){
        if((start +count) > mData.size()){
            return;
        }
        int size = getItemCount();
        for(int i =start;i<size;i++){
            mData.remove(i);
        }

        notifyItemRangeRemoved(start,count);
    }




    /**
     * add a cell list
     * @param cells
     */
    public void addAll(List<C> cells){
        if(cells == null || cells.size() == 0){
            return;
        }
        Log.e("zhouwei","addAll cell size:"+cells.size());
        mData.addAll(cells);
        notifyItemRangeChanged(mData.size()-cells.size(),mData.size());
    }

    public void addAll(int index,List<C> cells){
        if(cells == null || cells.size() == 0){
            return;
        }
        mData.addAll(index,cells);
        notifyItemRangeChanged(index,index+cells.size());
    }

    public void clear(){
        mData.clear();
        notifyDataSetChanged();
    }


    /**
     * 如果子類需要在onBindViewHolder 回撥的時候做的操作可以在這個方法裡做
     * @param holder
     * @param position
     */
    protected abstract void onViewHolderBound(RVBaseViewHolder holder, int position);

}複製程式碼

RVBaseAdapter 繼承 RecyclerView.Adapter，接受的是RVBaseCell型別，儲存了一個Cell 列表。其中還有有新增、移除，清空、更新資料的方法。
注意其中幾個方法：
1，getItemViewType： 呼叫的是對應position Cell 的getItemViewType 方法。

2，onCreateViewHolder：呼叫Cell 的onCreateViewHolder 建立ViewHolder。

3，onBindViewHolder： 呼叫對應Cell的onBindViewHolder 方法繫結資料

4，onViewDetachedFromWindow： 資源回收

5,RVSimpleAdapter

/**
 * Created by zhouwei on 17/1/23.
 */

public class RVSimpleAdapter extends RVBaseAdapter{
    public static final int ERROR_TYPE = Integer.MAX_VALUE -1;
    public static final int EMPTY_TYPE = Integer.MAX_VALUE -2;
    public static final int LOADING_TYPE = Integer.MAX_VALUE -3;
    public static final int LOAD_MORE_TYPE = Integer.MAX_VALUE -4;

    private EmptyCell mEmptyCell;
    private ErrorCell mErrorCell;
    private LoadingCell mLoadingCell;
    private LoadMoreCell mLoadMoreCell;
    //LoadMore 是否已顯示
    private boolean mIsShowLoadMore = false;

    public RVSimpleAdapter(){
        mEmptyCell = new EmptyCell(null);
        mErrorCell = new ErrorCell(null);
        mLoadingCell = new LoadingCell(null);
        mLoadMoreCell = new LoadMoreCell(null);
    }
    @Override
    protected void onViewHolderBound(RVBaseViewHolder holder, int position) {

    }

    @Override
    public void onAttachedToRecyclerView(RecyclerView recyclerView) {
        super.onAttachedToRecyclerView(recyclerView);
        RecyclerView.LayoutManager manager = recyclerView.getLayoutManager();
        //處理GridView 佈局
        if(manager instanceof GridLayoutManager){
            final GridLayoutManager gridLayoutManager = (GridLayoutManager) manager;
            gridLayoutManager.setSpanSizeLookup(new GridLayoutManager.SpanSizeLookup() {
                @Override
                public int getSpanSize(int position) {
                    int viewType = getItemViewType(position);
                    return (viewType == ERROR_TYPE|| viewType == EMPTY_TYPE || viewType == LOADING_TYPE
                    ||viewType == LOAD_MORE_TYPE) ? gridLayoutManager.getSpanCount():1;
                }
            });
        }

    }

    @Override
    public void onViewAttachedToWindow(RecyclerView.ViewHolder holder) {
        // 處理StaggeredGridLayoutManager 顯示這個Span
        int position = holder.getAdapterPosition();
        int viewType = getItemViewType(position);
        if(isStaggeredGridLayout(holder)){
            if(viewType == ERROR_TYPE|| viewType == EMPTY_TYPE || viewType == LOADING_TYPE
                    ||viewType == LOAD_MORE_TYPE){

                StaggeredGridLayoutManager.LayoutParams params = (StaggeredGridLayoutManager.LayoutParams) holder.itemView.getLayoutParams();
                //設定顯示整個span
                params.setFullSpan(true);
            }
        }

    }

    private boolean isStaggeredGridLayout(RecyclerView.ViewHolder holder) {
        ViewGroup.LayoutParams layoutParams = holder.itemView.getLayoutParams();
        if (layoutParams != null && layoutParams instanceof StaggeredGridLayoutManager.LayoutParams) {
            return true;
        }
        return false;
    }

    /**
     * 顯示LoadingView
     * <p>請求資料時呼叫，資料請求完畢時呼叫{@link #hideLoading }</p>
     * @see #showLoadingKeepCount(int)
     */
    public void showLoading(){
      clear();
      add(mLoadingCell);
    }

    public void showLoading(View loadingView){
        if(loadingView == null){
            showLoading();
        }
        clear();
        mLoadingCell.setLoadingView(loadingView);
        add(mLoadingCell);
    }
    /**
     * 顯示LoadingView
     * <p>列表顯示LoadingView並保留keepCount個Item</p>
     * @param keepCount 保留的條目數量
     */
    public void showLoadingKeepCount(int keepCount){
        if(keepCount < 0 || keepCount>mData.size()){
            return;
        }
        remove(keepCount,mData.size() - keepCount);
        if(mData.contains(mLoadingCell)){
            mData.remove(mLoadingCell);
        }
        add(mLoadingCell);
    }
    /**
     * hide Loading view
     */
    public void hideLoading(){
        if(mData.contains(mLoadingCell)){
            mData.remove(mLoadingCell);
        }
    }

    /**
     * 顯示錯誤提示
     * <p>當網路請求發生錯誤，需要在介面給出錯誤提示時，呼叫{@link #showError}</p>
     * @see #showErrorKeepCount(int)
     */
    public void showError(){
       clear();
       add(mErrorCell);
    }

    /**
     * 顯示錯誤提示
     * <p>當網路請求發生錯誤，需要在介面給出錯誤提示時，呼叫{@link #showErrorKeepCount(int)},並保留keepCount 條Item</p>
     * @param keepCount 保留Item數量
     */
    public void showErrorKeepCount(int keepCount){
        if(keepCount < 0 || keepCount>mData.size()){
            return;
        }
        remove(keepCount,mData.size() - keepCount);
        if(mData.contains(mErrorCell)){
            mData.remove(mErrorCell);
        }
        add(mErrorCell);

    }

    /**
     * 隱藏錯誤提示
     */
    public void hideErorr(){
       if(mData.contains(mErrorCell)){
           remove(mErrorCell);
       }
    }

    /**
     * 顯示LoadMoreView
     * <p>當列表滑動到底部時，呼叫{@link #showLoadMore()} 提示載入更多，載入完資料，呼叫{@link #hideLoadMore()}
     * 隱藏LoadMoreView,顯示列表資料。</p>
     *
     */
    public void showLoadMore(){
       if(mData.contains(mLoadMoreCell)){
           return;
       }
       add(mLoadMoreCell);
       mIsShowLoadMore = true;
    }

    /**
     * 隱藏LoadMoreView
     * <p>呼叫{@link #showLoadMore()}之後，載入資料完成，呼叫{@link #hideLoadMore()}隱藏LoadMoreView</p>
     */
    public void hideLoadMore(){
       if(mData.contains(mLoadMoreCell)){
           remove(mLoadMoreCell);
           mIsShowLoadMore = false;
       }
    }

    /**
     * LoadMore View 是否已經顯示
     * @return
     */
    public boolean isShowLoadMore() {
        return mIsShowLoadMore;
    }

    /**
     *
     * @param keepCount
     */
    public void showEmptyKeepCount(int keepCount){
        if(keepCount < 0 || keepCount>mData.size()){
            return;
        }
        remove(keepCount,mData.size() - keepCount);
        if(mData.contains(mEmptyCell)){
            mData.remove(mEmptyCell);
        }
        add(mEmptyCell);

    }

    /**
     * 顯示空view
     * <p>當頁面沒有資料的時候，呼叫{@link #showEmpty()}顯示空View，給使用者提示</p>
     */
    public void showEmpty(){
      clear();
      add(mEmptyCell);
    }

    /**
     * 隱藏空View
     */
    public void hideEmpty(){
      if(mData.contains(mEmptyCell)){
          remove(mEmptyCell);
      }
    }
}複製程式碼

RVSimpleAdapter 是RVBaseAdapter 的預設實現類，新增了顯示LoadMore View、Loading View 、Empty View、ErrorView 的功能。

6，AbsBaseFragment

/**
 * Created by zhouwei on 17/2/3.
 */

public abstract class AbsBaseFragment<T> extends Fragment {
    protected RecyclerView mRecyclerView;
    protected RVSimpleAdapter mBaseAdapter;
    private FrameLayout mToolbarContainer;
    protected SwipeRefreshLayout mSwipeRefreshLayout;
    /**
     * RecyclerView 最後可見Item在Adapter中的位置
     */
    private int mLastVisiblePosition = -1;

    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        View view =  inflater.inflate(R.layout.base_fragment_layout,null);
        return view;
    }

    @Override
    public void onViewCreated(View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        mSwipeRefreshLayout = (SwipeRefreshLayout) view.findViewById(R.id.base_refresh_layout);
        mToolbarContainer = (FrameLayout) view.findViewById(R.id.toolbar_container);
        mRecyclerView = (RecyclerView) view.findViewById(R.id.base_fragment_rv);
        mRecyclerView.setLayoutManager(initLayoutManger());
        mBaseAdapter = initAdapter();
        mRecyclerView.setAdapter(mBaseAdapter);
        mSwipeRefreshLayout.setOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
            @Override
            public void onRefresh() {
                setRefreshing(true);
                onPullRefresh();
            }
        });
        mRecyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
            @Override
            public void onScrolled(RecyclerView recyclerView, int dx, int dy) {

                RecyclerView.LayoutManager layoutManager = recyclerView.getLayoutManager();
                if(layoutManager instanceof LinearLayoutManager){
                    mLastVisiblePosition = ((LinearLayoutManager)layoutManager).findLastVisibleItemPosition();
                }else if(layoutManager instanceof GridLayoutManager){
                    mLastVisiblePosition = ((GridLayoutManager)layoutManager).findLastVisibleItemPosition();
                }else if(layoutManager instanceof StaggeredGridLayoutManager){
                    StaggeredGridLayoutManager staggeredGridLayoutManager = (StaggeredGridLayoutManager) layoutManager;
                    int []lastPositions = new int[staggeredGridLayoutManager.getSpanCount()];
                    staggeredGridLayoutManager.findLastVisibleItemPositions(lastPositions);
                    mLastVisiblePosition = findMax(lastPositions);
                }
            }

            @Override
            public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
                View firstView = recyclerView.getChildAt(0);
                int top = firstView.getTop();
                int topEdge = recyclerView.getPaddingTop();
                //判斷RecyclerView 的ItemView是否滿屏，如果不滿一屏，上拉不會觸發載入更多
                boolean isFullScreen = top < topEdge;

                RecyclerView.LayoutManager manager = recyclerView.getLayoutManager();
                int itemCount = manager.getItemCount();
                //因為LoadMore View  是Adapter的一個Item,顯示LoadMore 的時候，Item數量＋1了，導致 mLastVisibalePosition == itemCount-1
                // 判斷兩次都成立，因此必須加一個判斷條件 !mBaseAdapter.isShowLoadMore()
                if(newState == RecyclerView.SCROLL_STATE_IDLE && mLastVisiblePosition == itemCount-1 && isFullScreen && !mBaseAdapter.isShowLoadMore()){
                   //最後一個Item了
                   mBaseAdapter.showLoadMore();
                   onLoadMore();
                }
            }
        });
        View toolbarView = addToolbar();
        if(toolbarView!=null && mToolbarContainer!=null
                ){
            mToolbarContainer.addView(toolbarView);
        }
        onRecyclerViewInitialized();

    }

    /**
     * hide load more progress
     */
    public void hideLoadMore(){
        if(mBaseAdapter!=null){
            mBaseAdapter.hideLoadMore();
        }
    }

    /**
     * 獲取組數最大值
     * @param lastPositions
     * @return
     */
    private int findMax(int[] lastPositions) {
        int max = lastPositions[0];
        for (int value : lastPositions) {
            if (value > max) {
                max = value;
            }
        }
        return max;
    }

    /**
     * 設定重新整理進度條的顏色
     * see{@link SwipeRefreshLayout#setColorSchemeResources(int...)}
     * @param colorResIds
     */
    public void setColorSchemeResources(@ColorRes int... colorResIds){
        if(mSwipeRefreshLayout!=null){
            mSwipeRefreshLayout.setColorSchemeResources(colorResIds);
        }
    }

    /**
     * 設定重新整理進度條的顏色
     * see{@link SwipeRefreshLayout#setColorSchemeColors(int...)}
     * @param colors
     */
    public void setColorSchemeColors(int... colors){
        if(mSwipeRefreshLayout!=null){
            mSwipeRefreshLayout.setColorSchemeColors(colors);
        }
    }

    /**
     * 設定重新整理進度條背景色
     *  see{@link SwipeRefreshLayout#setProgressBackgroundColorSchemeResource(int)} (int)}
     * @param colorRes
     */
    public void setProgressBackgroundColorSchemeResource(@ColorRes int colorRes) {
         if(mSwipeRefreshLayout!=null){
             mSwipeRefreshLayout.setProgressBackgroundColorSchemeResource(colorRes);
         }
    }

    /**
     * 設定重新整理進度條背景色
     *  see{@link SwipeRefreshLayout#setProgressBackgroundColorSchemeColor(int)}
     * @param color
     */
    public void setProgressBackgroundColorSchemeColor(@ColorInt int color) {
       if(mSwipeRefreshLayout!=null){
           mSwipeRefreshLayout.setProgressBackgroundColorSchemeColor(color);
       }
    }

    /**
     * Notify the widget that refresh state has changed. Do not call this when
     * refresh is triggered by a swipe gesture.
     *
     * @param refreshing Whether or not the view should show refresh progress.
     */
    public void setRefreshing(boolean refreshing){
        if(mSwipeRefreshLayout== null){
            return;
        }
        mSwipeRefreshLayout.setRefreshing(refreshing);
    }

    /**
     * 子類可以自己指定Adapter,如果不指定預設RVSimpleAdapter
     * @return
     */
    protected RVSimpleAdapter initAdapter(){
        return new RVSimpleAdapter();
    }

    /**
     * 子類自己指定RecyclerView的LayoutManager,如果不指定，預設為LinearLayoutManager,VERTICAL 方向
     * @return
     */
    protected RecyclerView.LayoutManager initLayoutManger(){
        LinearLayoutManager manager = new LinearLayoutManager(getContext());
        manager.setOrientation(LinearLayoutManager.VERTICAL);
        return manager;
    }

    /**
     * 新增TitleBar
     * @param
     */
    public View addToolbar(){
      //如果需要Toolbar,子類返回Toolbar View
      return null;
    }

    /**
     *RecyclerView 初始化完畢，可以在這個方法裡繫結資料
     */
    public abstract void onRecyclerViewInitialized();

    /**
     * 下拉重新整理
     */
    public abstract void onPullRefresh();

    /**
     * 上拉載入更多
     */
    public abstract void onLoadMore();

    /**
     *  根據實體生成對應的Cell
     * @param list  實體列表
     * @return cell列表
     */
    protected abstract  List<Cell> getCells(List<T> list);

}複製程式碼

AbsBaseFragment，實現了上拉載入和下拉重新整理功能，新增Toolbar等，上拉載入可以自定義View，下拉重新整理用的是Google的SwipeRefreshLayout。要新增一個列表介面，只需要繼承AbsBaseFragment，實現幾個抽象方法新增Cell就行了，非常方便。

用法示例：

新增一個多Item的列表:

1，建立一個Fragment繼承AbsBaseFragment，實現幾個方法。

/**
 * Created by zhouwei on 17/2/3.
 */

public class HomePageFragment extends AbsBaseFragment<Entry> {
    @Override
    public void onRecyclerViewInitialized() {
       //初始化View和資料載入 
    }

    @Override
    public void onPullRefresh() {
        //下拉重新整理回撥

    }

    @Override
    public void onLoadMore() {
        //上拉載入回撥
    }
    protected List<Cell> getCells(List<Entry> entries){
        //根據實體生成Cell
        return null;
    }

}複製程式碼

實現上面幾個抽象方法，實際上只實現onRecyclerViewInitialized和getCells兩個方法就可以實現列表，其它兩個方法是下拉重新整理和上拉載入的。

2,建立Cell類

/**
 * Created by zhouwei on 17/2/7.
 */

public class BannerCell extends RVBaseCell<List<String>> {
    public static final int TYPE = 2;
    private ConvenientBanner mConvenientBanner;
    public BannerCell(List<String> strings) {
        super(strings);
    }

    @Override
    public int getItemType() {
        return TYPE;
    }

    @Override
    public RVBaseViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        return new RVBaseViewHolder(LayoutInflater.from(parent.getContext()).inflate(R.layout.grid_cell_layoout,null));
    }

    @Override
    public void onBindViewHolder(RVBaseViewHolder holder, int position) {
       mConvenientBanner = (ConvenientBanner) holder.getView(R.id.banner);
        mConvenientBanner.setPages(new CBViewHolderCreator<NetworkImageHolderView>() {
            @Override
            public NetworkImageHolderView createHolder() {
                return new NetworkImageHolderView();
            }
        }, mData);
        mConvenientBanner.startTurning(2000);
    }

    @Override
    public void releaseResource() {
        if(mConvenientBanner!=null){
            mConvenientBanner.stopTurning();
        }
    }

    public static class NetworkImageHolderView implements CBPageAdapter.Holder<String>{
        private ImageView imageView;
        @Override
        public View createView(Context context) {
            imageView = new ImageView(context);
            imageView.setScaleType(ImageView.ScaleType.CENTER_CROP);
            return imageView;
        }

        @Override
        public void UpdateUI(Context context, int position, String data) {
            ImageLoader.getInstance().displayImage(data,imageView);
        }
    }
}複製程式碼

/**
 * Created by zhouwei on 17/1/19.
 */

public class ImageCell extends RVBaseCell<Entry> {
    public static final int TYPE = 1;
    public ImageCell(Entry entry) {
        super(entry);
    }

    @Override
    public int getItemType() {
        return TYPE;
    }

    @Override
    public RVBaseViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        return new RVBaseViewHolder(LayoutInflater.from(parent.getContext()).inflate(R.layout.image_cell_layout,null));
    }

    @Override
    public void onBindViewHolder(RVBaseViewHolder holder, int position) {
        Picasso.with(holder.getItemView().getContext()).load(mData.imageUrl).into(holder.getImageView(R.id.image));
    }

}複製程式碼

/**
 * Created by zhouwei on 17/1/19.
 */

public class TextCell extends RVBaseCell<Entry> {
    public static final int TYPE = 0;
    public TextCell(Entry entry) {
        super(entry);
    }

    @Override
    public int getItemType() {
        return TYPE;
    }

    @Override
    public RVBaseViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        return new RVBaseViewHolder(LayoutInflater.from(parent.getContext()).inflate(R.layout.text_cell_layout,null));
    }

    @Override
    public void onBindViewHolder(RVBaseViewHolder holder, int position) {
       holder.setText(R.id.text_content,mData.content);
    }
}複製程式碼

上面建立了3個Cell,也就是這個列表包含了3種不同型別的Item。

注意：一個列表內，每個Cell 的TYPE要不相同，也就是getItemType方法的返回值要不同。

3，onRecyclerViewInitialized ，做初始化和載入資料

@Override
    public void onRecyclerViewInitialized() {
       //初始化View和資料載入
       //設定重新整理進度條顏色
       setColorSchemeResources(R.color.colorAccent);
       loadData();
    }

    /**
     * 模擬從伺服器取資料
     */
    private void loadData(){
        View loadingView = LayoutInflater.from(getContext()).inflate(R.layout.manu_loading_layout,null);
        mBaseAdapter.showLoading(loadingView);
        mRecyclerView.postDelayed(new Runnable() {
            @Override
            public void run() {
                mBaseAdapter.hideLoading();
                mBaseAdapter.addAll(getCells(mockData()));
            }
        },2000);
    }複製程式碼

4,實現getCells方法，生成Cell

   protected List<Cell> getCells(List<Entry> entries){
        //根據實體生成Cell
        List<Cell> cells = new ArrayList<>();
        cells.add(new BannerCell(Arrays.asList(DataMocker.images)));
        for (int i=0;i<entries.size();i++){
            Entry entry = entries.get(i);
            if(entry.type == Entry.TYPE_IMAGE){
                cells.add(new ImageCell(entry));
            }else{
                cells.add(new TextCell(entry));
            }
        }
        return cells;
    }複製程式碼

上面根據實體生成不同的Cell。有三種Cell,BannerCell,ImageCell和TextCell。

以上4個步驟就能實現一個介面複雜包含多做Item的列表了效果圖如下：

HomePageFragment 的完整程式碼如下：

/**
 * Created by zhouwei on 17/2/3.
 */

public class HomePageFragment extends AbsBaseFragment<Entry> {
    @Override
    public void onRecyclerViewInitialized() {
       //初始化View和資料載入
       //設定重新整理進度條顏色
       setColorSchemeResources(R.color.colorAccent);
       loadData();
    }

    @Override
    public void onPullRefresh() {
        //下拉重新整理回撥
        mRecyclerView.postDelayed(new Runnable() {
            @Override
            public void run() {
               setRefreshing(false);
            }
        },2000);
    }

    @Override
    public void onLoadMore() {
        //上拉載入回撥
       loadMore();
    }


    private void loadMore(){
        mRecyclerView.postDelayed(new Runnable() {
            @Override
            public void run() {
                hideLoadMore();
                mBaseAdapter.addAll(getCells(mockMoreData()));
            }
        },10000);
    }

    protected List<Cell> getCells(List<Entry> entries){
        //根據實體生成Cell
        List<Cell> cells = new ArrayList<>();
        cells.add(new BannerCell(Arrays.asList(DataMocker.images)));
        for (int i=0;i<entries.size();i++){
            Entry entry = entries.get(i);
            if(entry.type == Entry.TYPE_IMAGE){
                cells.add(new ImageCell(entry));
            }else{
                cells.add(new TextCell(entry));
            }
        }
        return cells;
    }


    @Override
    public View addToolbar() {
        View toolbar = LayoutInflater.from(getContext()).inflate(R.layout.title_bar_layout,null);
        return toolbar;
    }

    /**
     * 模擬從伺服器取資料
     */
    private void loadData(){
        View loadingView = LayoutInflater.from(getContext()).inflate(R.layout.manu_loading_layout,null);
        mBaseAdapter.showLoading(loadingView);
        mRecyclerView.postDelayed(new Runnable() {
            @Override
            public void run() {
                mBaseAdapter.hideLoading();
                mBaseAdapter.addAll(getCells(mockData()));
            }
        },2000);
    }
}複製程式碼

Grid 列表和瀑布流列表：

上面演示了新增多Item type 的列表，新增單Item的列表也是一樣的，只不過只有一個Cell而已。新增Grid 列表和瀑布流列表差不多的，只是RecylerView 的LayoutManager不同而已。

瀑布流列表示例：

/**
 * Created by zhouwei on 17/2/4.
 */

public class DetailFragment extends AbsBaseFragment<DetailEntry> {
    @Override
    public void onRecyclerViewInitialized() {
         mBaseAdapter.setData(getCells(mockStaggerData()));
    }

    @Override
    public void onPullRefresh() {

    }

    @Override
    public void onLoadMore() {

    }

    @Override
    protected RecyclerView.LayoutManager initLayoutManger() {
        StaggeredGridLayoutManager layoutManager = new StaggeredGridLayoutManager(2,StaggeredGridLayoutManager.VERTICAL);
        return layoutManager;
    }

    @Override
    protected List<Cell> getCells(List<DetailEntry> list) {
        List<Cell> cells = new ArrayList<>();
        for (int i=0;i<list.size();i++){
            cells.add(new DetailCell(list.get(i)));
        }
        return cells;
    }

}複製程式碼

只需要重寫initLayoutManager這個方法，返回一個瀑布流的LayoutMannger就可以了。
效果如下：

其它演示示例：LoadMore View、Loading View 、Error View ，Empty View

1,顯示LoadMore View
提供了預設的LoadMore View，呼叫程式碼如下：

 mBaseAdapter.showLoadMore();複製程式碼

如果不想用預設的LoadMore View，當然也可以自定義LoadMore View，Adapter 提供方法：

mBaseAdapter.showLoadMore(loadMoreView);複製程式碼

像上面這樣提供一個LoadMore View 的佈局，還有一個過載的方法，可以指定顯示的高度：

   mBaseAdapter.showLoadMore(loadMoreView,100);複製程式碼

如果是繼承的AbsBaseFragment 建立列表，實現customLoadMoreView方法就ok了：

 @Override
    protected View customLoadMoreView() {
        View loadMoreView = LayoutInflater.from(getContext()).inflate(R.layout.custeom_load_more_layout,null);
        return loadMoreView;
    }複製程式碼

隱藏LoadMore View 呼叫如下程式碼：

 if(mBaseAdapter!=null){
            mBaseAdapter.hideLoadMore();
   }複製程式碼

效果圖看上面演示的瀑布流效果圖。

2,顯示loading View
提供了預設的Loading View，呼叫程式碼如下：

 mBaseAdapter.showLoading();複製程式碼

當然也可以自定義Loading View，提供一個佈局即可：

View loadingView = LayoutInflater.from(getContext()).inflate(R.layout.manu_loading_layout,null);
 mBaseAdapter.showLoading(loadingView);複製程式碼

效果如下：

還有一種情況是，頂部有一個固定的HeaderCell，不需要載入資料，顯示靜態頁面，下面載入資料時需要Loading態，Error狀態，Empty狀態等等。提供如下3個方法：

• showLoadingKeepCount(int keepCount,int height,View loadingView)
  列表Loading狀態顯示的View，保留keepCountg個Item，並指定高度，指定顯示的View

• showLoadingKeepCount(int keepCount,int height)
  列表Loading狀態顯示的View，保留keepCountg個Item，並指定高度（顯示的是提供的預設Loading View）

• showLoadingKeepCount(int keepCount)
  顯示預設LoadingView

使用程式碼如下：

 View loadingView = LayoutInflater.from(getContext()).inflate(R.layout.manu_loading_layout,null);
mBaseAdapter.showLoadingKeepCount(1,height,loadingView);複製程式碼

效果圖如下：

隱藏Loading View 呼叫對應hide 方法：

 mBaseAdapter.hideLoading();複製程式碼

3, Error View 和 Empty View
顯示Error View 和Empty View 與Loading View 的顯示與隱藏是一樣，不在過多講，直接去看原始碼，提供了幾個方法：

效果圖：

Empty View 的顯示完全一樣，就不再講了。

最後

以上就是對RecyclerView Adapter 的封裝和 該庫的使用介紹，使用起來非常方便，新增一個列表不再是重複的寫Adapter,ViewHolder 等等。新增一個Cell 填充到Adapter 就OK。增加一種Item或者加少一種Item對列表完全沒有影響，耦合度幾乎為0。詳細的原始碼請看Gihub:
Adapter優雅封裝－CustomAdapter,歡迎star和follow。