RecyclerView Adapter 优雅封装搞定所有列表

转载自: 依然范特稀西

RecycleView加载列表,封装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
看一个示例:

cell_simple.png

如上图:以豆瓣APP的首页为例,文章包含图片和视频的两个Item 的布局是不同的,因此,可以添加两个Cell(ImageCell和VideoCell)来分别处理这两种Item。

有了Cell之后,要向列表添加添加Header和Footer 的需求就很简单了,我们直接添加一个HeaderCell和FooterCell 就可以了,也不用更改Adapter代码,是不是很方便。此外,还可以用Cell实现列表LoadMore(加载更多)状态、Loadding(加载中)状态、Empty(空页面)状态、Error(出错)状态 View的显示。
包结构

rv_pakage.png

介绍: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 接口定义

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,RVBaseCpublic abstract class RVBaseCell implements Cell {

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

@Override
public void releaseResource() {
    // do nothing
    // 如果有需要回收的资源,子类自己实现
}

},接受一个范型T(Cell接受的数据实体),实现了releaseResource方法,但什么事也没干,因为有很多简单的Cell没有资源回收,就不需要实现。如果子类Cell 有资源回收,重写这个方法就可以了。
3, RVBaseViewHolpublic class RVBaseViewHolder extends RecyclerView.ViewHolder{
private SparseArray 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,RVBaseAdappublic abstract class RVBaseAdapter extends RecyclerView.Adapter{
public static final String TAG = “RVBaseAdapter”;
protected List 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);

}aseAdapter 继承 RecyclerView.Adapter,接受的是RVBaseCell类型,保存了一个Cell 列表。其中还有有添加、移除,清空、更新数据的方法。
注意其中几个方法:
1,getItemViewType: 调用的是对应position Cell 的getItemViewType 方法。

2,onCreateViewHolder:调用Cell 的onCreateViewHolder 创建ViewHolder。

3,onBindViewHolder: 调用对应Cell的onBindViewHolder 方法绑定数据

4,onViewDetachedFromWindow: 资源回收
5,RVSimpleAdaptpublic 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);
  }
}

}impleAdapter 是RVBaseAdapter 的默认实现类,添加了显示LoadMore View、Loading View 、Empty View、ErrorView 的功能。
6,AbsBaseFragmpublic abstract class AbsBaseFragment 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);

}BaseFragment,实现了上拉加载和下拉刷新功能,添加Toolbar等,上拉加载可以自定义View,下拉刷新用的是Google的SwipeRefreshLayout。要添加一个列表界面,只需要继承AbsBaseFragment,实现几个抽象方法添加Cell就行了,非常方便。
用法示例:
添加一个多Item的列表:

1,创建一个Fragment继承AbsBaseFragment,实现几个方法。

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类

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);
        }
    }
}
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));
    }

}


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 的完整代码如下:

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不同而已。

瀑布流列表示例:

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
提供了默认的Loading 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);

效果如下:

loading_view.png

还有一种情况是,顶部有一个固定的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_keep_count.png

隐藏Loading View 调用对应hide 方法:

mBaseAdapter.hideLoading();

3, Error View 和 Empty View
显示Error View 和Empty View 与Loading View 的显示与隐藏是一样,不在过多讲,直接去看源码,提供了几个方法:
error_method.png

效果图:这里写图片描述

Empty View 的显示完全一样,就不再讲了。
最后

以上就是对RecyclerView Adapter 的封装和 该库的使用介绍,使用起来非常方便,添加一个列表不再是重复的写Adapter,ViewHolder 等等。添加一个Cell 填充到Adapter 就OK。增加一种Item或者加少一种Item对列表完全没有影响,耦合度几乎为0。更详细的思路分析请看文章RecyclerView 之Adapter的简化过程浅析详细的源码请看Gihub:Adapter优雅封装-CustomAdapter

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
SQLAlchemy 是一个 SQL 工具包和对象关系映射(ORM)库,用于 Python 编程语言。它提供了一个高级的 SQL 工具和对象关系映射工具,允许开发者以 Python 类和对象的形式操作数据库,而无需编写大量的 SQL 语句。SQLAlchemy 建立在 DBAPI 之上,支持多种数据库后端,如 SQLite, MySQL, PostgreSQL 等。 SQLAlchemy 的核心功能: 对象关系映射(ORM): SQLAlchemy 允许开发者使用 Python 类来表示数据库表,使用类的实例表示表中的行。 开发者可以定义类之间的关系(如一对多、多对多),SQLAlchemy 会自动处理这些关系在数据库中的映射。 通过 ORM,开发者可以像操作 Python 对象一样操作数据库,这大大简化了数据库操作的复杂性。 表达式语言: SQLAlchemy 提供了一个丰富的 SQL 表达式语言,允许开发者以 Python 表达式的方式编写复杂的 SQL 查询。 表达式语言提供了对 SQL 语句的灵活控制,同时保持了代码的可读性和可维护性。 数据库引擎和连接池: SQLAlchemy 支持多种数据库后端,并且为每种后端提供了对应的数据库引擎。 它还提供了连接池管理功能,以优化数据库连接的创建、使用和释放。 会话管理: SQLAlchemy 使用会话(Session)来管理对象的持久化状态。 会话提供了一个工作单元(unit of work)和身份映射(identity map)的概念,使得对象的状态管理和查询更加高效。 事件系统: SQLAlchemy 提供了一个事件系统,允许开发者在 ORM 的各个生命周期阶段插入自定义的钩子函数。 这使得开发者可以在对象加载、修改、删除等操作时执行额外的逻辑。
SQLAlchemy 是一个 SQL 工具包和对象关系映射(ORM)库,用于 Python 编程语言。它提供了一个高级的 SQL 工具和对象关系映射工具,允许开发者以 Python 类和对象的形式操作数据库,而无需编写大量的 SQL 语句。SQLAlchemy 建立在 DBAPI 之上,支持多种数据库后端,如 SQLite, MySQL, PostgreSQL 等。 SQLAlchemy 的核心功能: 对象关系映射(ORM): SQLAlchemy 允许开发者使用 Python 类来表示数据库表,使用类的实例表示表中的行。 开发者可以定义类之间的关系(如一对多、多对多),SQLAlchemy 会自动处理这些关系在数据库中的映射。 通过 ORM,开发者可以像操作 Python 对象一样操作数据库,这大大简化了数据库操作的复杂性。 表达式语言: SQLAlchemy 提供了一个丰富的 SQL 表达式语言,允许开发者以 Python 表达式的方式编写复杂的 SQL 查询。 表达式语言提供了对 SQL 语句的灵活控制,同时保持了代码的可读性和可维护性。 数据库引擎和连接池: SQLAlchemy 支持多种数据库后端,并且为每种后端提供了对应的数据库引擎。 它还提供了连接池管理功能,以优化数据库连接的创建、使用和释放。 会话管理: SQLAlchemy 使用会话(Session)来管理对象的持久化状态。 会话提供了一个工作单元(unit of work)和身份映射(identity map)的概念,使得对象的状态管理和查询更加高效。 事件系统: SQLAlchemy 提供了一个事件系统,允许开发者在 ORM 的各个生命周期阶段插入自定义的钩子函数。 这使得开发者可以在对象加载、修改、删除等操作时执行额外的逻辑。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值