Android的Kotlin秘方（II）：RecyclerView 和 DiffUtil

作者：Antonio Leiva

时间：Sep 12, 2016

原文链接：http://antonioleiva.com/recyclerview-diffutil-kotlin/

如你所知，在【支持库24（the Support Library 24）】中包括一个新的、适用、方便的类：DiffUtil，这使你摆脱对单元改变和更新它们的无聊和易出错。

如果你还不了解它，可以阅读Nicola Despotoski的这篇好文章了解它。这篇文章解释怎样容易处理它。

实际上，Java语言引入许多模板，而我决定研究是用Kotlin怎样实现。

例子

我创建一个小APP（可以在GitHub下载）作为例子，它从一个有10项的列表中选择项目，用于下一次RecycerView。

这样，从一次迭代到下次，有些被显示，有些消失，而有时整个全部更新。

如果你知道RecyclerView是怎样工作的，你就知道在它的适配器怎样通知那些改变，这就需要这三个方法：

• notifyItemChanged
• notifyItemInserted
• notifyItemRemoved

以及它们对应的Range变化。

DiffUtil类将我们做所有的计算，且调用要求的notify方法。

原始实现方法

首次迭代，我们是从“提供者”那里获得这些项目，让适配器通知变化（这即使不是最好的代码，而可以很快的理解为什么这样做）：

 private fun fillAdapter() {
     val oldItems = adapter.items
     adapter.items = provider.generate()
     adapter.notifyChanges(oldItems, adapter.items)
 }

简单：我保存前面项目，产生新的项目，对适配器说notifyChanges，而用DiffUtil方法是这样：

 fun notifyChanges(old: List<Content>, new: List<Content>) {
     val diff = DiffUtil.calculateDiff(object : DiffUtil.Callback() {
         override fun areItemsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean {
             return old[oldItemPosition].id == new[newItemPosition].id
         }
 
         override fun areContentsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean {
             return old[oldItemPosition] == new[newItemPosition]
         }
 
         override fun getOldListSize() = old.size
 
         override fun getNewListSize() = new.size
     })
 
     diff.dispatchUpdatesTo(this)
 }

由于大部分代码都是基于模板，这实在是令人讨厌，但是稍后还是要返回了。

现在，如你所见在设置新的一组项目后我调用notifyChanges。那我们为什么不委托那些行为？

用委托使通知更简单

如果我们知道每次一组项目改变时进行通知，那么仅需要用Delegates.observer，那么代码就非常棒：

这个activity就非常简单了：

 private fun fillAdapter() {
     adapter.items = provider.generate()
 }

“观察者”看上去就非常不错：

 class ContentAdapter():RecyclerView.Adapter<ContentAdapter.ViewHolder>() {
 
     var items: List<Content> by Delegates.observable(emptyList()) {
         prop, old, new ->
                 notifyChanges(old, new)
     }
      ...
 }

太棒了！但是，这还可以更好。

用扩展函数提升适配器的能力

NotityChanges的大多数代码都是模式化的。如果用数据类，我们就需要实现判断两个项目是否相同的方法，即使它们的内容不同。

在这个例子中，识别的方法是id。

这样，我为这个适配器创建一个扩展函数，它将为我们做大部分困难的工作：

 fun <T> RecyclerView.Adapter<*>.autoNotify(old: List<T>, new: List<T>, compare: (T, T) -> Boolean) {
     val diff = DiffUtil.calculateDiff(object : DiffUtil.Callback() {
 
         override fun areItemsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean {
             return compare(old[oldItemPosition], new[newItemPosition])
         }
 
         override fun areContentsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean {
             return old[oldItemPosition] == new[newItemPosition]
         }
 
         override fun getOldListSize() = old.size
 
         override fun getNewListSize() = new.size
     })
 
     diff.dispatchUpdatesTo(this)
 }

这个函数接收两组项目，和另一个函数。这最后参数将在areItemsTheSame中使用，以确定两组项目是否相同。

现在调用是这样了：

 var items: List<Content> by Delegates.observable(emptyList()) {
     prop, old, new ->
             autoNotify(old, new) { o, n -> o.id == n.id }
 }

组合使用

我能理解你非常不喜欢前面的解决方案。而在特定情况下，你不要所有适配器都使用它。

但是，有一个替换方法：接口。

悲哀的是，在Kotlin预览上的某些位置上，接口不能扩展类（我非常希望在将来能够增加它）。这让你用扩展类的方法，强制类实现接口类型。

但是，我们将扩展函数移入接口内部，也能够获得类似的结果：

 interface AutoUpdatableAdapter {
 
     fun <T> RecyclerView.Adapter<*>.autoNotify(old: List<T>, new: List<T>, compare: (T, T) -> Boolean) {
         ...
     }
 }

适配器只需要实现这个接口：

 class ContentAdapter() : RecyclerView.Adapter<ContentAdapter.ViewHolder>(), AutoUpdatableAdapter {
     ....
 }

这就是所有代码，其它保持不变。

结论

有几个方法用DiffUtls使代码看起比Java更好、更简单。

如果你需要尝试其它解决方案，从代码库获取，并删除一些特殊注释。