Paging是google官方推出的一个Android分页加载库,配合RecyclerView可以很方便实现RecyelerView的Footer和Header。可以使用在Java或Kotlin项目中,借助PagingDataAdapter帮助RecyclerView实现分页加载。
创新互联专业为企业提供柯城网站建设、柯城做网站、柯城网站设计、柯城网站制作等企业网站建设、网页设计与制作、柯城企业网站模板建站服务,10余年柯城做网站经验,不只是建网站,更提供有价值的思路和整体网络服务。
Paging中最重要的两个类是 PagingSource , LoadState 和 PagingDataAdapter :
Jetpack Compose 提供了Flutter类似的功能API,非常方便,简单举个例子:
本文主要介绍JetCompose 项目中 Paging3分页的使用,下拉刷新上拉加载动效。效果如下:
构建错误:是com.google.accompanist:accompanist:xxx 相关库的版本不兼容,需要依赖相同的版本
最近在使用Android官方提供的paging组件进行分页功能的时候,遇到了一个问题。首先,paging每次显示一页的数据,下滑到一定程度以后发送第二次取数据的api,以此达到分页的效果。
当我们第一次显示成功以后,断开网络,然后划到底部。这个时候,发送API失败了。重新链接以后,再往下滑动,也不会有任何反应。这显然跟我们实际体验是有区别的。下面说一下具体的方法。
具体例子可以参考谷歌github上 例子
这里贴一个关于描述paging使用的文章,我觉得非常好,可以看一下,我这里不详细说了。
主要分三个部分
DataSource
PageList
PageListAdapter
其中,DataSource是负责处理分页。
核心是 三个方法
paging在向下滑动的过程中,到达指定的位置以后,会执行loadAfter,来获取下一页的数据。但是这个处理只会执行一次,这就是为什么断网以后,重连以后,再滑动也不会有反应了。
通过上面的分析的原因,我们知道了原因是获取下一页的数据只会执行一次,那么我们对应的方法也就很好理解了,我们在需要的时候,再执行一次loadAfter就可以达到我们需要的效果了。
我这边,是在recyclerview滑动到最底部的时候,重新执行loadAfter
DataSource
重新执行的方法
核心部分在retry。当我们发送API失败以后,retry保存当前失败的API处理操作。我们在需要的时候,去调用 retryAllFailed() 方法,重新执行这次的API
顺便一说,这里用到的是携程发送API,如果在retry的过程中,不用 GlobalScope.launch 的话,可能会阻塞主线程,导致卡顿。
ListView分页:
(一)、目的:
Android 应用开发中,采用ListView组件来展示数据是很常用的功能,当一个应用要展现很多的数据时,一般情况下都不会把所有的数据一次就展示出来,而是通过 分页的形式来展示数据,这样会有更好的用户体验。因此,很多应用都是采用分批次加载的形式来获取用户所需的数据。例如:微博客户端可能会在用户滑 动至列表底端时自动加载下一页数据,也可能在底部放置一个"查看更多"按钮,用户点击后,加载下一页数据。
(二)、核心技术点:
借助 ListView组件的OnScrollListener监听事件,去判断何时该加载新数据;
往服务器get传递表示页码的参数:page。而该page会每加载一屏数据后自动加一;
利用addAll()方法不断往list集合末端添加新数据,使得适配器的数据源每新加载一屏数据就发生变化;
利用适配器对象的notifyDataSetChanged()方法。该方法的作用是通知适配器自己及与该数据有关的view,数据已经发生变动,要刷新自己、更新数据。
(三)、 OnScrollListener监听事件 :
1、该监听器中有两个需要实现的方法:
onScrollStateChanged(AbsListView view, int scrollState):监听屏幕的滚动状态的变动情况
onScroll(AbsListView view, int firstVisibleItem,int visibleItemCount, int totalItemCount):监听屏幕滚动的item的数量
2、 scrollState 回调顺序如下:
第1次:scrollState = SCROLL_STATE_TOUCH_SCROLL(1):表示正在滚动。当屏幕滚动且用户使用的触碰或手指还在屏幕上时为1
第2次:scrollState =SCROLL_STATE_FLING(2) :表示手指做了抛的动作(手指离开屏幕前,用力滑了一下,屏幕产生惯性滑动)。
第3次:scrollState =SCROLL_STATE_IDLE(0) :表示屏幕已停止。屏幕停止滚动时为0。
3、 onScroll中参数讲解:
firstVisibleItem:当前窗口中能看见的第一个列表项ID(从0开始)
visibleItemCount:当前窗口中能看见的列表项的个数(小半个也算)
totalItemCount:列表项的总数
4、思路:
当滚到最后一条,加载新数据;
适配器的数据源要进行累加:totalList.addAll(list);
数据发生变化,适配器通知:adapter.notifyDataSetChanged();【牢记】
判断是否滚到最后一行。
(五)、核心代码:
1、布局文件的核心代码:
RelativeLayoutxmlns:android=""
android:layout_width="fill_parent"
android:layout_height="fill_parent"
ListView
android:id="@+id/listView_main"
android:layout_below="@+id/button_main_init"
android:layout_width="match_parent"
android:layout_height="match_parent"
/ListView
LinearLayout
android:id="@+id/layout_main_nextpage"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:background="#000"
android:visibility="invisible"
android:gravity="center"
android:onClick="clickButton"
android:padding="5dp"
ProgressBar
android:id="@+id/progressBar_main"
style="?android:attr/progressBarStyleSmall"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/
TextView
android:id="@+id/text_main_nextpage"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="10dp"
android:textSize="18sp"
android:onClick="clickButton"
android:textColor="#fff"
android:text="点击加载更多数据"/
/LinearLayout
/RelativeLayout
2、Activity页面核心代码:
publicclass MainActivity extends Activity {
privateStringTAG= "MainActivity";
privateListView listView_main;
privateLinearLayout layout_main_nextpage;
private MySQLiteDatabaseHelper dbHelper = null;
// 用于分页显示数据的属性
privateintpageSize= 30;// 每页显示的条数
privateintcurPage= 1;
privateintrowCount= 0;
privateintpageCount= 0;// 总页数
privatebooleanisBottom=false;// 判断是否滚动到数据最后一条
private ListMapString, Object totalList = null;// 加载到适配器中的数据源
private SimpleAdapter adapter = null;
@Override
protectedvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
listView_main = (ListView) findViewById(R.id.listView_main);
layout_main_nextpage = (LinearLayout) findViewById(R.id.layout_main_nextpage);
// 实例化访问数据库帮助类
dbHelper = new MySQLiteDatabaseHelper();
// 获取数据表一共有多少条,从而计算共有多少页
rowCount=dbHelper.selectCount("select id from android_basic",null);
// 计算总页码数
pageCount = (int) Math.ceil(rowCount / (float) pageSize);
// 如果当前页为第一页,则数据源集合中就是第一页的内容
if (curPage == 1) {
totalList = getCurpageList(1);
}
adapter = new SimpleAdapter(this, totalList,
R.layout.item_listview_main, new String[] { "_id", "title" },
newint[] { R.id.text_item_listview_id,
R.id.text_item_listview_title});
listView_main.setAdapter(adapter);
// 给ListView对象设置滚动监听器,以此来判断是否已经滚动到最后一条,从而决定是否加载新数据
listView_main.setOnScrollListener(new OnScrollListener() {
@Override
publicvoid onScrollStateChanged(AbsListView view, int scrollState) {
if (isBottom) {
// 如果滚到最后一条数据(即:屏幕最底端),则显示:“加载更多新数据”
if(curPage pageCount) {
layout_main_nextpage.setVisibility(View.VISIBLE);
}
} else {
layout_main_nextpage.setVisibility(View.GONE);
}
}
@Override
publicvoid onScroll(AbsListView view, int firstVisibleItem,
int visibleItemCount, int totalItemCount) {
// Log.i(TAG, "==" + firstVisibleItem + ":::" + visibleItemCount
// + ":::" + totalItemCount);
// 判断是否已经滚动到了最后一条,从而决定是否提示加载新数据
isBottom = (firstVisibleItem + visibleItemCount == totalItemCount);
}
});
}
publicvoid clickButton(View view) {
switch (view.getId()) {
caseR.id.layout_main_nextpage:
// Log.i(TAG, "==" + curPage + ":::" + pageCount);
// 如果不是最后一页,则让当前页码累加,让数据源累加新数据,并通知适配器信息发生变化
if(curPage pageCount) {
curPage++;
totalList.addAll(getCurpageList(curPage));
adapter.notifyDataSetChanged();
}
// 只要点击了提示“加载新数据”的信息,就让其隐藏
layout_main_nextpage.setVisibility(View.GONE);
break;
default:
break;
}
}
// 获取每一页的数据,返回List集合
private ListMapString, Object getCurpageList(int currentPage) {
int offset = (currentPage - 1) * pageSize;
String sql = "select id _id ,title from android_basic limit ? , ?";
returndbHelper.selectData(sql, new String[] { offset + "",
pageSize + "" });
}
}