Android HeaderAndFooterRecyclerView、ExRecyclerView、PullRefreshLoadRecyclerView、PowerfulRecyclerView

文章转自：http://blog.csdn.net/jdsjlzx/article/details/50462247

HeaderAndFooterRecyclerView

HeaderAndFooterRecyclerView是支持addHeaderView、 addFooterView、分页加载的RecyclerView解决方案。

它可以对 RecyclerView 控件进行拓展（通过RecyclerView.Adapter实现），给RecyclerView增加HeaderView、FooterView，并且不需要对你的具体业务逻辑Adapter做任何修改。

同时，通过修改 FooterView State，可以动态 FooterView 赋予不同状态（加载中、加载失败、滑到最底等），可以实现 RecyclerView 分页加载数据时的 Loading/TheEnd/NetWorkError 效果。

https://github.com/cundong/HeaderAndFooterRecyclerView

使用

添加HeaderView、FooterView

mHeaderAndFooterRecyclerViewAdapter = new HeaderAndFooterRecyclerViewAdapter(mDataAdapter);
        mRecyclerView.setAdapter(mHeaderAndFooterRecyclerViewAdapter);

        mRecyclerView.setLayoutManager(new LinearLayoutManager(this));

        //add a HeaderView
        RecyclerViewUtils.setHeaderView(mRecyclerView, new SampleHeader(this));

        //add a FooterView
        RecyclerViewUtils.setFooterView(mRecyclerView, new SampleFooter(this));

LinearLayout/GridLayout/StaggeredGridLayout布局的RecyclerView分页加载

mRecyclerView.addOnScrollListener(mOnScrollListener);

private EndlessRecyclerOnScrollListener mOnScrollListener = new EndlessRecyclerOnScrollListener() {

        @Override
        public void onLoadNextPage(View view) {
            super.onLoadNextPage(view);

            LoadingFooter.State state = RecyclerViewStateUtils.getFooterViewState(mRecyclerView);
            if(state == LoadingFooter.State.Loading) {
                Log.d("@Cundong", "the state is Loading, just wait..");
                return;
            }

            mCurrentCounter = mDataList.size();

            if (mCurrentCounter < TOTAL_COUNTER) {
                // loading more
                RecyclerViewStateUtils.setFooterViewState(EndlessLinearLayoutActivity.this, mRecyclerView, REQUEST_COUNT, LoadingFooter.State.Loading, null);
                requestData();
            } else {
                //the end
                RecyclerViewStateUtils.setFooterViewState(EndlessLinearLayoutActivity.this, mRecyclerView, REQUEST_COUNT, LoadingFooter.State.TheEnd, null);
            }
        }
    };

注意事项

如果已经使用 RecyclerViewUtils.setHeaderView(mRecyclerView, view); 为RecyclerView添加了HeaderView，那么再调用ViewHolder类的getAdapterPosition()、getLayoutPosition()时返回的值就会因为增加了Header而受影响（返回的position等于真实的position+headerCounter）。

因此，这种情况下请使用 RecyclerViewUtils.getAdapterPosition(mRecyclerView, ViewHolder.this)、RecyclerViewUtils.getLayoutPosition(mRecyclerView, ViewHolder.this) 两个方法来替代。

PowerfulRecyclerView
可以设置头、底操作：
https://github.com/zjutkz/PowerfulRecyclerView
参考博客：
http://zjutkz.net/2016/03/29/重复造轮子也是有意义的！PowerfulRecyclerView使用指导和源码分析/

PowerfulRecyclerViewAdapter

支持各种ViewHolder类型的RecyclerView.Adapter的实现，是一个万能适配器

项目地址：https://github.com/simplify20/PowerfulRecyclerViewAdapter

特性：

使用DataBean关联Data(Model)与ViewHolder;
DataBean控制ViewHolder的创建以及数据到ViewHolder的绑定；
Adapter的一部分职能由DataBean承担，如创建不同类型的ViewHolder以及绑定数据到ViewHolder,Adapter只用维护数据的相关操作即可；
Adapter的onCreateViewHolder和onBindViewHolder中没有switch..case语句，通过DataBean的多态性实现不同的创建和绑定；
使用了本项目的Adapter,使用RecyclerView时就不用写Adapter了；
支持任何种类的ViewHolder(继承自BaseRecyclerViewHolder)
使用接口可以提高ViewHolder及Data的复用性，并且利于测试。

HVEndlessRecyclerView

自定义 RecyclerView 实现添加 footer，当然你想添加 header 也是支持的

项目地址：https://github.com/HelloVass/HVEndlessRecyclerView

Easy way implements loadmore

Thanks Cube-Sdk，秋哥的 loadmore 模块真的写得很好！

1.Click 事 // 支持 Click 事件

mSampleAdapter.setOnItemClickListener(new OnRcvItemClickListener() {
  @Override public void onItemClick(View v, int position) {
    Toast.makeText(MainActivity.this, "点击事件支持，item position -->>" + position,
        Toast.LENGTH_SHORT).show();
  }
});

// 支持 LongClick 事件
mSampleAdapter.setOnItemLongClickListener(new OnRcvItemLongClickListener() {
  @Override public boolean onItemLongClick(View view, int position) {
    Toast.makeText(MainActivity.this, "长按点击事件支持，item position -->>" + position,
        Toast.LENGTH_SHORT).show();
    return true;
  }
});

2 使用默认的 footer

mRecyclerView.setAdapter(mSampleAdapter);
mRecyclerView.useDefaultFooter(); // 请在 setAdapter 之后设置默认的 footer

3.加载更多数据

mRecyclerView.setLoadMoreHandler(new ILoadMoreHandler() {
      @Override public void onLoadMore() {
        simulateLoadMoreData();
    }
  });

4 加载完成之后，设置状态

内容是否为空

是否有更多数据

/**
   * 
   * @param isEmpty fetch 的数据列表是否为空
   * @param hasMore 是否还有更多数据
   */
  @Override public void onLoadMoreCompleted(boolean isEmpty, boolean hasMore) {

  }

5.加载失败

/**
   * 
   * @param errorCode 错误码
   * @param errorMsg 错误信息
   */
  @Override public void onLoadMoreFailed(int errorCode, String errorMsg) {

  }

嫌弃我写的 Footer 不好看，你可以自定义 Footer ！

/**
 *
 * 对 LoadMoreView 的抽象
 */
public interface ILoadMoreUIHandler {

  // 加载中
  void onLoading();
  // 加载完毕
  void onLoadFinish(boolean isEmpty, boolean hasMore);
  // 加载出错
  void onLoadError(int errorCode, String errorMsg);
  // 等待被点击加载更多
  void onWaitToLoadMore();
}

Tips

具体可以参考 DefaultLoadMoreFooterView 这个栗子！