相關(guān)文章：
- 【翻譯】安卓架構(gòu)組件(1)-App架構(gòu)指導(dǎo)
- 【翻譯】安卓架構(gòu)組件(2)-添加組件到你的項(xiàng)目中
- 【翻譯】安卓架構(gòu)組件(3)-處理生命周期
- 【翻譯】安卓架構(gòu)組件(4)-LiveData
- 【翻譯】安卓架構(gòu)組件(5)-ViewModel
- 【翻譯】安卓架構(gòu)組件(6)-Room持久化類庫
分頁庫使你的app能夠在需要從一個(gè)數(shù)據(jù)源逐步加載數(shù)據(jù)時(shí)更為輕松照宝，避免了過度加載以及為了一個(gè)大型數(shù)據(jù)的查詢等待太多時(shí)間翔忽。
綜述
許多app伴隨著大量的數(shù)據(jù)挎狸，但是在任意時(shí)刻往往只需要加載和顯示其中的一小部分涡上。一個(gè)app可能存在數(shù)以萬計(jì)的數(shù)據(jù)以供顯示昆淡，但在某一時(shí)刻僅僅需要訪問其中的幾十條酿雪。如果app沒有認(rèn)真處理這個(gè)這個(gè)問題暑椰，會(huì)請(qǐng)求實(shí)際上并不需要的數(shù)據(jù)见咒，并導(dǎo)致不必要的性能負(fù)擔(dān)和網(wǎng)絡(luò)帶寬洽议。如果數(shù)據(jù)并沒有被存儲(chǔ)起來或同步到遠(yuǎn)程數(shù)據(jù)庫宗收，這同樣會(huì)減慢app的運(yùn)行速度以及浪費(fèi)用戶的流量。
當(dāng)然現(xiàn)有的安卓API允許對(duì)內(nèi)容進(jìn)行分頁亚兄，它們伴有明顯的約束和缺點(diǎn)：
-
CursorAdapter使得將數(shù)據(jù)庫查詢結(jié)果映射到ListView列表項(xiàng)更為輕松混稽，但它會(huì)在UI線程執(zhí)行數(shù)據(jù)庫查詢，并且使用Cursor的分頁并不高效审胚。對(duì)于使用CursorAdapter的更多缺陷匈勋，請(qǐng)查詢這里。 -
AsyncListUtil允許將基于位置的分頁數(shù)據(jù)加載至RecyclerView膳叨，但是并不允許無位置的分頁洽洁，而且它會(huì)強(qiáng)迫使用空白占用位。
新的分頁庫致力于解決這些問題菲嘴。這個(gè)類庫包含一些類饿自，以流水線的方式處理你所需數(shù)據(jù)的請(qǐng)求過程。這些類也可以和已經(jīng)存在的架構(gòu)類組件無縫結(jié)合龄坪，如Room昭雌。
類
分頁庫提供以下的類以及額外的支持類：
DataSource
使用這個(gè)類定義一個(gè)你用來分頁拉取的數(shù)據(jù)源。根據(jù)如何訪問你的數(shù)據(jù)健田，你可以集成以下兩個(gè)子類之一：
-
KeyedDataSource如果你需要從第N個(gè)數(shù)據(jù)項(xiàng)獲取第N+1個(gè)數(shù)據(jù)項(xiàng)烛卧。例如，如果你的線程在一個(gè)討論的app獲取評(píng)論抄课，你可能需要傳遞一個(gè)評(píng)論的id來獲取下一個(gè)評(píng)論唱星。 -
TiledDataSource如果你需要從你的數(shù)據(jù)源中獲取任意指定位置的分頁數(shù)據(jù)。這個(gè)類支持從你選擇的任何位置請(qǐng)求數(shù)據(jù)跟磨，例如：“返回從位置1200開始的20條數(shù)據(jù)”间聊。
如果你使用Room來管理你的數(shù)據(jù)，它會(huì)自動(dòng)創(chuàng)建一個(gè)TiledDataSource抵拘，例如：
@Query("select * from users WHERE age > :age order by name DESC, id ASC")
TiledDataSource<User> usersOlderThan(int age);
PagedList
這個(gè)類從DataSource加載數(shù)據(jù)哎榴。你可以配置在任何時(shí)刻該獲取多少數(shù)據(jù)，以及需要預(yù)加載多少數(shù)據(jù)，以最小化用戶等待數(shù)據(jù)被加載時(shí)等待的時(shí)間尚蝌。這個(gè)類可以給其他類提供更新信號(hào)迎变，例如RecyclerView.Adapter，允許當(dāng)數(shù)據(jù)分頁加載時(shí)更新你的RecyclerView飘言。
PagedListAdapter
這個(gè)類是RecyclerView.Adapter的子類衣形，使得數(shù)據(jù)從PagedList中展現(xiàn)。例如姿鸿，當(dāng)新的一頁數(shù)據(jù)被加載時(shí)谆吴，PagedListAdapter通知RecyclerView數(shù)據(jù)已經(jīng)到達(dá)，這讓RecyclerView替換任何占位項(xiàng)苛预，并展示合適的動(dòng)畫效果句狼。
PagedListAdapter使用后臺(tái)線程計(jì)算從一個(gè)PagedList到另一個(gè)的變化（例如，當(dāng)數(shù)據(jù)庫的變更導(dǎo)致數(shù)據(jù)的更新）热某，并調(diào)用notifyItem...()方法腻菇，并在需要時(shí)更新列表數(shù)據(jù)內(nèi)容。之后RecyclerView展現(xiàn)必要的變化昔馋。例如筹吐，當(dāng)一個(gè)數(shù)據(jù)項(xiàng)在不同的PagedList版本間變更位置時(shí)，RecyclerView動(dòng)畫會(huì)展示數(shù)據(jù)項(xiàng)移動(dòng)到新的位置秘遏。
LivePagedListProvider
這個(gè)生成從你提供的DataSource生成一個(gè)LiveData<PagedList>骏令。此外，如果你使用Room持久化類庫來管理你的數(shù)據(jù)庫垄提，DAO可以使用TiledDataSource生成LivePagedListProvider，例如：
@Query("SELECT * from users order WHERE age > :age order by name DESC, id ASC")
public abstract LivePagedListProvider<Integer, User> usersOlderThan(int age);
Integer參數(shù)告知Room基于位置加載的TiledDataSource周拐。
分頁庫組件在后臺(tái)線程組織了數(shù)據(jù)流铡俐，并在UI線程展示。例如：當(dāng)一個(gè)新的數(shù)據(jù)項(xiàng)被插入到你的數(shù)據(jù)庫時(shí)妥粟，DataSource會(huì)失效审丘， 后臺(tái)線程產(chǎn)生一個(gè)新的PagedList。
新創(chuàng)建的PagedList在UI線程被發(fā)送到PagedListAdapter滩报。之后PagedListAdapter使用DiffUtil在后臺(tái)線程計(jì)算當(dāng)前列表和新列表的不同。當(dāng)比較結(jié)束時(shí)播急，PagedListAdapter使用比較得到的差異信息適當(dāng)?shù)卣{(diào)用RecyclerView.Adapter.notifyItemInserted()來通知新的數(shù)據(jù)項(xiàng)被插入脓钾。
RecyclerView在UI線程知道僅僅需要綁定一個(gè)新的數(shù)據(jù)項(xiàng)，并使用動(dòng)畫展示在屏幕上桩警。
下面的代碼示例顯示了所有相關(guān)部分的工作可训。當(dāng)數(shù)據(jù)庫添加、刪除或者更新時(shí)，RecyclerView的內(nèi)容自動(dòng)且高效地更新：
@Dao
interface UserDao {
@Query("SELECT * FROM user ORDER BY lastName ASC")
public abstract LivePagedListProvider<Integer, User> usersByLastName();
}
class MyViewModel extends ViewModel {
public final LiveData<PagedList<User>> usersList;
public MyViewModel(UserDao userDao) {
usersList = userDao.usersByLastName().create(
/* 初始化加載位置 */ 0,
new PagedList.Config.Builder()
.setPageSize(50)
.setPrefetchDistance(50)
.build());
}
}
class MyActivity extends AppCompatActivity {
@Override
public void onCreate(Bundle savedState) {
super.onCreate(savedState);
MyViewModel viewModel = ViewModelProviders.of(this).get(MyViewModel.class);
RecyclerView recyclerView = findViewById(R.id.user_list);
UserAdapter<User> adapter = new UserAdapter();
viewModel.usersList.observe(this, pagedList -> adapter.setList(pagedList));
recyclerView.setAdapter(adapter);
}
}
class UserAdapter extends PagedListAdapter<User, UserViewHolder> {
public UserAdapter() {
super(DIFF_CALLBACK);
}
@Override
public void onBindViewHolder(UserViewHolder holder, int position) {
User user = getItem(position);
if (user != null) {
holder.bindTo(user);
} else {
// NULL時(shí)定義了一個(gè)占位項(xiàng)——當(dāng)實(shí)際的對(duì)象被從數(shù)據(jù)庫加載時(shí)握截，PagedListAdapter會(huì)自動(dòng)失效該行
holder.clear();
}
}
public static final DiffCallback<User> DIFF_CALLBACK = new DiffCallback<User>() {
@Override
public boolean areItemsTheSame(@NonNull User oldUser, @NonNull User newUser) {
// 用戶屬性可能會(huì)在重新加載時(shí)變化飞崖，但id是固定的。
return oldUser.getId() == newUser.getId();
}
@Override
public boolean areContentsTheSame(@NonNull User oldUser, @NonNull User newUser) {
// 注意：如果你使用equals谨胞，你的對(duì)象會(huì)重載Object.equals()方法
// 如果不正確地返回false會(huì)導(dǎo)致許多動(dòng)畫效果
return oldUser.equals(newUser);
}
}
}
