Android Paging3分页+ConcatAdapter+空数据视图+下拉刷新(SwipeRefreshLayout)+加载更多+错误重试 (示例)

已于 2023-12-19 14:56:17 修改
阅读量3.5k 收藏 4
点赞数 2
分类专栏： Android Android Jetpack 文章标签： android 分页加载
于 2023-06-10 16:37:16 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/jjwwmlp456/article/details/131142710
版权

文章目录

请添加图片描述

引入库

implementation 'androidx.paging:paging-runtime-ktx:3.1.1'
implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.5.1'
implementation 'androidx.recyclerview:recyclerview:1.3.0'

paging 库，目前还是有点小bug ，后面说

数据模型定义

// 分页请求的数据响应，至少要返回一个总数量; page、pageIndex 都可本地定义，然后 可以计算出当前请求响应后，历史返回的总数量；最终计算出是否还有下一页
data class CustomerPageData(val totalCount: Int, val data: List<CustomerData>)

data class CustomerData(val id: String, val name: String)

分页 adapter

import android.graphics.Color
import android.view.LayoutInflater
import android.view.ViewGroup
import android.widget.TextView
import androidx.paging.PagingDataAdapter
import androidx.recyclerview.widget.DiffUtil
import com.stone.stoneviewskt.R
import com.stone.stoneviewskt.common.BaseViewHolder
import com.stone.stoneviewskt.data.CustomerData
import com.stone.stoneviewskt.util.logi

/**
 * desc:
 * author:  stone
 * email:   aa86799@163.com
 * blog :   https://stone.blog.csdn.net
 * time:    2023/6/10 11:20
 */
class PageListAdapter: PagingDataAdapter<CustomerData, BaseViewHolder>(object : DiffUtil.ItemCallback<CustomerData>() {

    // 是否是同一条 item
    override fun areItemsTheSame(oldItem: CustomerData, newItem: CustomerData): Boolean {
        logi("areItemsTheSame")
        return oldItem.id == newItem.id
    }

    // 是否内容相同
    override fun areContentsTheSame(oldItem: CustomerData, newItem: CustomerData): Boolean {
        logi("areContentsTheSame")
        return oldItem.id == newItem.id
    }
}) {

    // item 点击事件
    private var mBlock: ((position: Int, data: CustomerData) -> Unit)? = null

    override fun onBindViewHolder(holder: BaseViewHolder, position: Int) {
        val data = getItem(position) ?: return
        holder.findView<TextView>(R.id.tv_name).text = data.name

        holder.itemView.setOnClickListener {
            mBlock?.invoke(position, data)
        }

        if (position % 2 == 0) {
            holder.itemView.setBackgroundColor(Color.parseColor("#c0ff00ff"))
        } else {
            holder.itemView.setBackgroundColor(Color.parseColor("#c0abc777"))
        }
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): BaseViewHolder {
        val itemView = LayoutInflater.from(parent.context).inflate(R.layout.item_page_list, parent, false)
        return BaseViewHolder(itemView)
    }

    fun setItemClick(block: (position: Int, data: CustomerData) -> Unit) {
        this.mBlock = block
    }

}

布局文件就是显示两个TextView，就不贴了

加载更多 adapter

布局文件：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:paddingTop="10dp"
    android:paddingBottom="10dp">

    <ProgressBar
        android:id="@+id/progressBar"
        style="@style/myProgressBarStyle"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:indeterminateBehavior="repeat"
        android:indeterminateDuration="700"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toStartOf="@id/tv_load"
        app:layout_constraintHorizontal_chainStyle="packed"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <TextView
        android:id="@+id/tv_load"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:gravity="center"
        android:paddingStart="20dp"
        android:paddingEnd="20dp"
        android:text="数据加载中..."
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toEndOf="@id/progressBar"
        app:layout_constraintTop_toTopOf="parent" />

    <TextView
        android:id="@+id/tv_all_message"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:gravity="center"
        android:paddingStart="20dp"
        android:paddingEnd="20dp"
        android:text="已加载全部数据"
        android:visibility="gone"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <Button
        android:id="@+id/btn_retry"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:gravity="center"
        android:paddingStart="20dp"
        android:paddingEnd="20dp"
        android:text="重试"
        android:textSize="18sp"
        android:visibility="gone"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        tools:visibility="visible" />
</androidx.constraintlayout.widget.ConstraintLayout>

adapter 实现：

import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.widget.ProgressBar
import android.widget.TextView
import androidx.paging.LoadState
import androidx.paging.LoadStateAdapter
import com.stone.stoneviewskt.R
import com.stone.stoneviewskt.common.BaseViewHolder
import com.stone.stoneviewskt.util.logi

/**
 * desc:    加载更多
 * author:  stone
 * email:   aa86799@163.com
 * time:    2023/6/8 16:11
 */
class LoadMoreAdapter(private val retryBlock: () -> Unit) : LoadStateAdapter<BaseViewHolder>() {
    override fun onBindViewHolder(holder: BaseViewHolder, loadState: LoadState) {
        when (loadState) {
            is LoadState.NotLoading -> { // 非加载中
                logi("LoadMoreAdapter---onBindViewHolder---LoadState.NotLoading")
                holder.itemView.findViewById<ProgressBar>(R.id.progressBar).visibility = View.GONE
                holder.itemView.findViewById<TextView>(R.id.tv_load).visibility = View.GONE

                holder.itemView.findViewById<TextView>(R.id.tv_all_message).visibility = View.VISIBLE

                holder.itemView.findViewById<TextView>(R.id.btn_retry).visibility = View.GONE
            }

            is LoadState.Loading -> { // 加载中
                holder.itemView.findViewById<ProgressBar>(R.id.progressBar).visibility = View.VISIBLE
                holder.itemView.findViewById<TextView>(R.id.tv_load).visibility = View.VISIBLE

                holder.itemView.findViewById<TextView>(R.id.tv_all_message).visibility = View.GONE

                holder.itemView.findViewById<TextView>(R.id.btn_retry).visibility = View.GONE
            }

            is LoadState.Error -> {
                holder.itemView.findViewById<ProgressBar>(R.id.progressBar).visibility = View.GONE
                holder.itemView.findViewById<TextView>(R.id.tv_load).visibility = View.GONE

                holder.itemView.findViewById<TextView>(R.id.tv_all_message).visibility = View.GONE

                val btnRetry = holder.itemView.findViewById<TextView>(R.id.btn_retry)
                btnRetry.visibility = View.VISIBLE
                btnRetry.text = "发生了错误：${loadState.error.message}，点击重试"
                btnRetry.setOnClickListener {
                    retryBlock()
                }
            }
        }
    }

    override fun onCreateViewHolder(parent: ViewGroup, loadState: LoadState): BaseViewHolder {
        val itemView = LayoutInflater.from(parent.context).inflate(R.layout.layout_load_more, parent, false)
        return BaseViewHolder(itemView)
    }

    // 是否作为 item 显示
    override fun displayLoadStateAsItem(loadState: LoadState): Boolean {
        logi("loadState -- $loadState")
        return loadState is LoadState.Loading
                || loadState is LoadState.Error
                || (loadState is LoadState.NotLoading && loadState.endOfPaginationReached)
        // loadState.endOfPaginationReached false 表示有更多的数据要加载
    }

}

adapter 继承自 LoadStateAdapter，关联的数据对象 LoadState 有三个状态。

  • LoadState.NotLoading 表示 非加载中，即加载完成时的状态。如果 displayLoadStateAsItem()中的实现是|| (loadState is LoadState.NotLoading) 那通过日志会发现，在初次加载分页数据时，会发生一次 LoadState.NotLoading，在加载完成所有数据后，每次滑动到底部时，都会发生一次 LoadState.NotLoading。而改成如上实现 || (loadState is LoadState.NotLoading && loadState.endOfPaginationReached) 则初次加载分页数据时，不会发生 LoadState.NotLoading 。
    所以，在 onBindViewHolder() 中的实现是，NotLoading 时，显示加载完成文本框
  • LoadState.Loading 表示 加载中的状态。显示 ProgressBar和一个文本消息框
  • LoadState.Error 表示 加载错误的状态。其关联的是 PagingSource#load() 返回的 LoadResult.Error 结果。
    显示 发生了错误：${loadState.error.message}，点击重试 的文本框

displayLoadStateAsItem() 通过返回值判断 是否作为 item 显示。前面说 loadState is LoadState.NotLoading && loadState.endOfPaginationReached 非加载中&& 加载完成所有数据时 LoadState.NotLoading 状态才显示，即内部调用bindViewHolder()。

空数据 adapter

import com.stone.stoneviewskt.R
import com.stone.stoneviewskt.adapter.BaseRvAdapter
import com.stone.stoneviewskt.common.BaseViewHolder

/**
 * desc:    空数据
 * author:  stone
 * email:   aa86799@163.com
 * time:    2023/6/9 10:45
 */
class EmptyAdapter: BaseRvAdapter<String>(R.layout.layout_empty) {

    override fun fillData(holder: BaseViewHolder, position: Int, data: String) {

    }
}

布局文件 里就一个文本框，text=“暂无数据”

分页数据源

import androidx.paging.PagingSource
import androidx.paging.PagingState
import com.stone.stoneviewskt.BuildConfig
import com.stone.stoneviewskt.data.CustomerData
import com.stone.stoneviewskt.data.CustomerPageData
import com.stone.stoneviewskt.util.logi
import com.stone.stoneviewskt.util.showShort
import kotlin.random.Random

/**
 * desc:    分页数据源
 * author:  stone
 * email:   aa86799@163.com
 * blog :   https://stone.blog.csdn.net
 * time:    2023/6/10 11:26
 */
class PageListPageSource : PagingSource<Int, CustomerData>() {

    private var flagA = false
    private var flagB = false
    companion object {
        private var mockEmpty = true // 静态字段 模拟空数据
    }

    override fun getRefreshKey(state: PagingState<Int, CustomerData>): Int? {
        return state.anchorPosition?.let { anchorPosition ->
            val anchorPage = state.closestPageToPosition(anchorPosition)
            anchorPage?.prevKey?.plus(1) ?: anchorPage?.nextKey?.minus(1)
        }
    }

    override suspend fun load(params: LoadParams<Int>): LoadResult<Int, CustomerData> {
        val currentPage = params.key ?: 1 // 当前页码
        val pageSize = params.loadSize // 每页多少条数据
        var bean: CustomerPageData? = null // 分页数据
        kotlin.runCatching { // 异常发生后，执行 onFailure {}
            // todo 真实开发时，移除模拟错误代码

            // 模拟 第2页 一定抛异常
            if (currentPage == 2 && !flagB) {
                flagA = true
            }
            if (flagA) {
                flagA = false
                flagB = true
                throw IllegalStateException("test-error")
            }


            if (currentPage % 2 == 0 && Random.nextInt() % 2 == 0) { // 当偶数页时，随机发生异常。  注意异常发生后，对请求的页码 -- currentPage是否有影响
                throw IllegalStateException("test-error")
            }
//            Api.createRetrofit(CustomerApiService::class.java).customerList(currentPage，pageSize) // 真实网络请求方式
            mockData(currentPage, pageSize)// todo 真实开发时，移除模拟数据代码
        }.onSuccess {
            bean = it
        }.onFailure {
            it.printStackTrace()
            // 当数据加载中时，销毁了界面(比如--回退到上一页)，就有很大概率触发 CancellationException
            // 跳过该异常
            if (it !is java.util.concurrent.CancellationException) {
                showShort("出错了" + it.message)
                return LoadResult.Error(it) // 如果返回 error，那后续 加载更多(即底部上拉)将不会触发
            }
        }
        val prevKey = if (currentPage > 1) currentPage - 1 else null // 当前页不是第一页的话，前一页为当前页减一
        val hasMore = currentPage * pageSize < (bean?.totalCount ?: 0)
        val nextKey = if (hasMore) currentPage + 1 else null // 当前页有数据的话，下一页就是，当前页加一，反之为空
        logi("currentPage:$currentPage    pageSize:$pageSize    prevKey:$prevKey     nextKey:$nextKey")
        return try {
            LoadResult.Page(
                data = bean?.data ?: arrayListOf(), // 数据
                prevKey = prevKey, // 为当前页的前一页
                nextKey = nextKey  // 为当前页的下一页
            )
        } catch (e: Exception) {
            e.printStackTrace()
            return LoadResult.Error(e)
        }
    }

    // 模拟分页数据
    private fun mockData(pageIndex: Int, pageSize: Int): CustomerPageData? {
        if (mockEmpty) {
            mockEmpty = false
            return null
        }
        logi("分页参数：[pageIndex-$pageIndex] [pageSize-$pageSize]")
        val list = arrayListOf<CustomerData>()
        val totalCount = 55
        val currentCount = if (totalCount > pageIndex * pageSize) pageSize else totalCount - (pageIndex - 1) * pageSize
         (1..currentCount).forEach {
             val currentPosition = (pageIndex - 1) * pageSize + it
             list.add(CustomerData("id-$currentPosition", "name-$currentPosition"))
        }
        return CustomerPageData(totalCount, list)
    }
}

上面的实现中，有一些模拟数据和加载数据出错的代码，都有注释

ViewModel 提供加载数据源的方法

/**
 * desc:
 * author:  stone
 * email:   aa86799@163.com
 * blog :   https://stone.blog.csdn.net
 * time:    2023/6/10 12:12
 */
class PageListViewModel : ViewModel() {

    // todo 截止到 3.1.1版本，官方库有bug：超出 initialLoadSize 所在页码后， 再retry 没问题；反之retry，会数据重复
    // todo 为了规避 建议 真实开发时，initialLoadSize 和 pageSize 的值相同。 或看看后续版本是否有修复

    fun loadData(): Flow<PagingData<CustomerData>> {
        return Pager(
            config = PagingConfig(
                pageSize = 10,
                initialLoadSize = 15, // 初始取的 pageSize，通常要大于指定的 pageSize   但大于了，在retry时又会出现bug
                prefetchDistance = 1   // 滑动到底部的 prefetchDistance 条数据 时自动加载下一页(如果还有下一页)
            ),
            // 每页都会调用一次 pagingSource#load(), 请求数据
            pagingSourceFactory = { PageListPageSource() }
        ).flow.cachedIn(viewModelScope) // 设置缓存
    }
}

因为 pagingSource 加载的bug，导致对应情形下的数据重复。想用 flow.distinctUntilChangedBy 操作符来去重，
可是 该flow类型是 Flow<PagingData<CustomerData>> 而不是 Flow<CustomerData> ，所以然并卵…

结合以上实现的 Fragment

import android.os.Bundle
import androidx.lifecycle.ViewModelProvider
import androidx.lifecycle.lifecycleScope
import androidx.paging.LoadState
import androidx.recyclerview.widget.ConcatAdapter
import com.stone.stoneviewskt.R
import com.stone.stoneviewskt.common.BaseBindFragment
import com.stone.stoneviewskt.databinding.FragmentPageListBinding
import com.stone.stoneviewskt.util.logi
import com.stone.stoneviewskt.util.showShort
import kotlinx.coroutines.flow.collectLatest

/**
 * desc:    Paging3分页+ConcatAdapter+空数据视图+下拉刷新(SwipeRefreshLayout)+加载更多+错误重试
 * author:  stone
 * email:   aa86799@163.com
 * blog :   https://stone.blog.csdn.net
 * time:    2023/6/10 11:09
 */
class PageListFragment: BaseBindFragment<FragmentPageListBinding>(R.layout.fragment_page_list) {

    private val viewModel by lazy { ViewModelProvider(this)[PageListViewModel::class.java] }
    private lateinit var concatAdapter: ConcatAdapter // 可合并 adapter
    private val adapter by lazy { PageListAdapter() }
    private val loadMoreAdapter by lazy {
        LoadMoreAdapter { // 点击 重试按钮
            adapter.retry()
        }
    }
    private val emptyAdapter: EmptyAdapter by lazy { EmptyAdapter() }

    override fun onPreparedView(savedInstanceState: Bundle?) {
        super.onPreparedView(savedInstanceState)

        concatAdapter = adapter.withLoadStateFooter(loadMoreAdapter) // 将 loadMoreAdapter 添加为 footer 效果
        emptyAdapter.updateData(listOf("")) // 向 emptyAdapter 添加一项，当其显示时，只显示一个对应视图
        mBind.rvPage.adapter = concatAdapter // 这时 已 添加了 loadMoreAdapter

        // 设置加载状态监听
        adapter.addLoadStateListener {
            logi("监听到loadState -- $it")
            // 如果 状态是 未加载(加载完成也算) 或 发生错误
            if (it.refresh is LoadState.NotLoading) { // 见下文分析
                mBind.swipeRefresh.isRefreshing = false
                if (adapter.itemCount == 0) { // 真实数据为空
                    if (concatAdapter.adapters.contains(loadMoreAdapter)) {
                        concatAdapter.removeAdapter(loadMoreAdapter) // 移除加载更多
                        logi("removeAdapter -- loadMoreAdapter")
                    }
                    if (!concatAdapter.adapters.contains(emptyAdapter)) {
                        concatAdapter.addAdapter(emptyAdapter) // 添加空数据视图   仅在未添加过时才添加
                    }
                } else {
                    if (concatAdapter.adapters.contains(emptyAdapter)) {
                        concatAdapter.removeAdapter(emptyAdapter)
                        logi("removeAdapter -- emptyAdapter")
                        concatAdapter.addAdapter(loadMoreAdapter) // 只添加一次 loadMore
                    }
                }

            } else if (it.refresh is LoadState.Error) {
                mBind.swipeRefresh.isRefreshing = false
            }
        }

        adapter.setItemClick { position, data ->
            showShort("点击查看 --- ${data.name}")
        }

        mBind.swipeRefresh.setOnRefreshListener {
            loadData()
        }

        mBind.swipeRefresh.isRefreshing = true
        loadData()
    }

    private fun loadData() {
        lifecycleScope.launchWhenResumed {
            viewModel.loadData().collectLatest { // 加载数据
                adapter.submitData(it) // 绑定分页数据源
            }
        }
    }
}
  • 绑定分页数据源的关键代码是 adapter.submitData(data)
  • 分页数据源加载数据出错后，重试的关键代码是 adapter.retry()
  • adapter.withLoadStateFooter(loadMoreAdapter)返回的是 ConcatAdapter (可合并adapter)。
    将 loadMoreAdapter 添加为 footer。通过 ConcatAdapter ，在数据为空时，添加 EmptyAdapter
  • addLoadStateListener 状态监听，通过日志发现：

LoadState.NotLoading 每次数据加载开始和结束时都会发生。
当数据真实数据项为0时，如果有 加载更多视图 先移除，如果未 添加空数据视图，添加空数据视图。
当数据真实数据项为非0时，如果有 添加空数据视图，则移除空数据视图，并添加 加载更多视图。初始时，通过 concatAdapter = adapter.withLoadStateFooter(loadMoreAdapter) 已添加过 加载更多视图。
如上，不会造成重复添加 空数据视图 或 加载更多视图
注意：这里的 NotLoading 触发时机 和 LoadMoreAdapter#displayLoadStateAsItem() 相应的实现没有关系

数据重复问题

截止到 3.1.1版本，官方库有bug：超出 initialLoadSize 所在页码后， 再retry 没问题；反之retry，会数据重复。比如 pageSize=10，initialLoadSize=15，初始加载15个数据后，当前页码对应 pageSize=10 的情形下是 2；这时再请求第2页，会把第二页的10个条目加载进来并显示，这就发生了数据重复。

为了规避该问题，建议 真实开发时，initialLoadSize 和 pageSize 的值相同。 或看看后续版本是否有修复

对 PagingSource 进行封装

定义好统一的 PageData 的数据字段格式后，不同的业务 都实现一次 PagingSource ，会有大量的重复的代码。因此需要封装一下

base 分页数据类

open class BasePageData<T>(open val totalCount: Int, val data: List<T>)

base 分页数据源

import androidx.paging.PagingSource
import androidx.paging.PagingState
import com.stone.stoneviewskt.BuildConfig
import com.stone.stoneviewskt.data.BasePageData
import com.stone.stoneviewskt.util.logi
import com.stone.stoneviewskt.util.showShort

/**
 * desc:    base 分页数据源
 * author:  stone
 * email:   aa86799@163.com
 * blog :   https://stone.blog.csdn.net
 * time:    2023/6/11 13:05
 */
abstract class BasePageSource<T: Any> : PagingSource<Int, T>() {


    override fun getRefreshKey(state: PagingState<Int, T>): Int? {
        return state.anchorPosition?.let { anchorPosition ->
            val anchorPage = state.closestPageToPosition(anchorPosition)
            anchorPage?.prevKey?.plus(1) ?: anchorPage?.nextKey?.minus(1)
        }
    }

    abstract fun loadData(pageIndex: Int, pageSize: Int): BasePageData<T>?

    override suspend fun load(params: LoadParams<Int>): LoadResult<Int, T> {
        val currentPage = params.key ?: 1 // 当前页码
        val pageSize = params.loadSize // 每页多少条数据
        var bean: BasePageData<T>? = null // 分页数据
        kotlin.runCatching { // 异常发生后，执行 onFailure {}
            loadData(currentPage, pageSize)
        }.onSuccess {
            bean = it
        }.onFailure {
            it.printStackTrace()
            // 当数据加载中时，销毁了界面(比如--回退到上一页)，就有很大概率触发 CancellationException
            // 跳过该异常
            if (it !is java.util.concurrent.CancellationException) {
                showShort("出错了" + it.message)
                return LoadResult.Error(it) // 如果返回 error，那后续 加载更多(即底部上拉)将不会触发
            }
        }
        val prevKey = if (currentPage > 1) currentPage - 1 else null // 当前页不是第一页的话，前一页为当前页减一
        val hasMore = currentPage * pageSize < (bean?.totalCount ?: 0)
        val nextKey = if (hasMore) currentPage + 1 else null // 当前页有数据的话，下一页就是，当前页加一，反之为空
        logi("currentPage:$currentPage    pageSize:$pageSize    prevKey:$prevKey     nextKey:$nextKey")
        return try {
            LoadResult.Page(
                data = bean?.data ?: arrayListOf(), // 数据
                prevKey = prevKey, // 为当前页的前一页
                nextKey = nextKey  // 为当前页的下一页
            )
        } catch (e: Exception) {
            e.printStackTrace()
            return LoadResult.Error(e)
        }
    }
}

具体的数据源实现

import com.stone.stoneviewskt.data.BasePageData
import com.stone.stoneviewskt.data.CustomerData
import com.stone.stoneviewskt.util.logi

/**
 * desc:    分页数据源
 * author:  stone
 * email:   aa86799@163.com
 * blog :   https://stone.blog.csdn.net
 * time:    2023/6/11 13:11
 */
class PageListPageSource2 : BasePageSource<CustomerData>() {

    override fun loadData(pageIndex: Int, pageSize: Int): BasePageData<CustomerData>? {
        return mockData(pageIndex, pageSize)
    }

    // 模拟分页数据
    private fun mockData(pageIndex: Int, pageSize: Int): BasePageData<CustomerData> {
        logi("分页参数：[pageIndex-$pageIndex] [pageSize-$pageSize]")
        val list = arrayListOf<CustomerData>()
        val totalCount = 55
        val currentCount = if (totalCount > pageIndex * pageSize) pageSize else totalCount - (pageIndex - 1) * pageSize
         (1..currentCount).forEach {
             val currentPosition = (pageIndex - 1) * pageSize + it
             list.add(CustomerData("id-$currentPosition", "name-$currentPosition"))
        }
        return BasePageData(totalCount, list)
    }
}

欧了，松口气 ~~

# 对 Adapter 的管理，进行封装 (更新于 230705)

发现，在 UI 类 中应用时，总是要定义这几个adapter、进行初始化、设置加载状态监听等。
基于这些重复动作，所以需要进行封装，有了如下：

import androidx.paging.LoadState
import androidx.paging.PagingDataAdapter
import androidx.recyclerview.widget.ConcatAdapter
import com.stone.stoneviewskt.common.BaseViewHolder
import com.stone.stoneviewskt.util.logi

/**
 * desc:    分页 Adapter-UI 辅助类
 * author:  stone
 * email:   aa86799@163.com
 * time:    2023/7/5 09:20
 */
abstract class PageUiHelper<T : Any>(private val adapter: PagingDataAdapter<T, BaseViewHolder>) {

    private lateinit var concatAdapter: ConcatAdapter // 可合并 adapter
    val loadMoreAdapter by lazy {
        LoadMoreAdapter { // 点击 重试按钮
            adapter.retry()
        }
    }
    val emptyAdapter: EmptyAdapter by lazy { EmptyAdapter() }
	
	abstract fun onNotLoadingOrErrorState()
	
    fun init() {
        concatAdapter = adapter.withLoadStateFooter(loadMoreAdapter) // 将 loadMoreAdapter 添加为 footer 效果
        emptyAdapter.updateData(listOf("")) // 向 emptyAdapter 添加一项，当其显示时，只显示一个对应视图
        
        // 设置加载状态监听
        adapter.addLoadStateListener {
            logi("监听到loadState -- $it")
            // 如果 状态是 未加载(加载完成也算) 或 发生错误
            if (it.refresh is LoadState.NotLoading) {
                onNotLoadingOrErrorState()
                if (adapter.itemCount == 0) { // 真实数据为空
                    if (concatAdapter.adapters.contains(loadMoreAdapter)) {
                        concatAdapter.removeAdapter(loadMoreAdapter) // 移除加载更多
                        logi("removeAdapter -- loadMoreAdapter")
                    }
                    if (!concatAdapter.adapters.contains(emptyAdapter)) {
                        concatAdapter.addAdapter(emptyAdapter) // 添加空数据视图   仅在未添加过时才添加
                    }
                } else {
                    if (concatAdapter.adapters.contains(emptyAdapter)) {
                        concatAdapter.removeAdapter(emptyAdapter)
                        logi("removeAdapter -- emptyAdapter")
                        concatAdapter.addAdapter(loadMoreAdapter) // 只添加一次 loadMore
                    }
                }

            } else if (it.refresh is LoadState.Error) {
                onNotLoadingOrErrorState()
            }
        }
    }

    fun getMainAdapter() = concatAdapter
}

ViewPager2 中使用发现的 bug(更新于 230719)

TabLayout + ViewPager2的FragmentStateAdapter 中，需要创建 fragment 实例。
相关分页的系列操作就放在了该 Fragment中后，场景：在每切换一次 tab，都需要刷新每个 tab 对应的网络请求；之后，再在当前 tab 中加载更多的分页数据；再切换 tab，来回往复操作… 后来发现个 bug：有些 tab 仅加载一页后，loadMore 视图不显示了

解决方法：先是重置了adapter 的数据源绑定，后来发现，还是会有问题。又重置了所有 adapter 的实例，解决了…

private var isResetAdapter = false // 是否重置

private val helper by lazy {
    object : PageUiHelper<ItemData>(adapter) {
        override fun onNotLoadingOrErrorState() {
            dismissLoadingDialog()
            if (isResetAdapter && adapter.itemCount > 0) {
                // 由于重置数据源后，若有新增数据，会排在最前面，rv 不会自动滚动，需要代码操作滚动
                mBind.rvAll.scrollToPosition(0)
                isResetAdapter = false
            }
        }
    }
}

fun loadData() {
    viewLifecycleOwner.lifecycleScope.launchWhenResumed {
        helper.init()
        mBind.rvAll.adapter = helper.getMainAdapter()
        
		showLoadingDialog()
		
        isResetAdapter = true
        mViewModel.getAllData().collectLatest { // 加载数据
            adapter.submitData(it) // 绑定分页数据源
        }
    }
}

刷新 adapter 后，发现展现的数据内容没有更新？(更新于 230904)

很经典的场景：
从 adapter 点击item，打开数据编辑页，修改后，回到列表页，展示的内容数据不刷新；实际上，已经重置了 adapter 的分页数据源。

PagingDataAdapter，有个判断内容是否相同的函数 areContentsTheSame()。如果返回 true，表示是相同的内容，不刷新 item。
比如，除了 id 标识，页面上要展示名字(name)、电话号码(phone)

// 是否内容相同
override fun areContentsTheSame(oldItem: CustomerData, newItem: CustomerData): Boolean {
    logi("areContentsTheSame")
    return oldItem.id == newItem.id && oldItem.name == newItem.name && oldItem.phone == newItem.phone
}
匆忙拥挤repeat
关注
  • 2
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 6
    评论
专栏目录
Android - RecyclerView - ConcatAdaper
HugMua的博客
11-29 1216
顺序地组合多个Adapter，并让它们显示在同一个RecyclerView中 使用场景 RecyclerView通常会被分为三个部分：Header、Content、Footer。这其中三个部分的布局均不相同，所以就需要通过不同的ViewType来实现目的。 步骤 1.写三个xml布局：Header、Content、Footer 2.写三个继承自RecyclerViewer.Adapter的适配器 3.创建ConcatAdapter并添加需要合并的适配器 ...
uni-z-paging:【uni-app自动分页器】超简单！仅需两步轻松完成完整分页逻辑（刷新，上拉加载更多），分页自动处理。支持自定义加载更多的文字或整个视图，自定义拖动刷新样式，自动管理空数据view等
04-01
Z分页 【uni-app自动分页器】超简单，低重组！仅需两步轻松完成完整分页逻辑（翻页刷新，上拉加载更多），分页自动处理。支持自定义加载更多的文字或整个视图，自定义拖放刷新样式，自动管理空数据视图，支持吸顶效果等。 在DCloud插件市场中访问： ://ext.dcloud.net.cn/plugin?name=z-paging 反馈qq群（点击加群）： 平台兼容性 应用程序 5天 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序 √ √ √ √ √ √ √ 预览 自定义拖动刷新效果+分页演示 吸顶效果+分页演示 滑动切换选项卡+分页演示 聊天记录模式+分页演示 功能与特点 【配置简单】仅需两步（绑定网络请求方法，绑定分页结果数组）轻松完成完整刷新刷新，上拉加载更多功能。 【低重组，低侵入】在页面中无需处理任何分页相关逻辑，无需在数据中定义任何分页相关变量，全
Android :Paging （分页）加载数据-简单应用
javaGHui的博客
12-12 693
Android :Paging （分页）加载数据-简单应用
Android进阶之路 - ConcatAdapter到底有没有学习必要？
最新发布
Android、前端、小程序、后端
02-23 1812
在此之前我们如果需要在RecyclerView列表中加载多种不同类型的视图时，之所以推出ConcatAdapter只是为了实现高内聚、低耦合的效果，同时其单一职责，方便复用
【z-paging下拉刷新、上拉加载】示例demo
07-26
【配置简单】仅需两步（绑定网络请求方法、绑定分页结果数组）轻松完成完整下拉刷新，上拉加载更多功能。 【低耦合，低侵入】分页自动管理。在page中无需处理任何分页相关逻辑，无需在data中定义任何分页相关变量，全由z-paging内部处理。 【超灵活，支持各种类型自定义】支持自定义下拉刷新，自定义上拉加载更多，自带自定义下拉刷新效果，及其他数十种自定义属性。 【功能丰富】支持国际化，支持自定义且自动管理空数据图，支持主题模式切换，支持本地分页，支持聊天分页模式，支持展示最后更新时间，支持吸顶效果，支持内部scroll-view滚动与页面滚动，支持一键滚动到顶部等诸多功能。 【全平台兼容】支持nvue，vue3，支持h5、app及各家小程序。 【高性能】在app-vue、h5、微信小程序、QQ小程序上使用wxs+renderjs从视图层实现下拉刷新；支持虚拟列表，轻松渲染万级数据！
上拉加载更多下拉刷新仿新浪微博滚动分页
07-08
上拉加载更多下拉刷新仿新浪微博滚动分页。移动app.
SwipeRefreshLayout上拉刷新和加载更多
09-20
SwipeRefreshLayout是Android5.0的新控件。 它的主要作用就是下拉刷新 它的产生帮助我们解决了很多刷新的问题，从此再也不用去找第三方。 它是v4支持包下的控件，所以在v4的包中才能找到 在xml中需要刷新的页面最外层包裹SwipeRefreshLayout，我在这里用了RecyclerView演示，所以我包裹的是RecyclerView。但是google官方提供的只有下拉，没有加载更多。 这里用的是github上的MaterialRefreshLayout。上下拉刷新都有而且使用还比较简单。整个demo是基于它的，感兴趣的也可以直接去github下载。 地址https://github.com/android-cjj/Android-MaterialRefreshLayout
Android - - - Paging3
m0_47914176的博客
03-04 2572
Paging 库可帮助您加载和显示来自本地存储或网络中更大的数据集中的数据页面。此方法可让您的应用更高效地利用网络带宽和系统资源。Paging 库的组件旨在契合推荐的Android 应用架构，流畅集成其他Jetpack组件，并提供一流的 Kotlin 支持。 使用 Paging 库的优势 Paging 库包含以下功能： 分页数据的内存中缓存。该功能可确保您的应用在处理分页数据时高效利用系统资源。 内置的请求重复信息删除功能，可确保您的应用高效利用网络带宽和系统资源。 可配置的Rec...
Android Paging3的使用
冰雨无痕的博客
02-24 4909
本篇文章主要是自己对Paging3的学习使用，学习主要是根据郭神的文章进行的， 郭神文章的链接：Jetpack新成员，Paging3从吐槽到真香_郭霖的专栏-CSDN博客_pagingPaging是Google推出的一个应用于Android平台的分页加载库。事实上，Paging并不是现在才刚刚推出的，而是之前就已经推出过两个版本了。但Paging 3和前面两个版本的变化非常大，甚至可以说是完全不同的东西了。所以即使你之前没有学习过Paging的用法也没有关系，把Paging 3当成是一个全新的库去学习就可以
ConcatAdapter使用教程
御风而行
05-15 3909
1.前言 2021年4月7日Android团队正式发布了RecyclerView 1.2.0版本。相对于1.1.0版本，它有两个主要的变化： 增加了ConcatAdapter：这个Adapter方便地让我们在一个RecyclerView中连接多个Adapters。 支持延迟恢复状态：RecyclerView现在支持当内容加载出来后恢复状态。 本文将结合ConcatAdapter的简单使用，由浅入深地讲解ConcatAdapter的高级使用。 2.简单使用 实现上面是文本列表，下面是按钮列表的效果，如图：
android 拼接Adapter，ConcatAdapter
qq_36671769的博客
03-11 3235
ConcatAdapter是谷歌新推出的adapter,用它可连接多个adapter,实现一个列表多种item样式，不用处理ItemViewType复杂逻辑。 使用场景：加载更多adapter 1.下拉刷新头一个adapter 2.中间数据一个adapter 3.加载更多一个adapter 4.空数据一个adapter 5.使用ConcatAdapter拼接前四个adapter ...
Android Paging Library 基于RecyclerView的分页加载框架
05-24
详情请点击博客地址：https://blog.csdn.net/qq_20785431/article/details/80413782
三层+存储过程实现分页示例代码
01-01
@ Page Language=”C#” AutoEventWireup=”true” CodeBehind=”paging.aspx.cs” Inherits=”五二一练习.paging” %> <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” ...
android封装adapter,重学RecyclerView Adapter封装的深度思考和实现
weixin_33277564的博客
05-25 268
背景一转眼，从一开始发布文章说带大家封装Adapter直到现在，过去半个月了吧，前后又仔细阅读了很多Adapter的框架源码，对Adapter的千变万化算是有了深刻的认识，真的是温故而知新，借着这次机会，我也将学到的这些优点一一的列出来告诉你，跟我一起重新认识Adapter值得一看的Adapter开源项目这些开源项目都有哪些相同点？这几个项目最大的共同点是都对DataBinding做了扩展，看来D...
RecyclerView更新之-ConcatAdapter(MergeAdapter)
Heijinbaitu的博客
07-27 2952
1、2020 年 4 月 1 日1.2.0-alpha02中官方增加了ConcatAdapter(这时候还叫MergeAdapter)。 2、 2020 年 6 月 24 日发布的androidx.recyclerview:recyclerview:1.2.0-alpha04版本，将MergeAdapter重命名为ConcatAdapter。 ConcatAdapter是可以线性组合多个适配器的新 RecyclerView 适配器。 官方提供的用法如下： MyAdapter adapter1 = ....
Jetpack Paging3 基本使用
AndroidKt
08-02 5446
Paging3 Paging3，是Jetpack提供给开发者用来显示本地或者网络数据集的分页库。针对这类场景，传统的做法是用RecyclerView的加载更多来实现分页加载，很多逻辑需要自行处理且不一定完善。Paging3相当于是官网提供的一套解决方案。 特点 每一页的数据会缓存至内存中，以此保证处理分页数据时更有效的使用系统资源 内置请求重复数据删除功能，确保应用有效地使用网络带宽和系统资源 支持Kotlin协程、Flow、LiveData以及RxJava 内置错误处理支持，如刷新和重试功能。 逻
Android 开发日记-RecycleView
Eqiqi的博客
06-02 440
在app开发中列表肯定是最常见的样式，这里记录一下Android是如何使用RecyclerView创建动态列表的类比一下 RecyclerView 相当于 iOS 中的 UITableView和UICollectionViewRecyclerView 总的来说是列表元素的容器，然后复用View节省内容，提高性能。RecyclerView 想要显示内容需要设置两个关键属性 和 LayoutManager LinearLayoutManager 线性布局，支持横向和纵向滑动，还可以翻转布局，翻转真的是适合
好文推荐：使用-ConcatAdapter-顺序连接其他-Adapter，拿下我人生中第7个Offer
m0_66265031的博客
01-25 296
val secondAdapter: SecondAdapter = … val thirdAdapter: ThirdAdapter = … val concatAdapter= ConcatAdapter(firstAdapter, secondAdapter, thirdAdapter) recyclerView.adapter = concatAdapter RecyclerView 将会按 Adapter 顺序显示所有的项目。 使用不同的适配器可以使您更好地区分列表的每个部分。例如，如果要显示一个
kotlin paging3+recyclerview数据分页示例
06-07
以下是一个使用 Kotlin 和 Paging3+RecyclerView 实现数据分页的示例： 1. 首先，我们需要定义一个包含数据的列表和当前页码的类，使用 PagingData 类型： ``` data class Data( val id: Int, val name: String, val description: String ) ``` 2. 接下来，我们需要定义一个 PagingSource，它负责从数据源获取数据： ``` class DataPagingSource(private val api: DataApi) : PagingSource<Int, Data>() { override suspend fun load(params: LoadParams<Int>): LoadResult<Int, Data> { try { val page = params.key ?: 1 val pageSize = params.loadSize val response = api.getData(page, pageSize) val data = response.data val prevKey = if (page == 1) null else page - 1 val nextKey = if (data.isEmpty()) null else page + 1 return LoadResult.Page( data = data, prevKey = prevKey, nextKey = nextKey ) } catch (e: Exception) { return LoadResult.Error(e) } } override fun getRefreshKey(state: PagingState<Int, Data>): Int? { return state.anchorPosition?.let { anchorPosition -> val anchorPage = state.closestPageToPosition(anchorPosition) anchorPage?.prevKey?.plus(1) ?: anchorPage?.nextKey?.minus(1) } } } ``` 3. 然后，我们需要定义一个 PagingData 类型的数据流，并使用它创建一个 PagingDataAdapter： ``` class DataAdapter : PagingDataAdapter<Data, DataViewHolder>(DataDiffCallback) { override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): DataViewHolder { val view = LayoutInflater.from(parent.context).inflate(R.layout.item_data, parent, false) return DataViewHolder(view) } override fun onBindViewHolder(holder: DataViewHolder, position: Int) { val item = getItem(position) holder.bindData(item) } object DataDiffCallback : DiffUtil.ItemCallback<Data>() { override fun areItemsTheSame(oldItem: Data, newItem: Data): Boolean { return oldItem.id == newItem.id } override fun areContentsTheSame(oldItem: Data, newItem: Data): Boolean { return oldItem == newItem } } } ``` 4. 最后，在 Activity 或 Fragment 中使用 RecyclerView 和 DataAdapter： ``` class MainActivity : AppCompatActivity() { private lateinit var recyclerView: RecyclerView private lateinit var adapter: DataAdapter override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) recyclerView = findViewById(R.id.recycler_view) recyclerView.layoutManager = LinearLayoutManager(this) adapter = DataAdapter() recyclerView.adapter = adapter val api = DataApi() val pagingSourceFactory = { DataPagingSource(api) } val pagingConfig = PagingConfig(pageSize = 10) val dataFlow = Pager( config = pagingConfig, pagingSourceFactory = pagingSourceFactory ).flow dataFlow.cachedIn(lifecycleScope).collectLatest { pagingData -> adapter.submitData(pagingData) } } } ``` 这是一个简单的示例，你可以根据自己的需求进行修改和扩展。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 6
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值