官方上拉加载Paging 配合SwipeRefreshLayout使用

下拉刷新Android原生的解决方案是SwipeRefreshLayout,简单好用。
那么上拉加载有没有官方控件呢?有,就是Paging

可惜看了官方文档,要搞一大堆啊,还不如我给RecycleView加个addOnScrollListener监听。
并且官方文档都是依靠Room,自动写好了相关的DataSource.Factory和DataSource。要是我用的是原生Sqlite呢?下面我们来说一说。

1.引入

    implementation 'android.arch.paging:runtime:2.1.0'

2.自定义DataSource和DataSource.Factory

看看Room自动生成的LimitOffsetDataSource,其实也是利用数据库的Limit & Offset关键词,一个是一页的数量;一个是偏移量,每次上拉增加。

可以看到,LimitOffsetDataSource是继承了PositionalDataSource。DataSource其实有三大子类,为什么选择PositionalDataSource呢?
选择正确的数据源类型

DataSource三大子类.png

如果通过网络获取数据,我们可以选择PageKeyDataSource。根据传入的页数参数来加载。或者是帖子场景,根据上一个帖子的ID来获取下一个帖子的数据——官方例子

    private static final int PAGE_SIZE = 5;
    class TaskBeanDataSource extends PositionalDataSource<TaskBean> {
        private int mOffset = 0;
        private List<TaskBean> getTaskBeanList(){
            mOffset += PAGE_SIZE;
            return DBManager.getInstance().getTaskBeanList(PAGE_SIZE, mOffset);
        }

        @Override
        public void loadInitial(@NonNull LoadInitialParams params, @NonNull LoadInitialCallback<TaskBean> callback) {
            List<TaskBean> taskPackageList = getTaskBeanList();
            int totalCount = taskPackageList.size();
            int position = computeInitialLoadPosition(params, totalCount);
            int loadSize = computeInitialLoadSize(params, position, totalCount);
            callback.onResult(taskPackageList, position, loadSize);
        }

        @Override
        public void loadRange(@NonNull LoadRangeParams params, @NonNull LoadRangeCallback<TaskBean> callback) {
            List<TaskBean> taskPackageList = getTaskBeanList();
            callback.onResult(taskPackageList);
        }

    }

    class TaskBeanDataSourceFactory extends DataSource.Factory<Integer, TaskBean> {

        @Override
        public DataSource<Integer, TaskBean> create() {
            return new TaskBeanDataSource();
        }

    }

PS:其实这里用不到三个参数,setEnablePlaceholders设为false,调两个参数的方法就行了,但发现用三个参数的也不影响。

            //callback.onResult(taskPackageList, position, loadSize);
            callback.onResult(taskPackageList, position);
image.png

数据库操作也利用Limit & Offset

    public List<TaskBean> getTaskBeanList(int pageSize, int offset) {
        SQLiteDatabase db = mDBHelper.getWritableDatabase();
        Cursor cursor = null;
        List<TaskBean> taskBeanList = new ArrayList<>();
        try {
            StringBuilder sql = new StringBuilder();
            sql.append("SELECT * FROM task LIMIT ").append(pageSize).append(" OFFSET ").append(offset);
            cursor = db.rawQuery(sql.toString(), null);
            while (cursor.moveToNext()) {
                TaskBean taskBean = new TaskBean();
                taskBean.setId(cursor.getString(cursor.getColumnIndex("id")))
                taskBeanList.add(taskBean);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            closeCursor(cursor);
        }
        return taskBeanList;
    }

3.修改ViewModel

   public class TaskViewModel extends ViewModel {
    private static final int PAGE_SIZE = 5;
    public final LiveData<PagedList<TaskBean>> mListLiveData;

        public TaskViewModel() {
        TaskBeanDataSourceFactory sourceFactory = new TaskBeanDataSourceFactory();
        PagedList.Config pagedListConfig =
                new PagedList.Config.Builder().setEnablePlaceholders(false)
                        .setInitialLoadSizeHint(PAGE_SIZE)
                        .setPageSize(PAGE_SIZE).build();
        mListLiveData = new LivePagedListBuilder<>(sourceFactory, pagedListConfig).build();
        }
    }
  

注意这里要将setEnablePlaceholders设为false,如果设为true,那么就自动加载不了了。
因为这个这个要起作用,需要知道所有数据的大小,所以还是设为false吧。(话说设为true,出现占位符的效果有人实现过吗,大家可以试试看)
在界面中提供占位符

占位符.png

4.改造原有的adapter,继承PagedListAdapter。

去掉getItemCount()方法,PagedListAdapter会自己处理。
添加DiffUtil对比

 public class TaskListAdapter extends PagedListAdapter<TaskBean, TaskListAdapter.ViewHolder> {

        protected TaskListAdapter() {
            super(DIFF_CALLBACK);
        }

    @Override
    public void onBindViewHolder(@NonNull ConcertViewHolder holder, int position) {
        //通过getItem拿到对应position的bean。这个getItem方法,就会触发PagedList的loadAround(int index)方法,触发加载更多
        TaskBean taskBean = getItem(position);
        //防止第一次加载,数据为空,崩溃
        if (taskBean == null) {
            return;
        }
        holder.tvTitle.setText(taskBean.getTaskName());
    }

    private static DiffUtil.ItemCallback<TaskBean> DIFF_CALLBACK =
            new DiffUtil.ItemCallback<TaskBean>() {
                @Override
                public boolean areItemsTheSame(TaskBean oldTaskBean, TaskBean newTaskBean) {
                    return oldTaskBean == newTaskBean;
                }

                @Override
                public boolean areContentsTheSame(TaskBean oldTaskBean, TaskBean newTaskBean) {
                    return oldTaskBean.getIndex().equals(newTaskBean.getIndex());
                }
            };
    }

5.绑定数据

    public class TaskListActivity extends AppCompatActivity {
        @Override
        public void onCreate(@Nullable Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            TaskListViewModel viewModel = ViewModelProviders.of(this).get(TaskListViewModel.class);
            TaskListAdapter adapter = new TaskListAdapter();
            viewModel.taskBeanList.observe(this, adapter::submitList);
            recyclerView.setAdapter(adapter);
        }
    }

ps: adapter::submitList这个双引号操作符,是Java8之后新增的,方法引用。
最原始的表达:

        viewModel.taskBeanList.observe(this, new Observer<PagedList<TaskBean>>() {
            @Override
            public void onChanged(PagedList<TaskBean> taskBeans) {
                mTaskListAdapter.submitList(taskBeans);
            }
        });

使用lambda:

        viewModel.taskBeanList.observe(this, taskBeans -> mTaskListAdapter.submitList(taskBeans));

使用双冒号,省略了参数:

        viewModel.taskBeanList.observe(this, mTaskListAdapter::submitList);

6.配合SwipeRefreshLayout使用

        swipeRefreshLayout.setOnRefreshListener(new SwipeRefreshListener() {
            @Override
            public void onRefresh() {
                viewModel.invalidateDataSource();
            }
        });

         viewModel.taskBeanList.observe(this, new Observer<PagedList<TaskBean>>() {
            @Override
            public void onChanged(PagedList<TaskBean> taskBeans) {
                mTaskListAdapter.submitList(taskBeans);
                mSwipeRefreshLayout.setRefreshing(false);
            }
        });

        在viewModel添加invalidateDataSource方法,作用就是让现有的数据源失效。
        public void invalidateDataSource () {
            mListLiveData.getValue().getDataSource().invalidate();
        }

并且修改TaskBeanDataSource ,下拉刷新了,总要把offset置为0吧。

 class TaskBeanDataSource extends PositionalDataSource<TaskBean> {
        private int mOffset = 0;

        private List<TaskBean> getTaskBeanListInit() {
            mOffset = 0;
            return DroneDBManager.getInstance().getTaskBeanList(PAGE_SIZE, mOffset);
        }

        private List<TaskBean> getTaskBeanList() {
            mOffset += PAGE_SIZE;
            return DroneDBManager.getInstance().getTaskBeanList(PAGE_SIZE, mOffset);
        }

        @Override
        public void loadInitial(@NonNull LoadInitialParams params, @NonNull LoadInitialCallback<TaskBean> callback) {
            List<TaskBean> taskPackageList = getTaskBeanListInit();
            int totalCount = taskPackageList.size();
            int position = computeInitialLoadPosition(params, totalCount);
            int loadSize = computeInitialLoadSize(params, position, totalCount);
            callback.onResult(taskPackageList, position, loadSize);
        }

        @Override
        public void loadRange(@NonNull LoadRangeParams params, @NonNull LoadRangeCallback<TaskBean> callback) {
            List<TaskBean> taskPackageList = getTaskBeanList();
            callback.onResult(taskPackageList);
        }

    }

官方的坑

官方实现invalidateDataSource()方法是这样的——考虑内容更新的运作方式
DataSourceFactory:

    public class ConcertTimeDataSourceFactory
            extends DataSource.Factory<Date, Concert> {
        private MutableLiveData<ConcertTimeDataSource> sourceLiveData =
                new MutableLiveData<>();

        private ConcertDataSource latestSource;

        @Override
        public DataSource<Date, Concert> create() {
            latestSource = new ConcertTimeDataSource();
            sourceLiveData.postValue(latestSource);
            return latestSource;
        }
    }
    

viewModel:

    public class ConcertTimeViewModel extends ViewModel {
        private LiveData<PagedList<Concert>> concertList;
        private DataSource<Date, Concert> mostRecentDataSource;

        public ConcertTimeViewModel(Date firstConcertStartTime) {
            ConcertTimeDataSourceFactory dataSourceFactory =
                    new ConcertTimeDataSourceFactory(firstConcertStartTime);
            mostRecentDataSource = dataSourceFactory.create();
            concertList = new LivePagedListBuilder<>(dataSourceFactory, 50)
                    .setFetchExecutor(myExecutor)
                    .build();
        }

        public void invalidateDataSource() {
            mostRecentDataSource.invalidate();
        }
    }
    

我试了过,用 mostRecentDataSource = dataSourceFactory.create();这个来操作,根本不会重新触发DataSource的loadInitial方法。
另外这个sourceLiveData什么鬼,根本没地方用到。这就是官方文档诡秘之处;要不造一个对象没地方用到,要不用到一个对象却不知道哪里生成的

其实要这个sourceLiveData要用也是可以,但是要这样用:

    public class ConcertTimeViewModel extends ViewModel {
        private LiveData<PagedList<Concert>> concertList;
        private DataSource<Date, Concert> mostRecentDataSource;
        private final ConcertTimeDataSourceFactory mSourceFactory;

        public ConcertTimeViewModel(Date firstConcertStartTime) {
            mSourceFactory =
                    new ConcertTimeDataSourceFactory(firstConcertStartTime);
            mostRecentDataSource = dataSourceFactory.create();
            concertList = new LivePagedListBuilder<>(dataSourceFactory, 50)
                    .setFetchExecutor(myExecutor)
                    .build();
        }

        public void invalidateDataSource() {
            //mostRecentDataSource.invalidate();
            mSourceFactory.sourceLiveData.getValue().invalidate();
        }
    }

总结

  1. 你如果不是通过Room使用Paging,那么就要自定义DataSource+DataSource.Factory+(PagedListAdapter用不用room都要),相比用RecycleView的addOnScrollListener监听来实现上拉加载,省略了是否到底的判断。
  2. 造成列表数据是一次性获取全部数据的假象,一直往上拉一直出数据。貌似是一次全部获取的,其实是分段加载的。
  • 传统的上拉加载更多分页效果,应该类似 淘宝APP 这种,滑到底部,再上拉显示footer,才会加载数据:
    传统的上拉加载更多分页效果
  • 无限滚动分页效果,像是 京东APP 这样,如果我们慢慢滑动,当滑动了一定量的数据(这个阈值一般是数据总数的某个百分比)时,会自动请求加载下一页的数据,如果我们继续滑动,到达一定量的数据时,它会继续加载下一页数据,直到加载完所有数据——在用户看来,就好像是一次就加载出所有商品一样:
    无限滚动分页效果

你是怎么看待官方上拉加载Paging?你会考虑用?,大家评论评论呗。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 200,738评论 5 472
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,377评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 147,774评论 0 333
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,032评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,015评论 5 361
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,239评论 1 278
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,724评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,374评论 0 255
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,508评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,410评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,457评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,132评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,733评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,804评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,022评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,515评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,116评论 2 341