Android Jetpack架构组件(九)之Paging

一、Paging简介

在Android应用开发中,我们经常需要以列表的方式来展示大量的数据,这些数据可能来自网路,也可以来自本地的数据库。为了避免一次性加载大量的数据,对数据进行分页就显得很有必要。分页加载可以根据需要对数据进行按需加载,在不影响用户体验的前提下,提升应用的性能。

为了方便开发者进行分页处理,Google为开发者提供了分页组件(Paging),借助Paging组件开发者可以轻松的加载和呈现大型数据集,同时在 RecyclerView 中进行快速、无限滚动。并且,它可以从本地存储和/或网络加载分页数据,并让开发者能够定义内容的加载方式,同时它还支持与Room、LiveData 和 RxJava组合使用。

1.1 支持的架构类型

目前,Paging可以支持3种架构类型,分别是网路、数据、网路和数据库,架构的示意图如下所示。
在这里插入图片描述

网路

在Android应用开发中,对网路数据进行分页加载是一种比较常见的场景,也是我们平时开发中遇到得最多的。不同公司对分页机制所涉及的API接口通常会不一样,但总体而言,可以分为3中。针对这些不同的分类,Paging提供了PageKeyedDataSource、PositionalDataSource和ItemKeyedDataSource。

  • PageKeyedDataSource:根据传入的页面num获取某一页的数据,比如获取第2页的数据。
  • PositionalDataSource:分页时默认显示的第几页。
  • ItemKeyedDataSource:请求下一页的关键字。
数据库

除了网路外,数据源来源于数据库的场景也非常多,如果已经掌握了对网路数据的分页,那么对数据库的数据进行分页自然十分简单,只不过数据源的读取方式不同而已。

网路+数据库

在这种场景中,我们会对网路的数据进行缓存,而数据库就是比较场景的一种数据持久化方式,比如聊天应用中。首先,我们会利用数据库对网路数据进行缓存,不过在这种场景下,我们需要同时处理数据库和网路两个数据源,因此需要约定好网路和数据库的数据处理逻辑。

1.2 工作流程

在正式使用Paging之前,我们需要对Paging的工作流程有一个大致的了解。如下图所示,是使用Paging需要经历的几个步骤。
在这里插入图片描述
如上图所示,主要的步骤如下:

  1. 使用DataSource从服务器获取或者从本地数据库获取数据。
  2. 将数据保存到PageList中。
  3. 将PageList的数据交给PageListAdapter。
  4. PageListAdapter在后台线程对比原来的PageList和新的PageList,生成新的PageList。
  5. PageListAdapter通知RecyclerView进行数据的更新。

1.3 核心概念

使用Paging库进行分页加载时,需要用到几个核心的类,分别是PagedListAdapter、PageList和DataSource。

PagedListAdapter

众所周知,在Android列表开发中需要使用RecyclerView,并且需要配合自定义Adapter。PagedListAdapter继承于RecyclerView.Adapter,这表明它也是一个RecyclerView.Adapter,并且扩展了RecyclerView.Adapter的支持异步差分更新功能。

PageList

PageList是用于通知DataSource何时获取数据,以及如何获取数据。比如,何时获取第一页数据,以及何时开始加载数据等待。并且,DataSource数据源都将通过PageList设置给PagedListAdapter。

DataSource

DataSource主要用于执行数据的加载操作,并且数据的载入需要在子线程中进行,否则会造成主线程的阻塞。DataSource的来源可以是网路,也可以是本地的数据库,如Room。根据分页机制的不同,DataSource可以有3种来源,分别是PageKeyedDataSource、PositionalDataSource和ItemKeyedDataSource。

  • PageKeyedDataSource:根据传入的页面num获取某一页的数据,比如获取第2页的数据。
  • PositionalDataSource:分页时默认显示的第几页。
  • ItemKeyedDataSource:请求下一页的关键字。

二、基本使用

2.1 添加依赖

首先,在app的build.gradle文件中添加Paging组件库的依赖,如下所示。

dependencies {
   //网路请求库
   implementation 'com.squareup.retrofit2:retrofit:2.9.0'
   implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
   implementation 'com.squareup.retrofit2:adapter-rxjava2:2.7.1'
   implementation 'com.google.code.gson:gson:2.8.6'
   implementation 'com.squareup.okhttp3:okhttp:4.8.0'
   implementation 'com.squareup.okio:okio:2.7.0'
   //Paging
   def paging_version = "2.1.0"
   implementation "androidx.paging:paging-runtime:$paging_version"
 }

2.2 定义网路请求

在Android开发中,数据通常来源于网路,我们可以使用retrofit完成网络数据的请求。在获取数据之前,我们需要先新建一个数据实体类,主要用来存储获取的数据,如下所示是使用干货集中营的开源 Api 的数据的实体类。

public class DataBean {

    private int count;
    private boolean error;
    private List results;
    
    ...//省略get和set

    public static class ResultsBean {
        private String desc;
        private String ganhuo_id;
        private String publishedAt;
        private String readability;
        private String type;
        private String url;
        private String who;
       
        ... //省略get和set
    }
}

然后,为了完成网路请求,我们需要按照Retrofit的使用方式新建一个Api,用于统一管理请求接口,如下所示。

public interface Api {

    //开源API:http://gank.io/api/search/query/listview/category/Android/count/10/page/1
    @GET("api/search/query/listview/category/Android/count/10/page/{page}")
    Call> getArticleList1(@Path("page") int page);

}

然后,我们对Retrofit进行一个简单的封装,然后用它完成网路请求,如下所示。

public class RetrofitClient {

    private static RetrofitClient instance;
    private Retrofit mRetrofit;
    private OkHttpClient getClient(){
        OkHttpClient.Builder builder = new OkHttpClient().newBuilder()
                .connectTimeout(30, TimeUnit.SECONDS)//设置超时时间
                .readTimeout(10, TimeUnit.SECONDS)//设置读取超时时间
                .writeTimeout(10, TimeUnit.SECONDS);//设置写入超时时间
        return builder.build();
    }

    public RetrofitClient() {
        mRetrofit=new Retrofit.Builder()
                .addConverterFactory(GsonConverterFactory.create())
                .client(getClient())
                .build();

    }

    public static RetrofitClient getInstance() {
        if (instance==null){
            instance=new RetrofitClient();
        }
        return instance;
    }
    
    public  T createApi(Class cls){
        T t=mRetrofit.create(cls);
        return t;
    }
}

2.3 创建数据源

如果使用的是网路数据,使用Paging进行分页加载时需要自定义DataSource。前面说过,DataSource有3个抽象类,分别是PageKeyedDataSource、PositionalDataSource和ItemKeyedDataSource,因此实际使用时需要继承他们。

由于此处加载的是网络数据,所以使用PageKeyedDataSource更合适,我们新建一个继承自PageKeyedDataSource的自定义DataSource,如下所示。

public class PagingDataSource extends PageKeyedDataSource {

    private static final String TAG = PagingDataSource.class.getSimpleName();
    private int mPage = 1;

    @Override
    public void loadInitial(@NonNull LoadInitialParams params, @NonNull final LoadInitialCallback callback) {
        Api api = RetrofitClient.getInstance().createApi(Api.class);
        Call> call = api.getArticleList1(mPage);
        call.enqueue(new Callback>() {
            @Override
            public void onResponse(Call> call, Response> response) {
                if (response.isSuccessful() && response.code() == 200) {
                    List data  = response.body();
                    callback.onResult(data, "before", "after");
                }

            }

            @Override
            public void onFailure(Call> call, Throwable t) {
                Log.e(TAG, "--onFailure-->" + t.getMessage());
            }
        });
    }

    //加载上一页
    @Override
    public void loadBefore(@NonNull LoadParams params, @NonNull LoadCallback callback) {
        Log.i(TAG, "--loadBefore-->" + params.key);
    }

    //加载下一页
    @Override
    public void loadAfter(@NonNull final LoadParams params, @NonNull final LoadCallback callback) {
        mPage++;
        Api api = RetrofitClient.getInstance().createApi(Api.class);
        Call> call = api.getArticleList1(mPage);
        call.enqueue(new Callback>() {
            @Override
            public void onResponse(Call> call, Response> response) {
                if (response.isSuccessful() && response.code() == 200) {
                    List data  = response.body();
                    callback.onResult(data, params.key);
                }
            }

            @Override
            public void onFailure(Call> call, Throwable t) {
                Log.i(TAG, "--onFailure-->" + t.getMessage());
            }
        });
    }
}

在上面的代码中,PageKeyedDataSource需要重写三个方法。

  • loadInitial():第一次请求数据,即初始化状态时请求数据。
  • loadBefore():请求上一页数据,基本没有用处。
  • loadAfter(): 请求下一页数据。

DataSource创建好了,再创建一个DataSource.Factory,返回对应的DataSource实例,如下所示。

public class PagingDataSourceFactory extends DataSource.Factory {

    @NonNull
    @Override
    public DataSource create() {
        PagingDataSource dataSource = new PagingDataSource();
        return dataSource;
    }
}

2.4 配置分页参数

在Jetpack的架构里面,官方推荐每个页面持有一个ViewModel对象,以保证数据的正确性以及避免其他的问题产生。

在在 ViewModel 中创建 PagedList.Config 并进行分页参数配置,创建 DataSource 工厂对象,最终生成支持分页的 LiveData 数据。要想创建LiveData,需要先创建一个LivePagedListBuilder,LivePagedListbuilder有设分页数量和配置参数两种方法,如下所示。

public class PagingViewModel extends ViewModel {

    private int pageSize = 20;
    //PagedList配置
    private PagedList.Config config = new PagedList.Config.Builder()
            .setInitialLoadSizeHint(pageSize)//设置首次加载的数量
            .setPageSize(pageSize)//设置每页加载的数量
            .setPrefetchDistance(2)//设置距离每页最后数据项来时预加载下一页数据
            .setEnablePlaceholders(false)//设置是否启用UI占用符
            .build();

    //DataSource.Factory
    private DataSource.Factory factory = new PagingDataSourceFactory();

    //LiveData
    private LiveData> mPagedList = new LivePagedListBuilder<>(factory, config)
            .build();

    public LiveData> getPagedList() {
        return mPagedList;
    }

}

上面代码中,我们提到了占位符,占位符的作用是在数据完成渲染之前,向用户显示的默认视图效果。占位符具有以下优点:

  • 支持滚动条:PagedList 可向 PagedListAdapter 提供列表项数量。此信息允许适配器绘制滚动条来传达整个列表大小。有新页面载入时,滚动条不会跳到指定位置,因为列表不会改变大小。
  • 无需加载旋转图标:由于列表大小已知,因此无需提醒用户正在加载更多项。

不过,在添加对占位符的支持之前,请注意以下前提条件:

  • 需要可计数的数据集:Room 持久性库 中的 DataSource 实例可以有效地计算项的数量。但如果您使用的是自定义本地存储解决方案或网络专用数据架构,确定数据集包含多少项可能会开销极大,甚至根本无法确定。
  • 适配器必须考虑未加载的项:为准备列表以应对增长而使用的适配器或呈现机制需要处理 Null 列表项。例如,将数据绑定到 ViewHolder 时,您需要提供默认值来表示未加载数据。
  • 需要同样大小的项视图:如果列表项大小会随着内容而变(例如社交网络更新),则项之间的交叉渐变效果并不理想。在这种情况下,我们强烈建议停用占位符。

2.5 创建PagedListAdapter

PagedListAdapter是一个特殊的RecyclerView的RecyclerAdapter,使用方法也和RecyclerAdapter的使用方式类似,如下所示。

public class PagingAdapter extends PagedListAdapter {

    public PagingAdapter() {
        super(itemCallback);
    }

    @NonNull
    @Override
    public PagingAdapter.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_recycleview, parent, false);
        return new ViewHolder(view);
    }

    @Override
    public void onBindViewHolder(@NonNull PagingAdapter.ViewHolder holder, int position) {
        DataBean.ResultsBean bean = getItem(position);
        if (bean != null) {
            holder.desc.setText(bean.getDesc());
            holder.time.setText(bean.getPublishedAt());
            holder.type.setText(bean.getType());
            holder.auth.setText(bean.getWho());
        }
    }


    public class ViewHolder extends RecyclerView.ViewHolder{
        TextView desc;
        TextView time;
        TextView type;
        TextView auth;

        public ViewHolder(View itemView) {
            super(itemView);
            desc = itemView.findViewById(R.id.desc);
            time = itemView.findViewById(R.id.time);
            type = itemView.findViewById(R.id.type);
            auth = itemView.findViewById(R.id.auth);
        }
    }


    private static DiffUtil.ItemCallback itemCallback = new DiffUtil.ItemCallback() {
        @Override
        public boolean areItemsTheSame(@NonNull DataBean.ResultsBean oldItem, @NonNull DataBean.ResultsBean newItem) {
            return oldItem.getGanhuo_id().equals(newItem.getGanhuo_id());
        }

        @SuppressLint("DiffUtilEquals")
        @Override
        public boolean areContentsTheSame(@NonNull DataBean.ResultsBean oldItem, @NonNull DataBean.ResultsBean newItem) {
            return oldItem.equals(newItem);
        }
    };

}

在使用PagedListAdapter时,PagedListAdapter内部默认实现DiffUtil来进行数据的差量计算,所以我们在构造方法里面传递一个DiffUtil.ItemCallback。

2.6 加载分页数据

经过上面的处理后,接下来只需要在Activity中进行数据的请求和绑定即可,如下所示。

public class MainActivity extends AppCompatActivity {

    private final String TAG = "MainActivity";
    private ActivityMainBinding activityMainBinding;
    private PagingViewModel mViewModel;
    private PagingAdapter adapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        activityMainBinding = DataBindingUtil.setContentView(this, R.layout.activity_main);
        initRecyclerView();
//        getData();
    }

    private void initRecyclerView() {
        adapter = new PagingAdapter();

        LinearLayoutManager layoutManager = new LinearLayoutManager(this);
        layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
        activityMainBinding.recycle.setLayoutManager(layoutManager);
        activityMainBinding.recycle.addItemDecoration(new DividerItemDecoration(this,DividerItemDecoration.VERTICAL));
        activityMainBinding.recycle.setAdapter(adapter);

        ViewModelProvider mViewModelProvider = new ViewModelProvider(this,
                new ViewModelProvider.AndroidViewModelFactory(getApplication()));
        mViewModel = mViewModelProvider.get(PagingViewModel.class);

    }

    public void getData() {
        mViewModel.getPagedList().observe(this, new Observer>() {
            @Override
            public void onChanged(PagedList dataBeans) {
                adapter.submitList(dataBeans);
            }
        });
    }
}

我们使用 LiveData 监听加载的数据,然后使用 sumbitList 将数据提交给 PagedListAdapter,PagedListAdapter会在后台线程中对比新旧数据的差异,最后更新 RecyclerView。

三、Paging3

3.1 概述

Paging是JetPack框架提供的一个分页库,它可以帮助开发者从本地存储或通过网络加载显示数据,不过由于历史原因,早期的Paging存在各种使用上的问题,因此Android在后面提供了Paging3用来替换早期的Paging2。相比Paging2,Paging3有如下一些优点。

  • 在内存中缓存分页数据,确保 App 在使用分页数据时有效地使用系统资源。
  • 内置删除重复数据的请求,确保 App 有效地使用网络带宽和系统资源。
  • 可配置 RecyclerView 的 Adapters,当用户滚动到加载数据的末尾时自动请求数据。
  • 支持 Kotlin 协程和 Flow, 以及 LiveData 和 RxJava。
  • 内置的错误处理支持,包括刷新和重试等功能。

3.1.1 主要变化

在 Paging3 之前,Paging提供了 ItemKeyedDataSource、PageKeyedDataSource、PositionalDataSource 这三个类来进行数据获取的操作。

  • PositionalDataSource:用于加载数据有限的数据,比如加载本地数据库。
  • PageKeyedDataSource:用来请求网络数据,适用于通过页码分页来请求数据。
  • ItemKeyedDataSource:用来请求网络数据,它适用于通过当前页面最后一条数据的 id作为下一页的数据的开始的位置的场景。

在 Paging3 之后,ItemKeyedDataSource、PageKeyedDataSource、PositionalDataSource 合并为一个 PagingSource,所有旧 API 加载方法被合并到 PagingSource 中的单个 load() 方法中,如下所示。

abstract suspend fun load(params: LoadParams): LoadResult

除此之外,变化的内容还包括:

  • LivePagedListBuilder 和 RxPagedListBuilder 合并为了 Pager。
  • 使用 PagedList.Config 替换 PagingConfig。
  • 使用 RemoteMediator 替换了 PagedList.BoundaryCallback 去加载网络和本地数据库的数据。

3.1.2 重要概念

在正式学习Paging3之前,我们需要弄清楚几个重要的概念:

  • PagingSource:单一的数据源,可以表示数据库请求得到的数据,也可以是网络请求得到的数据。
  • RemoteMediator:单一的数据源,它会在 PagingSource 没有数据的时候,再使用 RemoteMediator 提供的数据,如果既存在数据库请求又存在网络请求,通常 PagingSource 用于进行数据库请求,RemoteMediator 进行网络请求。
  • PagingData:单次分页数据的容器。
  • Pager:用来构建 Flow<PagingData> 的类,实现数据加载完成的回调。
  • PagingDataAdapter:分页加载数据的 RecyclerView 的适配器。

总的来说,使用Paging3加载网络数据的流程是:PagingSource 和 RemoteMediator 充当数据源的角色,ViewModel 使用 Pager 中提供的 Flow<PagingData> 监听数据刷新,每当 RecyclerView 即将滚动到底部的时候,就会加载新的数据,最后再使用PagingAdapter 展示数据。

3.1.3 Paging3应用架构

下面是Android官方推荐的接入 Paging3的应用架构图。
在这里插入图片描述
可以发现,使用Paging3实现数据分页时主要包含3个对象:

#### 数据仓库层Repository

Repository层主要使用PagingSource这个分页组件来实现,每个PagingSource对象都对应一个数据源,以及该如何从该数据源中查找数据,PagingSource可以从任何单个数据源比如网络或者数据库中查找数据。

Repository层还有另一个分页组件可以使用RemoteMediator,它是一个分层数据源,比如有本地数据库缓存的网络数据源。

ViewModel层

Repository最终返回一个异步流包裹的PagingDataFlowValue>>,PagingData存储了数据结果,最终可以使用它将数据跟UI界面关联起来。ViewModel一般都使用LiveData来跟UI层交互,Flow的扩展函数可以直接转换成一个LiveData可观察对象。

UI层

UI层其实就是Activity/Fragment等视图层,主要的作用是给RecycleView设置Adapter,给Adater设置数据。

3.2 基本使用

3.2.1, 添加依赖

首先,在app的build.gradle文件中添加Paging3组件库的依赖,如下所示。

dependencies {
   ...
   //Paging3
   def paging_version = "3.0.0-alpha11"
   implementation "androidx.paging:paging-runtime:$paging_version"
 }

3.2.2 定义数据源

Paging 2提供了三种类型的 PageSource,开发者需要根据使用场景去进行选择。而Paging 3对数据源进行了统一处理,开发时只需要继承 PagingSource 即可。

Paging 3的数据源可以是PagingSource,也可以是RemoteMediator,它们的区别如下。

  • PagingSource:单一数据源以及如何从该数据源中查找数据,数据源的变动会直接映射到 UI 上。
  • RemoteMediator:实现加载网络分页数据并更新到数据库中,但是数据源的变动不能直接映射到 UI 上。

那实际使用时,如何进行选择呢?PagingSource主要用于加载有限的数据集,而RemoteMediator则主要用来加载网络分页数据,实际使用时需要结合 PagingSource 实现保存更多数据操作并映射到 UI 上。

下面以WanAndroid的接口为例,接口地址为:https://www.wanandroid.com/article/list/1/json,数据源的代码如下。

public class Paging3DataSource extends PagingSource  {


    @Nullable
    @Override
    public Object load(@NotNull LoadParams params, @NotNull Continuation> continuation) {
        int page = 0;
        if(params.getKey()!=null){
            page=params.getKey();
        }
        //获取网络数据
        ArticleBean result = (ArticleBean) RetrofitClient.getInstance().getApi().getArticleList(page);
        //需要加载的数据
        List datas= result.getData().getDatas();
        //如果可以往上加载更多就设置该参数,否则不设置
        String prevKey=null;
        //加载下一页的key 如果传null就说明到底了
        String nextKey=null;
        if(result.getData().getCurPage() == result.getData().getPageCount()){
            nextKey=null;
        }else {
            nextKey=String.valueOf(page+1);
        }
        return new LoadResult.Page<>(datas,prevKey,nextKey);
    }


}

在上面的代码中,自定义的PagingSource需要继承自PagingSource,需要传入两个泛型,第一个表示下一页数据的加载方式,另一个是返回数据的实体类。同时,自定义的PagingSource还需要重写load方法来触发异步加载,可以看到它是一个用suspend修饰的挂起函数,可以很方便的使用协程异步加载。

而load方法的参数LoadParams中有一个key值,可以在加载下一页数据时使用。返回值是一个LoadResult,出现异常调用LoadResult.Error(e),正常强开情况下调用LoadResult.Page方法来设置从网络或者数据库获取到的数据。

3.2.3 网络请求

在实际应用开发中,我们需要从网络中获取数据,然后再进行其他业务操作。网络请求一般会借助Retrofit来实现,下面是使用Retrofit完成WanAndroid接口请求的简单的封装,代码如下。

public class RetrofitClient {

    private static String BASE_URL="https://www.wanandroid.com/";
    private static RetrofitClient instance;
    private Retrofit mRetrofit;

    private OkHttpClient getClient(){
        HttpLoggingInterceptor interceptor = new HttpLoggingInterceptor(new HttpLoggingInterceptor.Logger() {
            @Override
            public void log(String message) {
                Log.i("RetrofitClient: ", message);
            }
        });
        interceptor.setLevel(HttpLoggingInterceptor.Level.BODY);

        OkHttpClient client = new OkHttpClient.Builder()
                .addInterceptor(interceptor)
                .connectTimeout(60, TimeUnit.SECONDS)
                .build();
        return client;
    }

    public RetrofitClient() {
        mRetrofit=new Retrofit.Builder()
                .baseUrl(BASE_URL)
                .addConverterFactory(GsonConverterFactory.create())
                .client(getClient())
                .build();
    }

    public static RetrofitClient getInstance() {
        if (instance==null){
            instance=new RetrofitClient();
        }
        return instance;
    }

    public  T createApi(Class cls){
        T t=mRetrofit.create(cls);
        return t;
    }

}

然后,在创建一个WanAndroidApi来管理所有的Api接口,如下所示。

public interface WanAndroidApi {

    @GET("article/list/{pageNum}/json")
    Call getArticleList(@Path("page") int page);
}

3.2.4 构建ViewModel

分页数据的容器被称为 PagingData,每次刷新数据时,都会创建一个 PagingData 的实例。如果要创建 PagingData 数据流,那么需要创建一个 Pager 实例,并提供一个 PagingConfig 配置对象和一个可以告诉 Pager 如何获取您实现的 PagerSource 的实例的函数,以供 Pager 使用。

实际开发中,Repository返回的是一个异步流包裹的PagingDataFlowValue>>,PagingData存储了数据结果。而在MVVM中,我们需要构建ViewModel来实现是LiveData和UI层交互,而ViewModel的Flow的扩展函数可以将直接将PagingSource转换成一个LiveData可观察对象,代码如下。

public class Paging3ViewModel extends ViewModel {

    PagingConfig pagingConfig = new PagingConfig(20, 3);

    public LiveData> getArticleData() {
        CoroutineScope viewModelScope = ViewModelKt.getViewModelScope(this);
        Pager pager = new Pager<>(pagingConfig, () -> new Paging3DataSource());
        LiveData> cachedResult=PagingLiveData.cachedIn(PagingLiveData.getLiveData(pager), viewModelScope);
        return cachedResult;
    }

}

3.2.5 创建Adapter

和Paging2的Adapter使用步骤类似,在Paging3中创建Adapter需要继承 PagingDataAdapter,然后提供 DiffUtil.ItemCallback<T>,如下所示。

public class Paging3Adapter extends PagingDataAdapter {


    public Paging3Adapter(@NotNull DiffUtil.ItemCallback diffCallback) {
        super(itemCallback);
    }

    @NonNull
    @Override
    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_recycleview, parent, false);
        return new Paging3Adapter.ViewHolder(view);
    }

    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        ArticleBean.DataBean.DatasBean bean = getItem(position);
        if (bean != null) {
            holder.desc.setText(bean.getDesc());
            holder.time.setText(String.valueOf(bean.getPublishTime()));
            holder.type.setText(bean.getType());
            holder.auth.setText(bean.getAuthor());
        }
    }

    public static class ViewHolder extends RecyclerView.ViewHolder{
        TextView desc;
        TextView time;
        TextView type;
        TextView auth;

        public ViewHolder(View itemView) {
            super(itemView);
            desc = itemView.findViewById(R.id.desc);
            time = itemView.findViewById(R.id.time);
            type = itemView.findViewById(R.id.type);
            auth = itemView.findViewById(R.id.auth);
        }
    }


    public static DiffUtil.ItemCallback itemCallback = new DiffUtil.ItemCallback() {
        @Override
        public boolean areItemsTheSame(@NonNull ArticleBean.DataBean.DatasBean oldItem, @NonNull ArticleBean.DataBean.DatasBean newItem) {
            return oldItem.getId()==newItem.getId();
        }

        @SuppressLint("DiffUtilEquals")
        @Override
        public boolean areContentsTheSame(@NonNull ArticleBean.DataBean.DatasBean oldItem, @NonNull ArticleBean.DataBean.DatasBean newItem) {
            return oldItem.equals(newItem);
        }
    };
}

可以发现,Paging3Adapter的代码和普通的Adapter的代码是差不多的,也是需要重写onCreateViewHolder和onBindViewHolder两个方法。

3.2.6 在UI 中展示数据

最后,我们在Activity中使用RecyclerView展示获取的数据即可,如下所示。

public class MainActivity extends AppCompatActivity {

    private final String TAG = "MainActivity";
    private Paging3Adapter adapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView( R.layout.activity_main);
        initRecyclerView();
    }

    private void initRecyclerView() {
        adapter = new Paging3Adapter();
        RecyclerView  recyclerView = findViewById(R.id.recycle);
        recyclerView.addItemDecoration(new DividerItemDecoration(this,DividerItemDecoration.VERTICAL));
        recyclerView.setAdapter(adapter);

        Paging3ViewModel viewModel=new ViewModelProvider(this).get(Paging3ViewModel.class);

        viewModel.getArticleData().observe(this, pagingData -> adapter.submitData(getLifecycle(),pagingData));
    }
}

除此之外,Paging3还支持添加 Header 和 Footer来实现上拉刷新和下拉加载更多的功能。

参考: 使用官方Paging3分页库实现RecyclerView加载更多

你可能感兴趣的