优雅地刷新RecyclerView

心如止水 / 文 发表于2017-05-22 10:00 次阅读 android,recyclerview

前言

还是那句话,RecyclerView的viewType增多,逻辑变复杂,几个月后,你确定还能理清思路吗?假设我们服务端是多个接口返回数据,你确定能正确刷新相应type吗?想一个RecyclerView高效快捷管理整个界面吗?你还在使用notifyDataSetChanged无脑刷新吗?你想单个viewType在loadingView,dataView,errorView自如切换吗?如果你迟疑了,那你不妨试试本库。

特点

  • 与Adapter为组合关系,可配合大多数Adapter
  • 一行代码刷新相应viewType
  • 支持facebook的shimmer加载效果
  • 支持粘性头
  • 支持异步刷新,可扩展(如配合RxAndroid)
  • 支持加载相应type错误页面
  • 支持高频率刷新(流畅,异步执行)

效果

线性排布

方格排布

关键字高亮

刷新错误页面

高频率刷新

更新内容

  • 支持刷新type错误页面(可自定义)
  • 支持同时刷新多个type(异步,高频率)
  • 链式注册资源
  • 支持刷新单个数据
  • 提供helper的清除单个type,清除整个界面api
  • 提供getHeaderId的默认实现抽象类

支持刷新type错误页面(可自定义)

public void notifyMoudleErrorChanged(ErrorEntity errorData, int type);

public void notifyMoudleErrorChanged(int type);

一行代码搞定,前者提供实体类是考虑有些用户需要根据实体数据属性去更新,因此错误页面的layoutId是用户提供的。

支持同时刷新多个type(异步,高频率)

 //刷新队列,支持高频率刷新
private Queue<HandleBase<T>> mRefreshQueue;

这里采用的是队列的形式管理刷新,提供清空队列的Api。

链式注册资源

registerMoudle(@IntRange(from = 0, to = 999) int type)
                .level(@IntRange(from = 0) int level)
                .layoutResId(@LayoutRes int layoutResId)
                .headerResId(@LayoutRes int headerResId)
                .loading()
                .loadingLayoutResId(@LayoutRes int loadingLayoutResId)
                .loadingHeaderResId(@LayoutRes int loadingHeaderResId)
                .error()
                .errorLayoutResId(@LayoutRes int errorLayoutResId)
                .register();

由于参数越来越多,这里采用了较为流行的链式注册,内部通过ResourcesManager管理所有资源。

注:原来的注册方式已设置为过时,请及时更新,不出2个版本将移除。

支持刷新单个数据

public void notifyMoudleDataAndHeaderChanged(T data, T header, int type)

可能某个type只有一个实体数据管理着整个type

public void notifyMoudleDataAndHeaderChanged(List<? extends T> data, T header, int type)

可传T的子类集合

提供helper的清除单个type,清除整个界面api

/**
 * 清除单个type数据
 *
 * @param type 数据类型
 */
public void clearMoudle(int type);

/**
 * 清除所有数据
 */
public void clear();

提供getHeaderId的默认实现抽象类

假设你不实现粘性头而强制要写getHeaderId确实挺讨厌的,由于现在android还不是很好地兼容java8,因此暂时提供DefaultMultiHeaderEntity。

使用注意点

type 取值范围

  • 数据类型 [0,1000)
  • 头类型 [-1000,0)
  • shimmer数据类型 [-2000,-1000)
  • shimmer头类型 [-3000,-2000)
  • error类型 [-4000,-3000)

常量差值

//头类型差值
public static final int HEADER_TYPE_DIFFER = 1000;
//shimmer数据类型差值
public static final int SHIMMER_DATA_TYPE_DIFFER = 2000;
//shimmer头类型差值
public static final int SHIMMER_HEADER_TYPE_DIFFER = 3000;
//错误类型差值
public static final int ERROR_TYPE_DIFFER = 4000;

结束

库多多少少也更新几个版本了,你的意见,你的建议,你的star,你的分享,一直是我前进的动力。还有一点要说的就是现在关于LayoutManager,RecyclerView,Adapter的流派很多,我们更关注于数据的优雅刷新。

如果对本库还不是很了解的同学可以到我的github查看更多版本进行了解。

gradle依赖

compile 'com.crazysunj:multitypeadapter:1.3.0'

传送门

Github:https://github.com/crazysunj/MultiTypeRecyclerViewAdapter

博客:http://crazysunj.com/

谷歌邮箱:twsunj@gmail.com

QQ邮箱:387953660@qq.com

收藏 赞 (3) 踩 (3)