前言
RecyclerView几乎在每个app里面都有被使用,但凡使用了列表就会采用分页加载进行数据请求和加载。android 官方也推出了分页库,但是感觉只有kotlin一起使用才能体会到酸爽。Java 版本的也有很多很强大的第三方库,
BaseRecyclerViewAdapterHelper这个库是我用起来最顺手的分页库,里面也包含了各式各样强大的功能:分组、拖动排序、动画,因为功能强大,代码量也相对比较大。 但是很多时候我们想要的就是分页加载,所以参照BaseRecyclerViewAdapterHelper写下了这个分页加载库,只有分页功能。(可以说照搬,也可以说精简,但是其中也加入个人理解)。
这个库相对BaseRecyclerViewAdapterHelper只有两个优点:
代码量小 BaseRecyclerViewAdapterHelper 在数据不满一屏时仍然显示加载更多以及页面初始化时都会显示loadmoewView(虽然提供了api进行隐藏,但是看了很长时间注释和文档都没了解该怎么使用),而这个库在初次加载和不满一屏数据时不会显示loadmoreViewgradle引用
implementation 'com.maxcion:pageloadadapter:1.0.0'
项目地址:github.com/Likeyong/Pa…
单列分页加载
//一定要在PageLoadRecyclerVewAdapter<String> 的泛型参数里面指定数据源item格式 public class SimpleAdapter extends PageLoadRecyclerVewAdapter<String> { public SimpleAdapter(List<String> dataList) { super(dataList); } //这里进行 数据绑定 @Override protected void convert(BaseViewHolder holder, String item) { holder.setText(R.id.text, item); } //这里返回布局item id @Override protected int getItemLayoutId() { return R.layout.item_simple; } }
第一步 adapter实现好了,现在需要打开adapter的分页加载功能
public class SingleColumnActivity extends BaseActivity<String> implements IOnLoadMoreListener { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_single_column); RecyclerView rv = findViewById(R.id.rv); //实例化adapter mAdapter = new SimpleAdapter(null); //给adapter 设置loadmoreview mAdapter.setLoadMoreView(new CommonLoadMoreView()); //设置滑动到底部时进行更多加载的回调 mAdapter.setOnLoadMoreListener(this); rv.setAdapter(mAdapter); rv.setLayoutManager(new LinearLayoutManager(this)); request(); } @Override public void onLoadMoreRequested() { request(); } //这个函数不用管 @Override protected List<String> convertRequestData(List<String> originData) { return originData; } }
第二步,RecyclerView也打开了分页加载功能,第三部就是根据接口返回的数据判断到底是 加载失败了、加成成功了还是加载结束(没有更多数据需要加载)
protected void request() { NetWorkRequest.request(mAdapter.getDataSize() / PAGE_SIZE + 1, mFailCount, new NetWorkRequest.Callback() { @Override public void onSuccess(List<String> result) { List<T> finalResult = convertRequestData(result); if(result.size() >= PAGE_SIZE){// 接口返回了满满一页的数据,这里数据加载成功 if (mAdapter.getDataSize() == 0){ //当前列表里面没有数据,代表是初次请求,所以这里使用setNewData() mAdapter.setNewData(finalResult); }else { //列表里面已经有数据了,这里使用addDataList(),将数据添加到列表后面 mAdapter.addDataList(finalResult); } //这里调用adapter。loadMoreComplete(true) 函数通知列表刷新footview, 这里参数一定要传true mAdapter.loadMoreComplete(true); }else { //如果接口返回的数据不足一页,也就代表没有足够的数据了,那么也就没有下一页数据,所以这里 //认定分页加载结束 //这里的参数也一定要传true mAdapter.loadMoreEnd(true); } } @Override public void onFail() { mFailCount++; //请求失败 通知recyclerview 刷新footview 状态 mAdapter.loadMoreFail(true); } }); }
上面是我写的模拟接口请求,不用在意其他代码,只要关注onSuccess 和onFail 两个回调里面的逻辑。
混合布局的支持
在电商行业经常能看到商品列表中,同一个列表,有的商品占满整整一行,有的一行显示2-3个商品。这种实现方案就是通过GridLayoutManager 的SpanSizeLookup 来控制每个item占几列的。
RecyclerView rv = findViewById(R.id.rv); mAdapter = new SimpleAdapter(null); mAdapter.setLoadMoreView(new CommonLoadMoreView()); mAdapter.setOnLoadMoreListener(this); //这里我们将列表设置最多两列 GridLayoutManager layoutManager = new GridLayoutManager(this, 2); layoutManager.setSpanSizeLookup(new GridLayoutManager.SpanSizeLookup() { @Override public int getSpanSize(int position) { //根据position 设置每个item应该占几列 //如果当前的position是3的整数倍 我们就让他占满2列,其他的只占1列 return position % 3 == 0 ? 2 : 1 ; } }); rv.setLayoutManager(layoutManager); rv.setAdapter(mAdapter);
RecyclerView多Type支持
如果要使用多type, 在写Adapter的时候要继承PageLoadMultiRecyclerViewAdapter<T, BaseViewHolder>,其中T 是数据源item类型,这个类型必须实现 IMultiItem 接口,并在getItemType()函数中返回当前item对应的type
public class MultiPageLoadAdapter extends PageLoadMultiRecyclerViewAdapter<MultiData, BaseViewHolder> { public MultiPageLoadAdapter(List<MultiData> dataList) { super(dataList); //构造函数里面将 每种type 和 type 对应的布局进行绑定 addItemLayout(MultiData.TYPE_TEXT, R.layout.item_simple); addItemLayout(MultiData.TYPE_IMAGE, R.layout.item_multi_image); addItemLayout(MultiData.TYPE_VIDEO, R.layout.item_multi_video); } @Override protected void convert(BaseViewHolder holder, MultiData item) { //在convert中针对不同的type 进行不同的bind逻辑 switch (holder.getItemViewType()){ case MultiData.TYPE_VIDEO: holder.setText(R.id.text, item.content); break; case MultiData.TYPE_IMAGE: holder.setText(R.id.text, item.content); break; case MultiData.TYPE_TEXT: holder.setText(R.id.text, item.content); default: break; } } }
引入方式也和上面两种方式一样
RecyclerView recyclerView = findViewById(R.id.rv); mAdapter = new MultiPageLoadAdapter(null); mAdapter.setLoadMoreView(new CommonLoadMoreView()); mAdapter.setOnLoadMoreListener(this); recyclerView.setLayoutManager(new LinearLayoutManager(this)); recyclerView.setAdapter(mAdapter);