如何用Android Paging库实现含横向首项的多视图RecyclerView？

嘿，我来帮你搞定这个多类型分页RecyclerView的需求！结合你提到的Room作为单一数据源、网络同步，还有首项是横向RecyclerView的场景，我整理了一套清晰的实现步骤：

首先我们需要一个基类/密封类来封装两种不同类型的列表项，这样PagedList才能统一处理它们：

// 密封类确保所有子类型都是已知的，方便后续判断
sealed class FeedItem {
    // 首项的横向列表数据
    data class HorizontalSection(val items: List<HorizontalData>) : FeedItem()
    // 普通的纵向列表项数据
    data class VerticalItem(val data: VerticalData) : FeedItem()
}

这里的HorizontalData和VerticalData就是你Room数据库中对应的实体类，或者从网络同步过来的数据模型。

Room原生支持分页，我们先给纵向数据配置分页查询：

// Dao层代码
@Dao
interface YourDao {
    // 纵向数据的分页查询，返回DataSource.Factory供Paging使用
    @Query("SELECT * FROM vertical_data ORDER BY update_time DESC")
    fun getVerticalPagedData(): DataSource.Factory<Int, VerticalData>

    // 横向数据的查询（因为是首项，可能一次性加载所有）
    @Query("SELECT * FROM horizontal_data")
    suspend fun getHorizontalData(): List<HorizontalData>
}

接下来要重写PagedListAdapter的核心方法，处理两种视图类型的创建、绑定：

class FeedAdapter : PagedListAdapter<FeedItem, RecyclerView.ViewHolder>(DiffCallback) {
    companion object {
        private const val VIEW_TYPE_HORIZONTAL = 0
        private const val VIEW_TYPE_VERTICAL = 1

        // DiffUtil用于判断列表项是否变化，提升RecyclerView性能
        private val DiffCallback = object : DiffUtil.ItemCallback<FeedItem>() {
            override fun areItemsTheSame(oldItem: FeedItem, newItem: FeedItem): Boolean {
                return when {
                    oldItem is HorizontalSection && newItem is HorizontalSection -> true
                    oldItem is VerticalItem && newItem is VerticalItem -> oldItem.data.id == newItem.data.id
                    else -> false
                }
            }

            override fun areContentsTheSame(oldItem: FeedItem, newItem: FeedItem): Boolean {
                return oldItem == newItem
            }
        }
    }

    // 根据列表项类型返回对应的视图标识
    override fun getItemViewType(position: Int): Int {
        return when (getItem(position)) {
            is HorizontalSection -> VIEW_TYPE_HORIZONTAL
            is VerticalItem -> VIEW_TYPE_VERTICAL
            null -> -1
        }
    }

    // 创建不同类型的ViewHolder
    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder {
        val inflater = LayoutInflater.from(parent.context)
        return when (viewType) {
            VIEW_TYPE_HORIZONTAL -> {
                val view = inflater.inflate(R.layout.item_horizontal_section, parent, false)
                HorizontalSectionViewHolder(view)
            }
            VIEW_TYPE_VERTICAL -> {
                val view = inflater.inflate(R.layout.item_vertical, parent, false)
                VerticalItemViewHolder(view)
            }
            else -> throw IllegalArgumentException("未知视图类型")
        }
    }

    // 绑定对应类型的数据
    override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) {
        val item = getItem(position) ?: return
        when (holder) {
            is HorizontalSectionViewHolder -> {
                val section = item as HorizontalSection
                // 给横向RecyclerView设置适配器（这里可以是普通Adapter或分页Adapter）
                holder.horizontalRv.adapter = HorizontalItemAdapter(section.items)
            }
            is VerticalItemViewHolder -> {
                val verticalItem = item as VerticalItem
                // 绑定纵向项的UI数据，比如：
                // holder.titleTv.text = verticalItem.data.title
            }
        }
    }

    // 横向Section的ViewHolder
    class HorizontalSectionViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        val horizontalRv: RecyclerView = itemView.findViewById(R.id.horizontal_rv)
        init {
            // 设置横向布局管理器
            horizontalRv.layoutManager = LinearLayoutManager(itemView.context, LinearLayoutManager.HORIZONTAL, false)
        }
    }

    // 纵向项的ViewHolder
    class VerticalItemViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        // 声明你的UI控件，比如val titleTv: TextView = itemView.findViewById(R.id.title_tv)
    }
}

因为横向首项是固定的，而纵向是分页数据，我们需要把两者合并成一个PagedList。可以用ConcatPagedListBuilder来实现：

// 在ViewModel中处理数据源合并
class FeedViewModel(yourDao: YourDao) : ViewModel() {
    // 纵向分页数据源
    private val verticalDataSource = yourDao.getVerticalPagedData()
    // 横向首项的数据源（仅返回一个元素）
    private val horizontalDataSource = object : DataSource.Factory<Int, FeedItem>() {
        override fun create(): DataSource<Int, FeedItem> {
            return object : PositionalDataSource<FeedItem>() {
                override fun loadInitial(params: LoadInitialParams, callback: LoadInitialCallback<FeedItem>) {
                    // 从Room获取横向数据，转换成FeedItem
                    viewModelScope.launch {
                        val horizontalData = yourDao.getHorizontalData()
                        val horizontalSection = FeedItem.HorizontalSection(horizontalData)
                        callback.onResult(listOf(horizontalSection), 0, 1)
                    }
                }

                override fun loadRange(params: LoadRangeParams, callback: LoadRangeCallback<FeedItem>) {
                    // 横向首项只有一个，不需要加载更多
                }
            }
        }
    }

    // 合并两个数据源，生成最终的PagedList
    val combinedPagedList = ConcatPagedListBuilder(horizontalDataSource, verticalDataSource)
        .setPageSize(20) // 纵向数据的每页数量
        .build()
}

之后在Activity/Fragment中观察这个合并后的PagedList，提交给Adapter即可：

viewModel.combinedPagedList.observe(this) {
    feedAdapter.submitList(it)
}

因为Room是单一数据源，所有数据都要先写入Room，再由PagedList读取。你可以在ViewModel中用协程实现网络同步：

// Repository层代码
class FeedRepository(private val api: YourApiService, private val dao: YourDao) {
    // 同步纵向数据到Room
    suspend fun syncVerticalData() {
        val networkData = api.getVerticalData()
        dao.insertVerticalData(networkData)
    }

    // 同步横向数据到Room
    suspend fun syncHorizontalData() {
        val networkData = api.getHorizontalData()
        dao.insertHorizontalData(networkData)
    }
}

// ViewModel中调用同步
fun syncData() {
    viewModelScope.launch {
        try {
            repository.syncHorizontalData()
            repository.syncVerticalData()
        } catch (e: Exception) {
            // 处理同步失败逻辑
        }
    }
}

同步完成后，Room会自动通知PagedList更新，Adapter会自动刷新UI。

• 如果你用的是Paging 3（推荐，PagedList是Paging 2的旧API），思路类似，只需把DataSource换成PagingSource，PagedListAdapter换成PagingDataAdapter，合并数据源用PagingData.concat()即可。
• 如果横向RecyclerView也需要分页，只需给它单独配置PagedListAdapter，同样从Room取数据即可。
• 确保DiffCallback的逻辑正确，否则分页更新时可能出现UI错乱。

内容的提问来源于stack exchange，提问作者rCr_BD