这篇文章将为大家详细讲解有关Paging库怎么在Android 中使用，文章内容质量较高，因此小编分享给大家做个参考，希望大家阅读完这篇文章后对相关知识有一定的了解。
10年积累的成都网站设计、成都做网站经验，可以快速应对客户对网站的新想法和需求。提供各种问题对应的解决方案。让选择我们的客户得到更好、更有力的网络服务。我虽然不认识你，你也不认识我。但先网站设计后付款的网站建设流程，更有枝江免费网站建设让你可以放心的选择与我们合作。
添加分页依赖
按照如下代码添加依赖:
dependencies {
def paging_version = "1.0.0"
implementation "android.arch.paging:runtime:$paging_version"
// alternatively - without Android dependencies for testing
testImplementation "android.arch.paging:common:$paging_version"
// optional - RxJava support, currently in release candidate
implementation "android.arch.paging:rxjava2:1.0.0-rc1"
}备注: 分页包帮助开发者在UI的列表容器中顺畅地展示数据, 而不管是使用设备内部的数据库还是从应用后端拉取数据.
库架构
分页库的核心构件是PagedList类, 它是一个集合, 用于异步加载应用数据块或者数据页. 该类在应用的其它架构之间充当中介.
Data
每一个PagedList实例从DataSource中加载最新的应用数据. 数据从应用后端或者数据库流入PagedList对象. 分页包支持多样的应用架构, 包括脱机数据库和与后台服务器通讯的数据库.
UI
PagedList类通过PagedListAdapter加载数据项到RecyclerView里面. 在加载数据的时候, 这些类协同工作, 拉取数据并展示内容, 包括预取看不见的内容并在内容改变时加载动画.
支持不同的数据架构
分页包支持应用架构, 包括应用拉取数据的地方是从后台服务器, 还是本机数据库, 还是两者的结合.
只有网络
要展示后台数据, 需要使用Retrofit的同步版本, 加载信息到自定义的DataSource对象中.
备注: 分页包的DataSource对象并没有提供任何错误处理机制, 因为不同的应用需要用不同的方式处理和展示UI错误. 如果错误发生了, 顺从结果的回调, 然后稍后重试.
只有数据库
要设置RecyclerView观测本地存储, 偏向于使用Room持久化库. 用这种方式, 无论任何时候数据库数据插入或者修改, 这些改变会自动地在负责展示这些数据的RecyclerView展示出来.
网络+数据库
在开始观测数据库之后, 你能够通过使用PagedList.BoundaryCallback来监听数据库什么时候过期. 之后, 你可能从网络拉取更多的数据, 并把它们插入到数据库中. 如果UI正在展示数据库, 以上就是你所需要做的全部.
下面的代码片断展示了BoundaryCallback的使用实例:
class ConcertViewModel {
fun search(query: String): ConcertSearchResult {
val boundaryCallback =
ConcertBoundaryCallback(query, myService, myCache)
// Error-handling not shown in this snippet.
val networkErrors = boundaryCallback.networkErrors
}
}
class ConcertBoundaryCallback(
private val query: String,
private val service: MyService,
private val cache: MyLocalCache
) : PagedList.BoundaryCallback() {
override fun onZeroItemsLoaded() {
requestAndSaveData(query)
}
override fun onItemAtEndLoaded(itemAtEnd: Concert) {
requestAndSaveData(query)
}
} 处理网络错误
在使用网络拉取或者分页的数据, 而这些数据正在使用分页包展示的时候, 不总是把网络分为要么"可用"要么"不可能"是很重要的, 因为许多连接是间歇性或者成片的:
特定的服务器可能不能响应网络请求;
设备可能联接了慢的或者弱的网络;
应用应该检查每一个请求是否成功, 并且在网络不可用的情形下, 尽可能快地恢复. 比如, 你可以为用户提供一个"重试"按钮, 如果数据没有刷新成功的话. 如果在数据分页期间发生错误, 最好自动地重新分页请求.
更新已有应用
如果应用已经从网络或者数据库消费数据, 很大可能可以直接升级到分页库提供的功能.
自定义分页解决方案
如果你使用了自定义功能加载数据源中的小的数据集, 你可以使用PagedList类取代这个逻辑. PagedList类实例提供了内建的连接, 到通用的数据源. 这些实例也提供了在应用中引用的RecyclerView的适配器.
使用列表而非分页加载的数据
如果你使用内存里的列表作为UI适配器的后备数据结构, 考虑使用PagedList类观测数据更新, 如果列表中数据项变得很多的话. PagedList实例既可以使用LiveData对UI传递数据更新, 同时最小化了加载时间和内存使用. 然而, 应用中使用PagedList对象代替List并不要求对UI结构和数据更新逻辑作任何改变.
使用CursorAdapter将数据cursor与列表视图联系起来
应用也许会使用CursorAdapter将数据从Cursor跟ListView连接起来. 在这种情况下, 通常需要从ListView迁移到RecyclerView, 然后使用Room或者PositionalDataSource构件代替Cursor, 当然, 这主要依据于Cursor实例能否访问SQLite数据库.
在一些情况下, 比如使用Spinner实例的时候, 你仅仅提供了Adapter本身. 然后一个库使用了加载进adapter中的数据, 并展示了数据. 在这些情况下, 把adapter数据类型转化为LiveData
使用AsyncListUtil异步加载内容
如果你在使用AsyncListUtil对象异步地加载和展示分组信息的话, 分页包将会使得加载数据更加方便:
数据并不需要定位. 分页包让你直接从后台使用网络提供的键加载数据.
数据量太大. 使用分页包可以将数据加载分页直到没有任何数据留下.
更方便地观测数据. 分页包能够展示应用在可观测数据结构中持有的ViewModel.
数据库例子
使用LiveData观测分页数据
下面的示例代码展示了所有一起工作的碎片. 当演唱会事件在数据库中添加, 删除或者修改的修改的时候, RecyclerView中的内容自动且高效地更新:
@Dao
interface ConcertDao {
// The Integer type parameter tells Room to use a PositionalDataSource
// object, with position-based loading under the hood.
@Query("SELECT * FROM user ORDER BY concert DESC")
fun concertsByDate(): DataSource.Factory
}
class MyViewModel(concertDao: ConcertDao) : ViewModel() {
val concertList: LiveData> = LivePagedListBuilder(
concertDao.concertsByDate(),
/* page size */ 20
).build()
}
class MyActivity : AppCompatActivity() {
public override fun onCreate(savedState: Bundle?) {
super.onCreate(savedState)
val viewModel = ViewModelProviders.of(this)
.get(MyViewModel::class.java!!)
val recyclerView = findViewById(R.id.concert_list)
val adapter = ConcertAdapter()
viewModel.concertList.observe(this, { pagedList ->
adapter.submitList(pagedList) })
recyclerView.setAdapter(adapter)
}
}
class ConcertAdapter() :
PagedListAdapter(DIFF_CALLBACK) {
fun onBindViewHolder(holder: ConcertViewHolder, position: Int) {
val concert = getItem(position)
if (concert != null) {
holder.bindTo(concert)
} else {
// Null defines a placeholder item - PagedListAdapter automatically
// invalidates this row when the actual object is loaded from the
// database.
holder.clear()
}
}
companion object {
private val DIFF_CALLBACK = object : DiffUtil.ItemCallback() {
// Concert details may have changed if reloaded from the database,
// but ID is fixed.
override fun areItemsTheSame(oldConcert: Concert,
newConcert: Concert): Boolean =
oldConcert.id == newConcert.id
override fun areContentsTheSame(oldConcert: Concert,
newConcert: Concert): Boolean =
oldConcert == newConcert
}
}
} 使用RxJava2观测分页数据
如果你偏爱使用RxJava2而非LiveData, 那么你可以创建Observable或者Flowable对象:
class MyViewModel(concertDao: ConcertDao) : ViewModel() {
val concertList: Flowable> = RxPagedListBuilder(
concertDao.concertsByDate(),
/* page size */ 50
).buildFlowable(BackpressureStrategy.LATEST)
} 之后你可以按照如下代码开始和停止观测数据:
class MyActivity : AppCompatActivity() {
private lateinit var adapter: ConcertAdapter
private lateinit var viewModel: MyViewModel
private val disposable = CompositeDisposable()
public override fun onCreate(savedState: Bundle?) {
super.onCreate(savedState)
val recyclerView = findViewById(R.id.concert_list)
viewModel = ViewModelProviders.of(this).get(MyViewModel::class.java!!)
adapter = ConcertAdapter()
recyclerView.setAdapter(adapter)
}
override fun onStart() {
super.onStart()
disposable.add(viewModel.concertList.subscribe({
flowableList -> adapter.submitList(flowableList)
}))
}
override fun onStop() {
super.onStop()
disposable.clear()
}
} 基于RxJava2解决方案的ConcertDao和ConcertAdapter代码, 和基于LiveData解决方案的代码是一样的.
UI构件及其出发点
将UI和视图模型联接起来
你可以按照如下方式, 将LiveData
private val adapter = ConcertPagedListAdapter()
private lateinit var viewModel: ConcertViewModel
override fun onCreate(savedInstanceState: Bundle?) {
viewModel = ViewModelProviders.of(this)
.get(ConcertViewModel::class.java)
viewModel.concerts.observe(this, adapter::submitList)
}当数据源提供一个新PagedList实例的时候, activity会将这些对象改善给adapter. PagedListAdapter实现, 定义了更新如何计算, 自动地处理分页和列表不同. 由此, 你的ViewHolder只需要绑定到特定的提供项:
