前言
RecyclerView是我们常用的列表控件,一般来说当Item的数据改变的时候我们需要刷新当前的Item 。
如何刷新 RV 的列表?基本上有这几种方式:
notifyDataSetChanged()
notifyItemChanged(int position)
notifyItemChanged(int position, @Nullable Object payload)
一般来说一个 item 是由多个控件组成的,如 Button、CheckBox、TextView、ImageView、ViewGroup 等组合。当我们点击item的某个控件时,RV 需要重新计算布局、刷新视图来响应交互。假设一个 item 包含了N多个控件,如果调用notifyItemChanged(int position) 时,item 中的每个控件都需要重新布局显示,无形中加大了内存和性能的损耗。
就算我们不考虑内存和性能的问题,那么一些效果也是我们无法接受的,当 item 刷新的时候会导致内部的图片或item 出现一次闪烁。
以我的精神粮食起点为例,如下
所以我们才需要用到类似 Payload 与 Diff 之类的刷新方式。
下面我们就一起看看它们是怎么使用的。
一、Payload的刷新
我们通过 notifyItemChanged(int position, @Nullable Object payload)
来刷新指定索引的item。
在 RV 的 Adapter 中的 onBindViewHolder 可以接收到 payloads 参数,这个 payloads 参数是一个 List 对象,该对象不是 null 但可能是空的。
public void onBindViewHolder(VH holder, int position, List<Object> payloads) {
onBindViewHolder(holder, position);
}
复制代码
通过 Adapter 的 notifyXXX 函数的带有 payload 参数的函数可以设置 payload 对象,如:
public final void notifyItemChanged(int position, Object payload) {
mObservable.notifyItemRangeChanged(position, 1, payload);
}
复制代码
由于 onBindViewHolder 有重载的方法,如果使用了 payloads 的方式,那么我们需要做兼容,如果没有 payloads 就去走整个 item 的刷新,如果有 payloads 那么我们就根据指定的 payload 去刷新指定的数据。
@Override
public void onBindViewHolder(ViewHolder holder, int position, List<Object> payloads) {
if (!payloads.isEmpty() && payloads.get(0).equals("like")) {
//如果是我们指定的 payloads ,那么就可以指定刷新
TipsBean item = mData.get(position);
holder.tvLikeNum.setText(R.id.tv_tips_like_num, item.likes_count > 0 ? item.likes_count + "" : "Like");
holder.tvLikeNum.setTextColor(R.id.tv_tips_like_num, item.likes_count > 0 ? CommUtils.getColor(R.color.black) : CommUtils.getColor(R.color.home_item_text_light_gray));
} else {
// 如果没有 payloads ,或者不是我们指定的,还是返回默认的整个刷新
super.onBindViewHolder(holder, position);
}
}
复制代码
如果没有 payload ,当调用 notifyItemChanged 时,RV 会通过回调 onBindViewHolder(holder, position) 来更新当前数据变化的 item ,此时会触发 整个 item 中 view 的重新布局和计算位置,这样的话只要是其中一个 View 状态变化了,最终会导致整个 item 都需要重新布局一遍。
例如上述的例子,在评论的列表中,我只点赞了第一个 item ,我们就通过 payload 来告诉 RV 这个 item 中的 like 文本变化了,那么我们就只需要处理 Like 文本的变化。
二、Diff的刷新与快速实现方法
每一个 payloads 都要写一次,然后我们在调用 notifyItemChanged 时万一写错了怎么办?有没有一种方式能让程序自动管理,让程序帮我们记录 payloads ? 最好还能帮助我们自动排序!
有,我们先看看自动排序的方式:SortedList 的方式
SortedList,顾名思义就是排序列表,它适用于列表有序且不重复的场景。并且SortedList会帮助你比较数据的差异,定向刷新数据。而不是简单粗暴的notifyDataSetChanged()。
例如我们定义一个城市排序的对象:
public class City {
private int id;
private String cityName;
private String firstLetter;
...
}
复制代码
我们需要进行排序的规则定义
public class SortedListCallback extends SortedListAdapterCallback<City> {
public SortedListCallback(RecyclerView.Adapter adapter) {
super(adapter);
}
/**
* 排序条件
*/
@Override
public int compare(City o1, City o2) {
return o1.getFirstLetter().compareTo(o2.getFirstLetter());
}
/**
* 用来判断两个对象是否是相同的Item。
*/
@Override
public boolean areItemsTheSame(City item1, City item2) {
return item1.getId() == item2.getId();
}
/**
* 用来判断两个对象是否是内容的Item。
*/
@Override
public boolean areContentsTheSame(City oldItem, City newItem) {
if (oldItem.getId() != newItem.getId()) {
return false;
}
return oldItem.getCityName().equals(newItem.getCityName());
}
}
复制代码
再然后在Adapte中使用的时候,不需要Arrylist,要用排序的集合,新的对象SortedList排序集合。
public class SortedAdapter extends RecyclerView.Adapter<SortedAdapter.ViewHolder> {
// 数据源使用SortedList
private SortedList<City> mSortedList;
private LayoutInflater mInflater;
public SortedAdapter(Context mContext) {
mInflater = LayoutInflater.from(mContext);
}
public void setSortedList(SortedList<City> mSortedList) {
this.mSortedList = mSortedList;
}
/**
* 批量更新操作,例如:
* <pre>
* mSortedList.beginBatchedUpdates();
* try {
* mSortedList.add(item1)
* mSortedList.add(item2)
* mSortedList.remove(item3)
* ...
* } finally {
* mSortedList.endBatchedUpdates();
* }
* </pre>
*/
public void addData(List<City> mData) {
mSortedList.beginBatchedUpdates();
mSortedList.addAll(mData);
mSortedList.endBatchedUpdates();
}
/**
* 移除item
*/
public void removeData(int index) {
mSortedList.removeItemAt(index);
}
/**
* 清除集合
*/
public void clear() {
mSortedList.clear();
}
@Override
@NonNull
public SortedAdapter.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
return new ViewHolder(mInflater.inflate(R.layout.item_test, parent, false));
}
@Override
public void onBindViewHolder(@NonNull SortedAdapter.ViewHolder holder, final int position) {
// 。。。
}
@Override
public int getItemCount() {
return mSortedList.size();
}
public class ViewHolder extends RecyclerView.ViewHolder {
public ViewHolder(View itemView) {
super(itemView);
}
}
}
复制代码
使用的时候:
RecyclerView mRecyclerView = findViewById(R.id.rv);
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
mSortedAdapter = new SortedAdapter(this);
// SortedList初始化
SortedListCallback mSortedListCallback = new SortedListCallback(mSortedAdapter);
SortedList mSortedList = new SortedList<>(City.class, mSortedListCallback);
mSortedAdapter.setSortedList(mSortedList);
mRecyclerView.setAdapter(mSortedAdapter);
//添加数据
...
复制代码
这样确实就能实现自动排序,刷新列表了,相对 notifyDataSetChanged 的暴力刷新,优雅一点。但是它没有 payload 的功能,这个刷新只是刷新的是整个 RV 中的部分Item,但还是刷新整个 item 啊。
有没有办法既能排序又能 payload差异化刷新的方式呢?
肯定有哇, DiffUtil 的方式就此诞生,常用的相关的几个类为 DiffUtil
AsyncListDiffer
ListAdapter
(用于快速实现的封装类)
DiffUtil 能实现排序加payload局部刷新的功能:
- 当某个 item 的位置变化,触发排序逻辑,有移除和添加的动画。
- 当某个 item 的位置不变,内容变化,触发 payload 局部刷新。
- 在子线程中计算DiffResult,在主线程中刷新RecyclerView。
它是下面几个类的基础,所有的逻辑都是基于此封装和实现,是核心类。
核心类的核心方法是 DiffUtil.calculateDiff ,它在内部做一系列的计算和排序。
其中计算的算法为 Myers's difference ,有兴趣的可以查看它的实现原理与论文【传送门】
AsyncListDiffer 又是什么东西,为什么需要它。
其实 AsyncListDiffer 就是集成了 AsyncListUtil + DiffUtil 的功能,由于 DiffUtil在计算数据差异 DiffUtil.calculateDiff(mDiffCallback)
是一个耗时操作,需要我们放到子线程去处理,最后在主线程刷新,为了我们开发者更加的方便,谷歌直接提供了 AsyncListDiffer 方便我们直接使用。看来谷歌是怕我们开发者不会使用子线程,直接给我们写好了。
ListAdapter 又是个什么鬼?怎么越来越复杂了?
其实谷歌就喜欢把简单的东西复杂化,如果我们使用 AsyncListDiffer 去实现的话,虽然不用我们操心子线程了,但是还是需要我们定义对象、集合、添加数据的方法 ,如addNewData
,里面调用 mDiffer.submitList()
才能实现。
谷歌还是怕我们不会用吧!直接把 AsyncListDiffer 的使用都给简化了,直接提供了 ListAdapter 包装类,内部对 AsyncListDiffer 的使用做了一系列的封装,使用的时候我们的 RV-Adapter 直接继承 ListAdapter 即可实现 AsyncListDiffer 的功能,内部连设置数据的方法都给我们提供好了。谷歌真的是我们的好爸爸!为我们开发者操碎了心。
那它们都到底怎么使用呢?
不管什么方式,我们都需要定义好自己的 DiffUtil.CallBack,毕竟就算让程序帮我们排序和差分,我们也得告诉程序排序的规则和diff的规则,是吧!
public class MyDiffUtilItemCallback extends DiffUtil.ItemCallback<TestBean> {
/**
* 是否是同一个对象
*/
@Override
public boolean areItemsTheSame(@NonNull TestBean oldItem, @NonNull TestBean newItem) {
return oldItem.getId() == newItem.getId();
}
/**
* 是否是相同内容
*/
@Override
public boolean areContentsTheSame(@NonNull TestBean oldItem, @NonNull TestBean newItem) {
return oldItem.getName().equals(newItem.getName());
}
/**
* areItemsTheSame()返回true而areContentsTheSame()返回false时调用,也就是说两个对象代表的数据是一条,
* 但是内容更新了。此方法为定向刷新使用,可选。
*/
@Nullable
@Override
public Object getChangePayload(@NonNull TestBean oldItem, @NonNull TestBean newItem) {
Bundle payload = new Bundle();
if (!oldItem.getName().equals(newItem.getName())) {
payload.putString("KEY_NAME", newItem.getName());
}
if (payload.size() == 0){
//如果没有变化 就传空
return null;
}
return payload;
}
}
复制代码
那个Diff的具体实现我们选用哪一种方案呢?其实三种方式都是可以实现的,这里我们先使用 AsyncListDiffer 的方式来实现。
上面关于 AsyncListDiffer 的介绍我们说过了,虽然不需要我们实现异步操作了,但是我们还是需要实现对象、集合、添加数据的方法等。
示例如下:
public class AsyncListDifferAdapter extends RecyclerView.Adapter<AsyncListDifferAdapter.ViewHolder> {
private LayoutInflater mInflater;
// 数据的操作由AsyncListDiffer实现
private AsyncListDiffer<TestBean> mDiffer;
public AsyncListDifferAdapter(Context mContext) {
// 初始化AsyncListDiffe
mDiffer = new AsyncListDiffer<>(this, new MyDiffUtilItemCallback());
mInflater = LayoutInflater.from(mContext);
}
//添加数据传对象和对象集合都可以
public void addData(TestBean mData){
List<TestBean> mList = new ArrayList<>();
mList.addAll(mDiffer.getCurrentList());
mList.add(mData);
mDiffer.submitList(mList);
}
public void addData(List<TestBean> mData){
// 由于DiffUtil是对比新旧数据,所以需要创建新的集合来存放新数据。
// 实际情况下,每次都是重新获取的新数据,所以无需这步。
List<TestBean> mList = new ArrayList<>();
mList.addAll(mData);
mDiffer.submitList(mList);
}
//删除数据,要先获取全部集合,再删除指定的集合,再提交删除之后的集合
public void removeData(int index){
List<TestBean> mList = new ArrayList<>();
mList.addAll(mDiffer.getCurrentList());
mList.remove(index);
mDiffer.submitList(mList);
}
public void clear(){
mDiffer.submitList(null);
}
@Override
@NonNull
public AsyncListDifferAdapter.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
return new ViewHolder(mInflater.inflate(R.layout.item_test, parent, false));
}
@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position, @NonNull List<Object> payloads) {
if (payloads.isEmpty()) {
onBindViewHolder(holder, position);
} else {
Bundle bundle = (Bundle) payloads.get(0);
holder.mTvName.setText(bundle.getString("KEY_NAME"));
}
}
@Override
public void onBindViewHolder(@NonNull AsyncListDifferAdapter.ViewHolder holder, final int position) {
TestBean bean = mDiffer.getCurrentList().get(position);
holder.mTvName.setText(bean.getName());
}
@Override
public int getItemCount() {
return mDiffer.getCurrentList().size();
}
static class ViewHolder extends RecyclerView.ViewHolder {
......
}
}
复制代码
由于 Diff.Callback 我们已经在 Adapter 内部已经初始化了,所以使用的时候我们直接像普通的 RV 设置 Adapter 一样即可。
在更新数据的时候我们使用 Adapter 定义的 addData
和 removeData
即可完成Diff刷新。
使用 ListAdapter 会怎样?
如果觉得使用 AsyncListDiffer 都嫌弃麻烦的话,我们直接使用 ListAdapter 也能实现。
由于我们还是需要一个List集合去保存我们的数据,我们就能对 ListAdapter 再做一个简单的基类封装。
public abstract class BaseRVDifferAdapter<T, VH extends RecyclerView.ViewHolder> extends ListAdapter<T, VH> {
protected Context mContext;
protected LayoutInflater mInflater;
protected List<T> mDatas = new ArrayList<>();
public BaseRVDifferAdapter(Context context, DiffUtil.ItemCallback<T> callback) {
super(callback);
mContext = context;
mInflater = LayoutInflater.from(mContext);
}
//设置数据源
protected void setData(List<T> list) {
mDatas.clear();
mDatas.addAll(list);
List<T> mList = new ArrayList<>();
mList.addAll(mDatas);
submitList(mList);
}
//添加数据源
protected void addData(List<T> list) {
mDatas.addAll(list);
List<T> mList = new ArrayList<>();
mList.addAll(mDatas);
submitList(mList);
}
//删除制定索引数据源
protected void removeData(int index) {
mDatas.remove(index);
List<T> mList = new ArrayList<>();
mList.addAll(mDatas);
submitList(mList);
}
//清除全部数据
protected void clear() {
mDatas.clear();
submitList(null);
}
//获取adapter维护的数据集合
protected List<T> getAdapterData() {
return mDatas;
}
}
复制代码
我们实现Adater的方法就如下:
public class MyListAdapter extends BaseRVDifferAdapter<TestBean, MyListAdapter.ViewHolder> {
public MyListAdapter(Context context) {
super(context, new MyDiffUtilItemCallback());
}
@Override
@NonNull
public MyListAdapter.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
return new ViewHolder(mInflater.inflate(R.layout.item_test, parent, false));
}
@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position, @NonNull List<Object> payloads) {
if (payloads.isEmpty()) {
onBindViewHolder(holder, position);
} else {
Bundle bundle = (Bundle) payloads.get(0);
holder.mTvName.setText(bundle.getString("KEY_NAME"));
}
}
@Override
public void onBindViewHolder(@NonNull MyListAdapter.ViewHolder holder, final int position) {
TestBean bean = getItem(position);
holder.mTvName.setText(bean.getName());
}
static class ViewHolder extends RecyclerView.ViewHolder {
TextView mTvName;
ViewHolder(View itemView) {
super(itemView);
mTvName = itemView.findViewById(R.id.tv_name);
}
}
}
复制代码
在我们自己的 Adpater 中,我们还是需要初始化我们自己的 Diff.Callback的。那么在使用的时候也就和普通的RV设置 Adapter 是一样的。
如下:
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_sorted_list);
RecyclerView mRecyclerView = findViewById(R.id.rv);
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
mAsyncListDifferAdapter = new AsyncListDifferAdapter(this);
mRecyclerView.setAdapter(mAsyncListDifferAdapter);
initData();
}
private void addData() {
List<TestBean> mList = new ArrayList();
for (int i = 10; i < 20; i++){
mList.add(new TestBean(i, "Item " + i));
}
mMyListAdapter.addData(mList);
}
private void initData() {
List<TestBean> mList = new ArrayList();
for (int i = 0; i < 10; i++){
mList.add(new TestBean(i, "Item " + i));
}
mMyListAdapter.setData(mList);
}
private void updateData() {
List<TestBean> mList = new ArrayList();
for (int i = 20; i < 30; i++){
mList.add(new TestBean(i, "Item " + i));
}
mMyListAdapter.addData(mList);
}
复制代码
是不是可以无脑使用Diff的方式呢?也不是,当一些普通长列表我们使用默认的RV-Adapter就行了,加载更多,往源数据上面加数据,并不涉及到很多数据源改变的也没必要使用Diff。
那么哪里使用?比如IM的会话列表,长期变动的数据,比如评论区域热评区的数据切换时,比如我们的Android掘金App:
直接暴力的切换数据源然后 notifyDataSetChanged ,这样就会整个页面闪烁。而对于这些特定的一些场景,我们使用 Diff 的功能,就会感觉更加的流畅,体验会好一点哦!
三、DiffUtil的封装
既然 AsyncListDiffer 和 ListAdapter 都是快速实现的方式,那我们直接使用基本 DiffUtil 行不行?
当然可以,我不想直接使用 ListAdapter ,我就想用 RV.Adapter ,因为我有其他的封装与扩展,我自己会使用异步线程,我不需要你帮我管理,我不需要使用你的 AsyncListDiffer 帮我管理我的 List 对象 。
我们可以直接使用基本的 DiffUtil 。真实使用下来也不是很复杂,只需要做一点点的封装也能很方便的实现逻辑。
先写一个Differ的配置文件,内部可配置主线程,异步线程,和必备的DiffUtil.Callback:
class MyAsyncDifferConfig <T>(
@SuppressLint("SupportAnnotationUsage")
@RestrictTo(RestrictTo.Scope.LIBRARY)
val mainThreadExecutor: Executor?,
val backgroundThreadExecutor: Executor,
val diffCallback: DiffUtil.ItemCallback<T>) {
class Builder<T>(private val mDiffCallback: DiffUtil.ItemCallback<T>) {
companion object {
private val sExecutorLock = Any()
private var sDiffExecutor: Executor? = null
}
private var mMainThreadExecutor: Executor? = null
private var mBackgroundThreadExecutor: Executor? = null
fun setMainThreadExecutor(executor: Executor?): Builder<T> {
mMainThreadExecutor = executor
return this
}
fun setBackgroundThreadExecutor(executor: Executor?): Builder<T> {
mBackgroundThreadExecutor = executor
return this
}
fun build(): MyAsyncDifferConfig<T> {
if (mBackgroundThreadExecutor == null) {
synchronized(sExecutorLock) {
if (sDiffExecutor == null) {
sDiffExecutor = Executors.newSingleThreadExecutor()
}
}
mBackgroundThreadExecutor = sDiffExecutor
}
return MyAsyncDifferConfig(
mMainThreadExecutor,
mBackgroundThreadExecutor!!,
mDiffCallback)
}
}
}
复制代码
重点是定义一个自己的AsyncDiffer,内部使用 DiffUtil 来计算差分。
class MyAsyncDiffer<T>(
private val adapter: RecyclerView.Adapter<*>,
private val config: MyAsyncDifferConfig<T>
) {
private val mUpdateCallback: ListUpdateCallback = AdapterListUpdateCallback(adapter)
private var mMainThreadExecutor: Executor = config.mainThreadExecutor ?: MainThreadExecutor()
private val mListeners: MutableList<ListChangeListener<T>> = CopyOnWriteArrayList()
private var mMaxScheduledGeneration = 0
private var mList: List<T>? = null
private var mReadOnlyList = emptyList<T>()
private class MainThreadExecutor internal constructor() : Executor {
val mHandler = Handler(Looper.getMainLooper())
override fun execute(command: Runnable) {
mHandler.post(command)
}
}
fun getCurrentList(): List<T> {
return mReadOnlyList
}
@JvmOverloads
fun submitList(newList: MutableList<T>?, commitCallback: Runnable? = null) {
val runGeneration: Int = ++mMaxScheduledGeneration
if (newList == mList) {
commitCallback?.run()
return
}
val previousList = mReadOnlyList
if (newList == null) {
val countRemoved = mList?.size ?: 0
mList = null
mReadOnlyList = emptyList()
mUpdateCallback.onRemoved(0, countRemoved)
onCurrentListChanged(previousList, commitCallback)
return
}
if (mList == null) {
mList = newList
mReadOnlyList = Collections.unmodifiableList(newList)
mUpdateCallback.onInserted(0, newList.size)
onCurrentListChanged(previousList, commitCallback)
return
}
val oldList: List<T> = mList as List<T>
config.backgroundThreadExecutor.execute {
val result = DiffUtil.calculateDiff(object : DiffUtil.Callback() {
override fun getOldListSize(): Int {
return oldList.size
}
override fun getNewListSize(): Int {
return newList.size
}
override fun areItemsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean {
val oldItem: T? = oldList[oldItemPosition]
val newItem: T? = newList[newItemPosition]
return if (oldItem != null && newItem != null) {
config.diffCallback.areItemsTheSame(oldItem, newItem)
} else oldItem == null && newItem == null
}
override fun areContentsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean {
val oldItem: T? = oldList[oldItemPosition]
val newItem: T? = newList[newItemPosition]
if (oldItem != null && newItem != null) {
return config.diffCallback.areContentsTheSame(oldItem, newItem)
}
if (oldItem == null && newItem == null) {
return true
}
throw AssertionError()
}
override fun getChangePayload(oldItemPosition: Int, newItemPosition: Int): Any? {
val oldItem: T? = oldList[oldItemPosition]
val newItem: T? = newList[newItemPosition]
if (oldItem != null && newItem != null) {
return config.diffCallback.getChangePayload(oldItem, newItem)
}
throw AssertionError()
}
})
mMainThreadExecutor.execute {
if (mMaxScheduledGeneration == runGeneration) {
latchList(newList, result, commitCallback)
}
}
}
}
private fun latchList(
newList: MutableList<T>,
diffResult: DiffUtil.DiffResult,
commitCallback: Runnable?
) {
val previousList = mReadOnlyList
mList = newList
mReadOnlyList = Collections.unmodifiableList(newList)
diffResult.dispatchUpdatesTo(mUpdateCallback)
onCurrentListChanged(previousList, commitCallback)
}
private fun onCurrentListChanged(
previousList: List<T>,
commitCallback: Runnable?
) {
for (listener in mListeners) {
listener.onCurrentListChanged(previousList, mReadOnlyList)
}
commitCallback?.run()
}
//定义接口
interface ListChangeListener<T> {
fun onCurrentListChanged(previousList: List<T>, currentList: List<T>)
}
fun addListListener(listener: ListChangeListener<T>) {
mListeners.add(listener)
}
fun removeListListener(listener: ListChangeListener<T>) {
mListeners.remove(listener)
}
fun clearAllListListener() {
mListeners.clear()
}
}
复制代码
然后我们可以用委托的方式配置,可以让普通的 RecyclerView.Adapter 也能通过配置的方式选择是否使用Differ。
实现我们的控制类接口
//设置别名简化
typealias IDiffer<T> = IMyDifferController<T>
fun <T> differ(): MyDifferController<T> = MyDifferController()
interface IMyDifferController<T> {
fun RecyclerView.Adapter<*>.initDiffer(config: MyAsyncDifferConfig<T>): MyAsyncDiffer<T>
fun getDiffer(): MyAsyncDiffer<T>?
fun getCurrentList(): List<T>
fun setDiffNewData(list: MutableList<T>, commitCallback: Runnable? = null)
fun addDiffNewData(list: MutableList<T>, commitCallback: Runnable? = null)
fun addDiffNewData(t: T, commitCallback: Runnable? = null)
fun removeDiffData(index: Int)
fun clearDiffData()
fun RecyclerView.Adapter<*>.onCurrentListChanged(previousList: List<T>, currentList: List<T>)
}
复制代码
在对控制类接口实例化,做一些具体的操作逻辑
class MyDifferController<T> : IMyDifferController<T> {
private var mDiffer: MyAsyncDiffer<T>? = null
override fun RecyclerView.Adapter<*>.initDiffer(config: MyAsyncDifferConfig<T>): MyAsyncDiffer<T> {
mDiffer = MyAsyncDiffer(this, config)
val mListener: MyAsyncDiffer.ListChangeListener<T> = object : MyAsyncDiffer.ListChangeListener<T> {
override fun onCurrentListChanged(previousList: List<T>, currentList: List<T>) {
this@initDiffer.onCurrentListChanged(previousList, currentList)
}
}
mDiffer?.addListListener(mListener)
return mDiffer!!
}
override fun getDiffer(): MyAsyncDiffer<T>? {
return mDiffer
}
override fun getCurrentList(): List<T> {
return mDiffer?.getCurrentList() ?: emptyList()
}
override fun setDiffNewData(list: MutableList<T>, commitCallback: Runnable?) {
mDiffer?.submitList(list, commitCallback)
}
override fun addDiffNewData(list: MutableList<T>, commitCallback: Runnable?) {
val newList = mutableListOf<T>()
newList.addAll(mDiffer?.getCurrentList() ?: emptyList())
newList.addAll(list)
mDiffer?.submitList(newList, commitCallback)
}
override fun addDiffNewData(t: T, commitCallback: Runnable?) {
val newList = mutableListOf<T>()
newList.addAll(mDiffer?.getCurrentList() ?: emptyList())
newList.add(t)
mDiffer?.submitList(newList, commitCallback)
}
override fun removeDiffData(index: Int) {
val newList = mutableListOf<T>()
newList.addAll(mDiffer?.getCurrentList() ?: emptyList())
newList.removeAt(index)
mDiffer?.submitList(newList)
}
override fun clearDiffData() {
mDiffer?.submitList(null)
}
override fun RecyclerView.Adapter<*>.onCurrentListChanged(previousList: List<T>, currentList: List<T>) {
}
}
复制代码
到此我们就能封装一个DiffUtil的工具类了,我们可以选择是否启用Diff,例如我们不使用Diff,我们使用Adapter就是一个普通的Adaper
class MyDiffAdapter() : RecyclerView.Adapter<BaseViewHolder>() {
private val mDatas = arrayListOf<DemoDiffBean>()
fun addData(list :List<DemoDiffBean>) {
mDatas.addAll(list)
notifyDataSetChanged()
}
override fun onBindViewHolder(holder: BaseViewHolder, position: Int, payloads: MutableList<Any>) {
if (!CheckUtil.isEmpty(payloads) && (payloads[0] as String) == "text") {
YYLogUtils.w("差分刷新 -------- 文本更新")
holder.setText(R.id.tv_job_text, mDatas[position].content)
} else {
onBindViewHolder(holder, position)
}
}
override fun onBindViewHolder(holder: BaseViewHolder, position: Int) {
YYLogUtils.w("默认数据赋值 --------")
holder.setText(R.id.tv_job_text, mDatas[position].content)
}
override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): BaseViewHolder {
return BaseViewHolder(LayoutInflater.from(parent.context).inflate(R.layout.item_diff_jobs, parent, false))
}
override fun getItemCount(): Int {
return mDatas.size
}
}
复制代码
如果我们想启动Diff的功能的时候,实现这个接口并委托实现即可启用Diff。
class MyDiffAdapter() : RecyclerView.Adapter<BaseViewHolder>(), IDiffer<DemoDiffBean> by differ() {
init {
initDiffer(MyAsyncDifferConfig.Builder(DiffDemoCallback()).build())
}
override fun onBindViewHolder(holder: BaseViewHolder, position: Int, payloads: MutableList<Any>) {
if (!CheckUtil.isEmpty(payloads) && (payloads[0] as String) == "text") {
YYLogUtils.w("差分刷新 -------- 文本更新")
holder.setText(R.id.tv_job_text, getCurrentList()[position].content)
} else {
onBindViewHolder(holder, position)
}
}
override fun onBindViewHolder(holder: BaseViewHolder, position: Int) {
YYLogUtils.w("默认数据赋值 --------")
holder.setText(R.id.tv_job_text, getCurrentList()[position].content)
}
override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): BaseViewHolder {
return BaseViewHolder(LayoutInflater.from(parent.context).inflate(R.layout.item_diff_jobs, parent, false))
}
override fun getItemCount(): Int {
return getCurrentList().size
}
}
复制代码
使用的时候也是超方便的
private fun initRV() {
mAdapter = MyDiffAdapter()
findViewById<RecyclerView>(R.id.recyclerView).vertical().apply {
adapter = mAdapter
divider(Color.BLACK)
}
}
private fun initData() {
mDatas.clear()
for (i in 1..10) {
mDatas.add(DemoDiffBean(i, "conetnt:$i"))
}
mAdapter.setDiffNewData(mDatas)
}
private fun initListener() {
findViewById<View>(R.id.diff_1).click {
val list = mutableListOf<DemoDiffBean>()
for (i in 1..10) {
list.add(DemoDiffBean(i, "Diff1 conetnt:$i"))
}
mAdapter.setDiffNewData(list)
}
findViewById<View>(R.id.diff_2).click {
val list = mutableListOf<DemoDiffBean>()
for (i in 1..10) {
list.add(DemoDiffBean(i, "Diff3 conetnt:$i"))
}
list.removeAt(0)
list.removeAt(1)
list.removeAt(2)
list[3].content = "自定义乱改的数据"
mAdapter.setDiffNewData(list)
}
}
复制代码
运行的效果如下:
是不是很方便呢?可能有人会问,这么封装有什么好处?
其实这样通过配置的方式,我们可以使用在任意的RV.Adapter上面,包括我们自己定义的BaseAdapter,LoadMoreAdapter等。相对比较灵活吧,方便在原有的效果上快速修改。
当然了,其实关于 Diff 的实现,有这么多种方式可以让大家使用,每一种方案都能实现同样的效果,只是看大家愿不愿意优化而已,每一种方式使用起来都不算难。
小结
关于 paylpoad 和 Diff 的问题,既然 Diff 是在 payload 的基础上实现的,那是不是有 Diff 功能之后我们就不需要手动 payload 了呢?
也不是,上面的介绍中已经讲过了,如果数据频繁的切换,最好是使用Diff,如果就是类似普通的评论列表点赞的效果,我们手动 payload 即可。他们有各自的使用场景。
需要注意的是,如果使用 Diff 要留意对象指针的问题,DiffUtil 首先检查新提交的 newList 与内部持有的 mList 的引用是否相同, 如果相同, 就直接返回。如果不同的引用,才会对 newList 和 mList 做 Diff 算法比较。
可以看的我的 Demo 都是直接另 new 一个 List 来进行操作的,正常开发场景一般我们都是从服务器拿的不同的 List,也不会有问题。而如果从本地拿的数据去比对的时候就需要注意,对比的对象和原有的对象是否是同一个对象,此时可以考虑对象的深拷贝来实现新对象,再拿去和原有对象进行差分对比,关于浅拷贝与深拷贝的对比和如何深拷贝,可以看我之前的文章【传送门】。
好了,本文的全部代码与Demo都已经开源。有兴趣可以看这里。项目会持续更新,大家可以关注一下。
如果感觉本文对你有一点点的启发,还望你能点赞
支持一下,你的支持是我最大的动力。
Ok,这一期就此完结。
作者:newki
链接:https://juejin.cn/post/7156512023973462053
来源:稀土掘金
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。