liheng2016 / pagingadapter

Paging3 RecyclerView Adapter

PagingAdapter

Paging3 RecyclerView Adapter

超简单易用的使用Paging3封装的RecyclerView的列表适配器

本库的优势：

• 使用paging3封装，具有paging3完全优势，快速实现列表分页，无缝加载；
• 可以对条目实现增删改，弥补paging无法修改数据问题；
• 不需要实现paging的数据库缓存，直接网络请求即可；
• 多类型条目解耦，新增新的条目完全不需要修改原有代码，直接新建holder即可；
• 已经完全不需要再自己实现adapter了；
• holder对UI的操作全由helper实现链式操作，不用再绑定viewId了；

使用步骤：

依赖方式：

1. 项目的根build.gradle里添加jitpack仓库

allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

2. 依赖：在模块build.gradle添加

dependencies {
	    implementation 'com.github.jarryleo:PagingAdapter:2.0.0'
}

代码使用：

1. 数据模型bean类实现接口 DifferData

//用作数据比较，执行RecyclerView条目动画,可以不实现方法,但是不建议这样做,性能差距就在这里体现
interface DifferData {
    fun areItemsTheSame(d: DifferData): Boolean
    fun areContentsTheSame(d: DifferData): Boolean
    fun getChangePayload(d: DifferData): Any?
}

2. 实现条目holder：继承SimpleHolder, 可直接使用布局中的id对view执行操作，放心使用，view可以复用

class NewsHolder : SimpleHolder<NewsBean.StoriesBean>(R.layout.item_news) {
    override fun bindItem(
        item: ItemHelper,
        data: NewsBean.StoriesBean,
        payloads: MutableList<Any>?
    ) {
        tv_title.text = data.title
        iv_cover.loadImage(data.images?.get(0))
    }
}

注意：直接使用布局中的id对view执行操作，需要在build里加上下面代码以开启 kotlin对 view的支持

    androidExtensions {
        experimental = true
    }

加在build的 android 标签里面

3. 设置Adapter

 recyclerView.adapter = SimplePagingAdapter(NewsHolder(), TitleHolder())

多条目类型就实现多个holder，直接传给SimplePagingAdapter的构造即可，构造支持可变参数

4. 给adapter设置数据

//在ViewModel类里面实现
val pager = SimplePager<Long, DifferData>(viewModelScope) {
        val date = it.key ?: initialKey
        try {
            //从网络获取数据
            val data = api.getNews(date).await()
            //返回数据
            PagingSource.LoadResult.Page(data.stories, null, data.date?.toLongOrNull())
        } catch (e: Exception) {
            //请求失败
            PagingSource.LoadResult.Error(e)
        }
    }


//绑定数据源
adapter.setPager(model.pager)

注意：不要使用adapter默认的 submitData,否则无法修改数据

使用就是这么方便，其中一些定义需要对paging3有一定了解，更多功能请看范例

Paging3用法详解和踩坑经验