Android性能优化之RecyclerView分页加载组件功能详解

目录

• 引言
• 1 分页加载组件
• 1.1 功能定制
• 1.2 手写分页列表
• 1.3 生命周期管理
• 2 github

引言

在Android应用中，列表有着举足轻重的地位，几乎所有的应用都有列表的身影，但是对于列表的交互体验一直是一个大问题。在性能比较好的设备上，列表滑动几乎看不出任何卡顿，但是放在低端机上，卡顿会比较明显，而且列表中经常会伴随图片的加载，卡顿会更加严重，因此本章从手写分页加载组件入手，并对列表卡顿做出对应的优化

1 分页加载组件

为什么要分页加载，通常列表数据存储在服务端会超过100条，甚至上千条，如果服务端一次性返回，我们一次性接受直接加载，如果其中有图片加载，肯定直接报OOM，应用崩溃，因此我们通常会跟服务端约定分页的规则，服务端会按照页码从0开始给数据，或者在数据中返回下一页对应的索引，当出发分页加载时，就会拿到下一页的页码请求新一页的数据。

目前在JetPack组件中，Paging是使用比较多的一个分页加载组件，但是Paging使用的场景有限，因为流的限制，导致只能是单一数据源，而且数据不能断，只能全部加载进来，因此决定手写一个分页加载组件，适用多种场景。

1.1 功能定制

如果想要自己写一个分页加载库，首先需要明白，分页加载组件需要做什么事？

对于RecyclerView来说，它的主要功能就是创建视图并绑定数据，因此我们先定义分页列表的基础能力，绑定视图和数据

interface IPagingList<T> {
    fun bindView(context: Context,lifecycleOwner: LifecycleOwner, recyclerView: RecyclerView,adapter: PagingAdapter<T>,mode: ListMode) {}
    fun bindData(model: List<BasePagingModel<T>>) {}
}

bindData：

bindData就不多说了，就是绑定数据，首先我们拿到的数据一定是一个列表数据，因为并不知道业务方需要展示的数据类型是啥样的，因此需要泛型修饰，那么BasePagingModel是干什么的呢？

open class BasePagingModel<T>(
    var pageCount: String = "", //页码
    var type: Int = 1, //分页类型 1 带日期 2 普通列表
    var time: String = "", //如果是带日期的model，那么需要传入此值
    var itemData: T? = null
)

首先BasePagingModel是分页列表中数据的基类，其中存储的元素包括pageCount，代表传进来的数据列表是哪一页，type用来区分列表数据类型，time可以代表当前数据在服务端的时间（主要场景就是列表中数据展示需要带时间，并根据某一天进行数据聚合），itemData代表业务层需要处理的数据。

bindView：

对于RecyclerView来说，创建视图、展示数据需要适配器，因此这里传入了RecyclerView还有通用的适配器PagingAdapter

abstract class PagingAdapter<T> : RecyclerView.Adapter<RecyclerView.ViewHolder>() {
    private var datas: List<BasePagingModel<T>>? = null
    private var maps: MutableMap<String, MutableList<BasePagingModel<T>>>? = null
    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder {
        return buildBusinessHolder(parent, viewType)
    }
    override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) {
        if (datas != null) {
            bindBusinessData(holder, position, datas)
        } else if (maps != null) {
            bindBusinessMapData(holder, position, maps)
        }
    }
    abstract fun getHolderWidth(context: Context):Int
    override fun getItemCount(): Int {
        return if (datas != null) datas!!.size else 0
    }
    open fun bindBusinessMapData(
        holder: RecyclerView.ViewHolder,
        position: Int,
        maps: MutableMap<String, MutableList<BasePagingModel<T>>>?
    ) {
    }
    open fun bindBusinessData(
        holder: RecyclerView.ViewHolder,
        position: Int,
        datas: List<BasePagingModel<T>>?
    ) {
    }
    abstract fun buildBusinessHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder
    fun setPagingData(datas: List<BasePagingModel<T>>) {
        this.datas = datas
        notifyDataSetChanged()
    }
    fun setPagingMapData(maps: MutableMap<String, MutableList<BasePagingModel<T>>>) {
        this.maps = maps
        notifyDataSetChanged()
    }
}

这一章，我们先介绍使用场景比较多的单数据列表

PagingAdapter是一个抽象类，携带的数据同样是业务方需要处理的数据，是一个泛型，创建视图方法buildBusinessHolder交给业务方实现，这里我们关注两个数据相关的方法 bindBusinessData和setPagingData，当调用setPagingData方法时，将处理好的数据列表发进来，然后调用notifyDataSetChanged方法刷新列表，这个时候会调用bindBusinessData将列表中的数据绑定并展示出来。

这里我们还需要关注一个方法，这个方法业务方必须要实现，这个方法有什么作用呢？

abstract fun getHolderWidth(context: Context):Int

这个方法用于返回列表中每个ItemView的尺寸宽度，因为在分页组件中会判断当前列表可见的ItemView有多少个。这里大家可能会有疑问，RecyclerView的LayoutManager不是有对应的api吗，像

findFirstVisibleItemPosition()
findLastVisibleItemPosition()
findFirstCompletelyVisibleItemPosition()
findLastCompletelyVisibleItemPosition()

为什么不用呢？因为我们的分页组件是要兼容多种视图形式的，虽然我们今天讲到的普通列表用这个是没有问题的，但是有些视图类型是不能兼容这个api的，后续会介绍。

1.2 手写分页列表

先把第一版的代码贴出来，有个完整的体系

class PagingList<T> : IPagingList<T>, IModelProcess<T>, LifecycleEventObserver {
    private var mTotalScroll = 0
    private var mCallback: IPagingCallback? = null
    private var currentPageIndex = ""
    //模式
    private var mode: ListMode = ListMode.DATE
    private var adapter: PagingAdapter<T>? = null
    //支持的类型 普通列表
    private val dateMap: MutableMap<String, MutableList<BasePagingModel<T>>> by lazy {
        mutableMapOf()
    }
    private val simpleList: MutableList<BasePagingModel<T>> by lazy {
        mutableListOf()
    }
    override fun bindView(
        context: Context,
        lifecycleOwner: LifecycleOwner,
        recyclerView: RecyclerView,
        adapter: PagingAdapter<T>,
        mode: ListMode
    ) {
        this.mode = mode
        this.adapter = adapter
        recyclerView.adapter = adapter
        recyclerView.layoutManager =
            LinearLayoutManager(context, LinearLayoutManager.HORIZONTAL, false)
        addRecyclerListener(recyclerView)
        lifecycleOwner.lifecycle.addObserver(this)
    }
    private fun addRecyclerListener(recyclerView: RecyclerView) {
        recyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() {
            override fun onScrollStateChanged(recyclerView: RecyclerView, newState: Int) {
                super.onScrollStateChanged(recyclerView, newState)
                if (newState == RecyclerView.SCROLL_STATE_IDLE) {
                    if (!recyclerView.canScrollHorizontally(1) && currentPageIndex == "-1" && mTotalScroll > 0) {
                        //滑动到底部
                        mCallback?.scrollEnd()
                    }
                    //获取可见item的个数
                    val visibleCount = getVisibleItemCount(recyclerView.context, recyclerView)
                    if (recyclerView.childCount > 0 && visibleCount >= (getListCount(mode) ?: 0)) {
                        if (currentPageIndex != "-1") {
                            //请求下一页数据
                            mCallback?.scrollRefresh()
                        }
                    }
                } else {
                    //暂停刷新
                    mCallback?.scrolling()
                }
            }
            override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
                super.onScrolled(recyclerView, dx, dy)
                if (!recyclerView.canScrollHorizontally(1) && currentPageIndex == "-1" && mTotalScroll > 0) {
                    //滑动到底部
                    mCallback?.scrollEnd()
                }
                mTotalScroll += dx
                //滑动超出2屏
//                binding.ivBackFirst.visibility =
//                    if (mTotalScroll > ScreenUtils.getScreenWidth(requireContext()) * 2) View.VISIBLE else View.GONE
            }
        })
    }
    override fun bindData(model: List<BasePagingModel<T>>) {
        //处理数据
        dealPagingModel(model)
        //adapter刷新数据
        if (mode == ListMode.DATE) {
            adapter?.setPagingMapData(dateMap)
        } else {
            adapter?.setPagingData(simpleList)
        }
    }
    fun setScrollListener(callback: IPagingCallback) {
        this.mCallback = callback
    }
    override fun onStateChanged(source: LifecycleOwner, event: Lifecycle.Event) {
        if (event == Lifecycle.Event.ON_RESUME) {
            //TODO 加载图片
//            Glide.with(requireContext()).resumeRequests()
        } else if (event == Lifecycle.Event.ON_PAUSE) {
            //TODO 停止加载图片
        } else if (event == Lifecycle.Event.ON_DESTROY) {
            //TODO 页面销毁不会加载图片
        }
    }
    /**
     * 获取可见的item个数
     */
    private fun getVisibleItemCount(context: Context, recyclerView: RecyclerView): Int {
        var totalCount = 0
        //首屏假设全部占满
        totalCount +=
            ScreenUtils.getScreenWidth(recyclerView.context) / adapter?.getHolderWidth(context)!!
        totalCount += mTotalScroll / adapter?.getHolderWidth(context)!!
        return (totalCount + 1)
    }
    override fun getTotalCount(): Int? {
        return getListCount(mode)
    }
    override fun dealPagingModel(data: List<BasePagingModel<T>>) {
        this.currentPageIndex = updateCurrentPageIndex(data)
        if (mode == ListMode.DATE) {
            data.forEach { model ->
                val time = DateFormatterUtils.check(model.time)
                if (dateMap.containsKey(time)) {
                    model.itemData?.let {
                        dateMap[time]?.add(model)
                    }
                } else {
                    val list = mutableListOf<BasePagingModel<T>>()
                    list.add(model)
                    dateMap[time] = list
                }
            }
        } else {
            simpleList.addAll(data)
        }
    }
    private fun updateCurrentPageIndex(data: List<BasePagingModel<T>>): String {
        if (data.isNotEmpty()) {
            return data[0].pageCount
        }
        return "-1"
    }
    private fun getListCount(mode: ListMode): Int? {
        var count = 0
        if (mode == ListMode.DATE) {
            dateMap.keys.forEach { key ->
                //获取key下的元素个数
                count += dateMap[key]?.size ?: 0
            }
        } else {
            count = simpleList.size
        }
        return count
    }
}

首先，PagingList实现了IPagingList接口，我们先看实现，在bindView方法中，其实就是给RecyclerView设置了适配器，然后注册了RecyclerView的滑动监听，我们看下监听器中的主要实现。

onScrollStateChanged方法主要用于监听列表是否在滑动，当列表的状态为SCROLL_STATE_IDLE时，代表列表停止了滑动，这里做了两件事：

（1）首先判断列表是否滑动到了底部

if (!recyclerView.canScrollHorizontally(1) && currentPageIndex == "-1" && mTotalScroll > 0) {
    //滑动到底部
    mCallback?.scrollEnd()
}

这里需要满足三个条件：recyclerView.canScrollHorizontally(1)如果返回了false，那么代表列表不能继续滑动；还有就是会判断currentPageIndex是否是最后一页，如果等于-1那么就是最后一页，同样需要判断滑动的距离，综合来说就是【如果列表滑动到了最后一页而且不能再继续滑动了，那么就是到底了】，这里可以展示尾部的到底UI。

（2）判断是否能够触发分页加载

/**
 * 获取可见的item个数
 */
private fun getVisibleItemCount(context: Context, recyclerView: RecyclerView): Int {
    var totalCount = 0
    //首屏假设全部占满
    totalCount +=
        ScreenUtils.getScreenWidth(recyclerView.context) / adapter?.getHolderWidth(context)!!
    totalCount += mTotalScroll / adapter?.getHolderWidth(context)!!
    return (totalCount + 1)
}

首先这里会判断展示了多少ItemView，之前提到的适配器中的getHolderWidth这里就用到了，首先我们会假设首屏全部占满了ItemView，然后根据列表滑动的距离，判断后续有多少ItemView展示出来，最终返回结果。

我们先不看下面的逻辑，因为分页加载涉及到了数据的处理，因此我们先看下bindData的实现

override fun bindData(model: List<BasePagingModel<T>>) {
    //处理数据
    dealPagingModel(model)
    //adapter刷新数据
    if (mode == ListMode.DATE) {
        adapter?.setPagingMapData(dateMap)
    } else {
        adapter?.setPagingData(simpleList)
    }
}

在调用bindData时会传入一页的数据，dealPagingModel方法用于处理数据，首先获取当前数据的页码，用于判断是否需要继续分页加载。

override fun dealPagingModel(data: List<BasePagingModel<T>>) {
    this.currentPageIndex = updateCurrentPageIndex(data)
    if (mode == ListMode.DATE) {
        data.forEach { model ->
            val time = DateFormatterUtils.check(model.time)
            if (dateMap.containsKey(time)) {
                model.itemData?.let {
                    dateMap[time]?.add(model)
                }
            } else {
                val list = mutableListOf<BasePagingModel<T>>()
                list.add(model)
                dateMap[time] = list
            }
        }
    } else {
        simpleList.addAll(data)
    }
}

剩下的工作用于组装数据，simpleList用于存储全部的列表数据，每次传入一页数据，都会存在这个集合中。处理完数据之后，将数据塞进adapter，用于刷新数据。

然后我们回到前面，我们在拿到了可见的ItemView的个数之后，首先会判断recyclerView展示的ItemView个数，如果等于0，那么就说明没有数据，就不需要触发分页加载。

if (recyclerView.childCount > 0 && visibleCount >= (getListCount(mode) ?: 0)) {
    if (currentPageIndex != "-1") {
        //请求下一页数据
        mCallback?.scrollRefresh()
    }
}

假设每页展示10条数据，这个时候getListCount方法返回的就是总的数据个数（10），如果visibleCount超过了List的总个数，那么就需要触发分页加载，因为之前我们提到，最后一页的index就是-1，所以这里判断如果是最后一页，就不需要分页加载了。

1.3 生命周期管理

在PagingList中，我们实现了LifecycleEventObserver接口，这里的作用是什么呢？

就是我们知道，在列表中经常会有图片的加载，那么在图片加载时如果滑动列表，那么势必会产生卡顿，因此我们在滑动的过程中不会去加载图片，而是在滑动停止时，重新加载，这个优化体验是没有问题，用户不会关注滑动时的状态。

那么这里会存在一个问题，例如我们在滑动的过程中退出到后台，这个时候列表滑动停止时加载图片，可能存在上下文找不到的场景导致应用崩溃，因此我们传入生命周期的目的在于：让列表具备感知生命周期的能力，当列表处在不可见的状态时，不能进行多余的网络请求。

2022-09-04 15:41:43.541 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:43.651 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:43.661 2763-2763/com.lay.paginglist E/MainActivity: scrollRefresh--
2022-09-04 15:41:43.668 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:43.674 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:43.877 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:43.885 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:43.950 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:44.101 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:44.175 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:44.318 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:44.467 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:44.475 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:45.188 2763-2777/com.lay.paginglist I/.lay.paginglis: WaitForGcToComplete blocked RunEmptyCheckpoint on ProfileSaver for 12.247ms
2022-09-04 15:41:47.008 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:47.099 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:47.186 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:47.322 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:47.403 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:47.404 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:47.514 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:47.606 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:47.650 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:47.683 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:47.781 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:47.889 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:47.950 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:47.963 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:48.156 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:48.182 2763-2763/com.lay.paginglist E/MyAdapter: bindBusinessData --- 
2022-09-04 15:41:48.231 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:48.489 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:48.533 2763-2763/com.lay.paginglist E/MainActivity: scrolling--
2022-09-04 15:41:48.593 2763-2763/com.lay.paginglist E/MainActivity: scrollEnd--

我们可以看下具体的实现效果就是，当触发分页加载时，scrollRefresh会被回调，这里可以进行网络请求，拿到数据之后再次调用bindData方法，然后继续往下滑动，当滑动到最后一页时，scrollEnd被回调，具体的使用，可以在demo中查看。

2 github

之前有小伙伴提到这个事情，希望在github上放出源码，所以就做了 github.com/LLLLLaaayyy…

大家可以在v1.0分支查看源码，在app模块中有一个demo大家可以看具体的使用方式，分页列表的代码在paging模块中

以上就是Android性能优化之RecyclerView分页加载组件功能详解的详细内容，更多关于Android RecyclerView分页加载的资料请关注我们其它相关文章！