当前位置：首页 > news >正文

JetPack系列教程（六）：Paging——让分页加载不再“秃”然

news 2025/8/14 15:50:01

前言

在Android开发的世界里，分页加载就像是一场永无止境的马拉松，每次滚动到底部，都仿佛在提醒你：“嘿，朋友，还有更多数据等着你呢！”但别担心，Google大佬们早就看透了我们的烦恼，于是推出了Jetpack Paging组件，让分页加载变得轻松又优雅。今天，我们就来聊聊这个神奇的组件，看看它是如何让我们的开发生活变得更加美好的。^[2][8]

Paging是什么？能吃吗？

首先，Paging是一个分页库，它可以帮助我们优雅地渐进加载大型数据集合，同时减少网络带宽和系统资源的消耗。简单来说，就是让你的应用在加载大量数据时，依然能够保持流畅，就像吃了德芙巧克力一样丝滑。^[10]

Paging的四大金刚

Paging之所以强大，离不开它的四大核心类：

RecyclerView：负责列表展示，就像餐厅的菜单，把各种美食（数据）展示给顾客（用户）。^[2][8]
PagedListAdapter：RecyclerView的适配器，同时负责通知PagedList何时加载更多数据。它就像餐厅的服务员，知道什么时候该上菜（加载数据）。^[2][8]
PagedList：控制分页加载的逻辑，比如加载的数量、每页的大小等。它就像餐厅的厨师长，掌控着整个厨房的节奏。^[2][8]
DataSource：执行数据获取的逻辑，它本身并不存储数据，获取到数据后丢给PagedList存储。它就像餐厅的采购员，负责把新鲜的食材（数据）带回来。^[2][8]

Paging的三大分页术

Paging支持三种分页方式，就像武侠小说里的三大绝学，各有千秋：

PositionalDataSource：支持从任意位置开始，取多少条数据的方式。这就像你在餐厅点菜，说“从第10道菜开始，给我上20道”。^[2][8]
PageKeyedDataSource：以页信息加载数据的场景，比如“pageIndex=1&pageSize=20”。这就像你在餐厅说“给我来第一页菜单，每页20道菜”。^[2][8]
ItemKeyedDataSource：根据上一条数据的信息加载下一条数据，比如社交评论中的“maxId=nextId&count=200”。这就像你在餐厅说“给我上完这道菜后，再根据这道菜的风格，给我推荐下一道”。^[2][8]

实战：用Paging加载GitHub仓库

说了这么多，是时候来点实战了。假设我们要展示GitHub上所有Android相关的开源库，以Star数量排序，每页返回5条数据。^[12]

1. 引入依赖

首先，我们需要在build.gradle文件中添加Paging的依赖：

def paging_version = "3.0.0"
implementation "androidx.paging:paging-runtime-ktx:$paging_version"

2. 创建数据模型类

data class Repo(val id: Int,val name: String,val description: String,val starCount: String
)

3. 定义网络请求接口

interface ApiService {@GET("search/repositories?sort=stars&q=Android")suspend fun searRepos(@Query("page") page: Int, @Query("per_page") perPage: Int): RepoResponsecompanion object {private const val BASE_URL = "https://api.github.com/"fun create(): ApiService {return Retrofit.Builder().baseUrl(BASE_URL).addConverterFactory(GsonConverterFactory.create()).build().create(ApiService::class.java)}}
}

4. 配置数据源

自定义一个子类继承PagingSource，重写load()函数：

class RepoPagingSource(private val apiService: ApiService) : PagingSource<Int, Repo>() {override suspend fun load(params: LoadParams<Int>): LoadResult<Int, Repo> {return try {val page = params.key ?: 1val pageSize = params.loadSizeval repoResponse = apiService.searRepos(page, pageSize)val repoItems = repoResponse.itemsval prevKey = if (page > 1) page - 1 else nullval nextKey = if (repoItems.isNotEmpty()) page + 1 else nullLoadResult.Page(repoItems, prevKey, nextKey)} catch (e: Exception) {LoadResult.Error(e)}}
}

5. 在ViewModel中实现接口请求

class RepoViewModel : ViewModel() {private val apiService = ApiService.create()fun getPagingData(): Flow<PagingData<Repo>> {return Pager(PagingConfig(pageSize = 5, prefetchDistance = 5)) {RepoPagingSource(apiService)}.flow.cachedIn(viewModelScope)}
}

6. UI层展示数据

在Activity或Fragment中，给RecyclerView设置Adapter，并监听数据变化：

class MainActivity : AppCompatActivity() {private val viewModel by lazy { ViewModelProvider(this).get(RepoViewModel::class.java) }private val adapter: RepoAdapter by lazy { RepoAdapter() }override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)val recyclerView: RecyclerView = findViewById(R.id.recyclerView)recyclerView.layoutManager = LinearLayoutManager(this)recyclerView.adapter = adapterlifecycleScope.launchWhenCreated {viewModel.getPagingData().collectLatest { pagingData ->adapter.submitData(pagingData)}}}
}