android中常用的下拉刷新加载更多_Android Paging组件在MVVM架构中的使用指南（二）...

最新推荐文章于 2023-06-10 16:37:16 发布
最新推荐文章于 2023-06-10 16:37:16 发布
阅读量370 收藏
点赞数
文章标签： android中常用的下拉刷新加载更多

一 前言

在上一篇Android Paging组件在MVVM架构中的使用指南(一)中，我初步介绍了Android Jetpack Paging组件在MVVM架构中的基础使用方法，其中数据源使用了Github api也就是网络数据源，因此我们自然会想到：网络连接错误怎么办？事实上，如果按照上一篇中实现的话，一旦在数据分页时遇到网络连接错误，即使网络重新稳定，也不会重新触发分页了，这显然是不能接受的，因此我将在本篇着手处理网络连接错误。

官方文档中关于处理网络连接错误中提到：

使用网络对使用分页库显示的数据进行抓取或分页时，切记不要始终将网络视为“可用”或“不可用”，因为许多连接会断断续续或不稳定：

  • 特定服务器可能无法响应网络请求。
  • 设备可能连接到速度较慢或信号较弱的网络。

您的应用应检查每个请求是否失败，并在网络不可用的情况下尽可能正常恢复。例如，如果数据刷新步骤不起作用，您可以提供“重试”按钮供用户选择。如果在数据分页步骤中发生错误，则最好自动重新尝试分页请求。

我认为这段话比较重要的有三点：

  1. 不能通过判断当前网络是否连通判断网络请求是否成功；
  2. 下拉刷新不成功时，页面要显示重试按钮；
  3. 数据下滑分页加载不成功时，需要在下一次滚动时尝试分页请求。

这是官方文档的推荐做法，也是我在这篇文章中最终实现的方式。

二 思路

明确一下页面数据加载逻辑。

  1. 下拉刷新：将调用loadInitial方法和loadAfter方法，在loadInitial成功时即显示下拉刷新成功，失败时即显示下拉刷新失败，并出现重试按钮，点击重试会重新请求数据；

7c587c21480788e9516bd7faf87f002f.gif

    

8d85e896e8f90e5c6ac10466980775ad.gif

  1. 上拉加载：存在两种情况，上拉加载会出现：

  • 用户向下滑动过快，数据还未填充，上拉加载会出现，但此时实际上已调用了loadAfter方法，只是数据还未加载成功，加载成功后即显示上拉加载成功，注意此时为了避免重复加载数据，需要去除已添加的数据加载事件，失败后即显示上拉加载失败，并添加数据加载事件，以备下次加载数据；

a7e1a78431a6367b891d1eb8c5f2770c.gif

80e7d1bb8ace468dec0200444c878923.gif

  • 用户向下滑动时，loadAfter方法出现错误，此时需要为上拉加载添加加载事件，用户在下一次滚动时，将出现上拉加载，并调用添加的事件加载数据，后续操作同上。

这个的展示效果不明显，读者可自行测试。

全部数据加载完成后，上拉加载需要显示无更多数据。

cf02f78d012c370bd4b5e90e5a197abe.gif

这三点就是我们需要考虑的页面数据加载逻辑。

根据页面逻辑可以设计出回调接口为：

public interface NetworkState {
    // 加载成功
    void onSuccess();

    // 加载中
    void onLoading();

    // 初始加载|下拉刷新
    void onLoadInitialError(Runnable runnable, String errorMessage);

    // 分页加载|上拉加载
    void onLoadAfterError(Runnable runnable, String errorMessage);

    // 数据加载全部完成
    void onFinish();
}

下面讲解该接口的具体使用方法。

三 安装

implementation "com.google.android.material:material:1.2.1" // snack bar
implementation 'com.scwang.smart:refresh-layout-kernel:2.0.1'      //核心必须依赖
implementation 'com.scwang.smart:refresh-header-classics:2.0.1'    //经典刷新头

相比于第一篇，添加了谷歌material库和下拉刷新SmartRefreshLayout[1]库。

四 实现

4.1 完善GithubDataSource

主要是对loadInitial和loadAfter方法添加错误处理：

@Override
public void loadInitial(@NonNull LoadInitialParams params, @NonNull LoadInitialCallback callback) {
    networkState.onLoading(); // 数据加载中
    Call call = githubService.query(query, sort, FIRST_PAGE, PAGE_SIZE);try {
        Response resResponse = call.execute();
        GithubRes res = resResponse.body();if (res != null) {// 数据加载成功
            networkState.onSuccess();
            callback.onResult(res.items, null, FIRST_PAGE + 1);
        } else
            networkState.onLoadInitialError(() -> loadInitial(params, callback), "访问错误！"); // 数据为空
    } catch (IOException e) {
        e.printStackTrace();
        networkState.onLoadInitialError(() -> loadInitial(params, callback), e.getMessage()); // 数据加载失败
    }
}@Overridepublic void loadAfter(@NonNull LoadParams params, @NonNull LoadCallback callback) {
    Call call = githubService.query(query, sort, params.key, PAGE_SIZE);try {
        GithubRes res = call.execute().body();if (res != null) {
            networkState.onSuccess();if (!res.complete)
                callback.onResult(res.items, params.key + 1);else {
                callback.onResult(res.items, null);
                networkState.onFinish();
            }
        } else
            networkState.onLoadAfterError(() -> loadAfter(params, callback), "访问错误！");
    } catch (IOException e) {
        e.printStackTrace();// 回调
        networkState.onLoadAfterError(() -> loadAfter(params, callback), e.getMessage());
    }
}

仔细的读者会发现我仅在loadInitial中添加了networkState.onLoading()方法，这是因为上拉加载会有单独的loading动画。

4.3 在Activity中实现接口

main_activity.xml

<?xml  version="1.0" encoding="utf-8"?>
<com.scwang.smart.refresh.layout.SmartRefreshLayout xmlns:tools="http://schemas.android.com/tools"xmlns:android="http://schemas.android.com/apk/res/android"android:id="@+id/refreshLayout"android:layout_width="match_parent"android:layout_height="match_parent">
    <LinearLayoutandroid:id="@+id/container"android:layout_width="match_parent"android:layout_height="match_parent"tools:context=".MainActivity"android:orientation="vertical">
        <LinearLayoutandroid:layout_width="match_parent"android:layout_height="wrap_content"android:orientation="horizontal">
            <EditTextandroid:id="@+id/search_repo"android:layout_width="0dp"android:layout_height="wrap_content"android:layout_weight="1"android:hint="请输入搜索内容"android:imeOptions="actionSearch"android:inputType="textNoSuggestions"android:selectAllOnFocus="true"android:text="Android"/>
            <Buttonandroid:id="@+id/search"android:text="搜索"android:backgroundTint="@color/colorAccent"android:layout_width="wrap_content"android:layout_height="wrap_content"/>
        LinearLayout>
        <androidx.recyclerview.widget.RecyclerViewandroid:id="@+id/recycler_view"android:layout_width="match_parent"android:layout_height="wrap_content"/>
        <ProgressBarandroid:id="@+id/progress_circular"android:layout_width="match_parent"android:layout_height="wrap_content"android:visibility="gone"/>
    LinearLayout>
com.scwang.smart.refresh.layout.SmartRefreshLayout>

添加了SmartRefreshLayout和ProgressBar。

其中SmartRefreshLayout用于下拉刷新和上拉加载，ProgressBar会在初始加载页面中出现。

onSuccess方法实现：

public void onSuccess() {
    runOnUiThread(() -> {
        progressBar.setVisibility(View.GONE);
        if (refresh.getState() == RefreshState.Refreshing)
            refresh.finishRefresh(true);
        if (refresh.getState() == RefreshState.Loading){
            refresh.finishLoadMore(true);
          refresh.setOnLoadMoreListener(null);   
        }
    });
}

此处必须在Ui线程对页面元素的可见性进行修改，因此使用了runOnUiThread方法进行了包装，这里的finishRefresh和finishLoadMore表示下拉刷新和上拉加载已经成功，结束展示。

onLoading方法实现：

public void onLoading() {
    runOnUiThread(() -> {
        progressBar.setVisibility(View.VISIBLE);
    });
}

上文中也已经提到，该方法将仅在初次加载时被触发。

onLoadInitialError方法实现：

public void onLoadInitialError(Runnable runnable, String errorMessage) {
    runOnUiThread(() -> {
        progressBar.setVisibility(View.GONE);
        if (refresh.getState() == RefreshState.Refreshing)
            refresh.finishRefresh(false);
    });
    Snackbar.make(findViewById(android.R.id.content), errorMessage, Snackbar.LENGTH_INDEFINITE)
            .setAction("RETRY", view -> executorService.submit(runnable)).show();
}

初次加载成功，progressBar将调用onSuccess方法隐藏，否则调用onLoadInitialError方法隐藏，由于已经设置在不满一页时不可以上拉加载，因此在这里无需处理上拉加载的状态。

onLoadAfterError方法实现：

public void onLoadAfterError(Runnable runnable, String errorMessage) {
    runOnUiThread(() -> {
        if (refresh.getState() == RefreshState.Loading)
            refresh.finishLoadMore(false);
    });
    refresh.setOnLoadMoreListener(refreshLayout -> executorService.submit(runnable));
}

对应于页面数据加载逻辑：

  1. 当用户向下滑动过快，数据还未填充，上拉加载将出现，但此时DataSource实际上已调用了loadAfter方法，成功后将调用onSuccess方法隐藏，并通过refresh.setOnLoadMoreListener(null);代码删除绑定事件，避免重复加载数据，失败后将调用onLoadAfterError方法隐藏，并通过refresh.setOnLoadMoreListener(refreshLayout -> executorService.submit(runnable));代码绑定事件，用于下次请求数据；
  2. 用户向下滑动时，loadAfter方法出现错误，将调用onLoadAfterError方法，为上拉加载绑定事件，在用户下次上拉时会调用绑定的事件，成功后将调用onSuccess方法隐藏，并删除绑定事件，失败后将调用onLoadAfterError方法隐藏，并绑定事件，用户下次上拉时将重复该流程。

onFinish方法实现：

public void onFinish() {
    runOnUiThread(refresh::finishLoadMoreWithNoMoreData);
}

SmartRefreshLayout确实封装的相当好了，只需要这一个方法即可完成任务。

刷新方法实现：

VieModel:
private MutableLiveData mGithubDataSource;public void setItemPagedList(String query, String sort) {
    GithubDataSourceFactory factory = new GithubDataSourceFactory(query, sort, networkState);
    ---
    mGithubDataSource = factory.getmGithubDataSource();
    ---
}public void invalidate() {if (mGithubDataSource != null && mGithubDataSource.getValue() != null)
        mGithubDataSource.getValue().invalidate();
}
Activity:
refresh.setOnRefreshListener(refreshLayout -> {
    mainViewModel.invalidate();
});

用户下拉刷新时，若成功，将调用onSuccess方法隐藏，否则调用onLoadInitialError方法隐藏，并出现Snackbar，显示重试按钮，点击重试按钮即可重新加载数据，当然也可以下拉刷新重新加载数据。

五 结语

实际上，在开始写Paging博客之前，我在项目开发时就已经被这个问题阻碍了很久，一直没有想到一种比较好的解决方式，网上关于Paging的博客也大多未介绍处理网络错误的部分，或者处理的不那么优雅，这次我花费了一天的时间，认真思考，也耐心的阅读了很多使用Kotlin语言处理网络错误的文章，他们给了我很大的启发，感谢他们！最终，自认为找到了一种相对优雅的实现方式，当然，还是存在很多可以改进的地方，如果各位有更好的方式，或者在使用中发现了问题，还麻烦批评指正。

六 源码

源码已经上传至github[2]，欢迎star。

七 参考

  1. Using Android Paging library with Retrofit[3]
  2. Paging Library with Android MVVM[4]
  3. Android官方文档[5]

参考资料

[1]

SmartRefreshLayout: https://github.com/scwang90/SmartRefreshLayout

[2]

github: https://github.com/Civitasv/Android-Paging

[3]

Using Android Paging library with Retrofit: https://medium.com/@SaurabhSandav/using-android-paging-library-with-retrofit-fa032cac15f8

[4]

Paging Library with Android MVVM: https://www.linkedin.com/pulse/paging-library-android-mvvm-paul-hundal

[5]

Android官方文档: https://developer.android.com/topic/libraries/architecture/paging

weixin_39851008
关注
Android Jetpack架构组件之 Paging（使用、源码篇）
浅谈Android
10-22 7889
1、前言 最近简单看了下google推出的框架Jetpack，感觉此框架的内容可以对平时的开发有很大的帮助，也可以解决很多开发中的问题，对代码的逻辑和UI界面实现深层解耦，打造数据驱动型UI界面。 Android Architecture组件是Android Jetpack的一部分，它们是一组库，旨在帮助开发者设计健壮、可测试和可维护的应用程序，包含一下组件： 带你领略Android Je...
Android_Jetpack:Paging组件之PageKeyedDataSource的MVVM使用
nanquan11的博客
11-27 1342
PageKeyedDataSource是比较常见的一种DataSource，适用于数据源以“页”的方式进行请求的情况。例如，请求参数为page=2&pagesize=10，则表示数据源以10条数据为一页，当前返回第二页的5条数据。 接下来首先来按照MVVM架构跑通一个笑话大全数据接口，这里使用的是最新笑话接口，key是我自己注册的。 接口：http://v.juhe.cn/joke/content/text.php?key=您申请的KEY&page=1&pagesize=10 接口返
Paging3:基于mvvm架构的Android Paging 3 Jetpack库应用
04-14
分页3（进行中） 应用程序是基于MVVM架构的示例。 Android开发 完全用编写 使用作为图像加载库 使用进行依赖注入 API密钥 您需要为应用程序使用的各种服务提供API /客户端密钥： 要运行此示例，必须在local.properties中设置API密钥。 TBDB_API_KEY="enter your API key" 显示演示应用样本 执照 Copyright 2020 Google LLC WonTaek Woo <wwtgogogo> Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the L
带有下拉刷新功能的Listview控件
白雾霾
07-02 109
效果图如下 1.原理 其实就是继承了Listview控件，为其默认加一个header，这个header就是带箭头的那些东西。然后overrideonTouchEvent函数，根据滑动过程中y坐标的变化来动态修改header的状态（包括箭头的方向和文字提示），其他用法和普通的Listview一样。 public class PullToRefreshListView extends L...
Android Paging3分页+ConcatAdapter+空数据视图+下拉刷新(SwipeRefreshLayout)+加载更多+错误重试 (示例)
最新发布
打渔还是晒网 —— stone
06-10 4293
Paging3分页+ConcatAdapter+空数据视图+下拉刷新(SwipeRefreshLayout)+加载更多+错误重试 (示例)
基于 MVVM 模式的 RecyclerView。提供尽可能简洁的数据列表集成方式，并优化性能；提供友好的下拉刷新，上拉加载功能；提供加载时骨骼动画效果；提供 Item 滑动更多按钮
未来很长，但我会努力的走下去。
09-11 471
JRecyclerView 项目地址：jepack/JRecyclerView 简介： 基于 MVVM 模式的 RecyclerView。提供尽可能简洁的数据列表集成方式，并优化性能；提供友好的下拉刷新，上拉加载功能；提供加载时骨骼动画效果；提供 Item 滑动更多按钮 更多：作者提 Bug 标签： 基于 MVVM 模式的 RecyclerView。提供尽可能简洁的数...
【存储】基于列存之Parquet格式
Night_ZW的博客
09-08 1296
目录 概述 数据存储模式 一、行式存储模式 二、列式存储模式 三、行式存储于列式存储的区别 四、行列混合式存储模式 Parquet的含义 Parquet的数据模型 Parquet的数据类型 Parquet的存储格式 Striping/Assembly算法 一、Definition Level 二、Repetition Level 三、举例说明Striping和assembly的过程 投影下推（Project PushDown） 谓词下推（PredicatePushDown）.
【z-paging下拉刷新、上拉加载】示例demo
07-26
【配置简单】仅需两步（绑定网络请求方法、绑定分页结果数组）轻松完成完整下拉刷新，上拉加载更多功能。 【低耦合，低侵入】分页自动管理。在page中无需处理任何分页相关逻辑，无需在data中定义任何分页相关变量，...
玩 Android 客户端 MVVM 架构使用 Jetpack 架构组件
05-21
在Android开发领域，MVVM（Model-View-ViewModel）架构模式已经成为了现代应用设计的主流选择，尤其是在结合Google推出的Jetpack架构组件后，其优势更加明显。本项目名为"WanAndroid-MVVM"，显然是一个基于Android...
pc加载更多功能和移动端下拉刷新加载数据
09-01
在本文中，我们将深入探讨PC端的加载更多功能和移动端的下拉刷新加载数据这两种常见的网页数据分页加载策略。这两种方法在当前的Web开发中非常常见，它们旨在提高用户体验，减少页面加载时间，同时也降低了服务器的...
android scrollview 上拉下拉刷新
02-14
android中scrollview 的上拉下拉刷新控件demo。自定义控件，实现了对ScrollView上拉下拉操作的实现。该demo参考了http://blog.csdn.net/nono_love_lilith/article/details/7100845 ，感谢Nono_Love_Lilith的帮助
JRecyclerView,基于 MVVM 模式的 RecyclerView。提供尽可能简洁的数据列表集成方式，并优化性能；提供友好的下拉刷新，上拉加载功能；提供加载时骨骼动画效果；提供 Item 滑动更多按钮.zip
09-25
基于 MVVM 模式的 RecyclerView。提供尽可能简洁的数据列表集成方式，并优化性能；提供友好的下拉刷新，上拉加载功能；提供加载时骨骼动画效果；提供 Item 滑动更多按钮
下拉刷新(分页加载数据，包括服务端和客户端代码)
12-03
使用ListView控件显示从服务端获取的数据，采用下拉刷新，分页加载数据。 其中ListView中item的图片是固定设置进去的，没有从后台获取，这里就不写获取后台图片的代码了。只是主要演示下拉刷新，分页加载数据。包括服务端和客户端代码。
Android - - - Paging3
m0_47914176的博客
03-04 2629
Paging 库可帮助您加载和显示来自本地存储或网络中更大的数据集中的数据页面。此方法可让您的应用更高效地利用网络带宽和系统资源。Paging 库的组件旨在契合推荐的Android 应用架构，流畅集成其他Jetpack组件，并提供一流的 Kotlin 支持。 使用 Paging 库的优势 Paging 库包含以下功能： 分页数据的内存中缓存。该功能可确保您的应用在处理分页数据时高效利用系统资源。 内置的请求重复信息删除功能，可确保您的应用高效利用网络带宽和系统资源。 可配置的Rec...
Android——MVVM架构实现数据刷新
FranzLiszt的博客
10-27 1662
MVVM架构实现数据刷新效果图示例结构图代码解析导入dataBinding实体类显示图片实体类全部代码xml视图VM接收数据发送数据建立接口，回调数据制造数据绑定视图与数据层 效果图 示例结构图 代码解析 导入dataBinding dataBinding{ enabled = true } 实体类 继承BaseObservable public class Sensor extends BaseObservable 为字段添加@Bindable @Bin
给RecyclerView最纯粹的下拉刷新和上拉加载更多
热门推荐
JerryWu145的专栏
08-16 5万+
RecyclerView 出现以后，Android 里的下拉刷新和加载更多实现起来就非常容易了。当然，现成的库也有很多，只是总会有不一样的需求，而且我们往往只需要最基本的下拉刷新和加载更多功能，而不需要其他多余的功能。我只需要一个最纯粹的下拉刷新和加载更多。所以，自己动手显然是最好的结果了，也算是个小练习。总结起来，无非两点，一是用 SwipeRefreshLayout 包裹 RecyclerVi
mvvm 耗时加载进度条_快速无限滚动和图像加载中的mvvm
weixin_26735419的博客
09-25 397
mvvm 耗时加载进度条In this article, we’ll explore a complete reactive MVVM implementation based on the sample app that fetches photos from the Unsplash API and loads them in an asynchronous manner. 在本文中，我们将基...
【Android-Jetpack进阶】8、Paging 分页加载、MVVM 架构
呆呆的猫的博客
09-29 613
依赖于上一页最后一个对象的某个字段做 key。例如上一页最后一个对象的 key 是 9527，则请求下一页时携带 since=9527&pageSize=5的参数，通过 loadAfter() 加载下一页。移动端请求后端接口时，数据库的内容很多，不可能一次性请求完，所以需要分页加载， Jetpack 的 Paging 库，为分页提供了统一解决方案。用于从任意位置加载数据，加载固定数量，例如 start=2&count=5，通过 loadRange() 加载下一页。
Android Kotlin Paging3 Flow完整教程
丿灬安之若死
09-16 1037
这都是理想情况下 当如果是分页首次加载了 initialLoadSize 为默认3倍的时候要处理就往下面数。PagingDataAdapter 有自己的刷新代码。第二次 8个 对应下面 第二次 加载 上一页为 1 然后下一页为3 、paging3 的一次加载页数。第一次 加载8个 对应下面 首次加载为null 然后下一页为2。进行刷新 也是可行的。但是不知道会不会有什么潜在问题。由于第一次加载了三页数 所以再次加载不可以直接从2开始。系统的adapter指向一个上滑加载更多。
Android下拉刷新与 GridView 实战教程
本文将详细解析在Android平台上如何实现下拉刷新功能以及如何有效地使用GridView控件。下拉刷新是Android应用中常见的交互设计，通常用于更新列表或网格中的数据。GridView则是展示大量数据的一种多列布局方式，类似...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值