Android 控件 - ListAdapter

ListAdapter

1、基本介绍

ListAdapter<T, VH extends RecyclerView.ViewHolder> 有两个泛型参数，T是列表数据类型，VH是 ViewHolder 类型
ListAdapter 还要求实现 DiffUtil.ItemCallback，定义如何比较两个对象

2、演示

（1）Entity

kotlin 复制代码

data class User(
    val id: Long,
    val name: String,
    val age: Int
)

（2）DiffUtil Callback

kotlin 复制代码

data class User(
    val id: Long,
    val name: String,
    val age: Int
)

（3）Adapter

kotlin 复制代码

class UserAdapter : ListAdapter<User, UserAdapter.UserViewHolder>(UserDiff) {

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): UserViewHolder {
        val view = LayoutInflater.from(parent.context)
            .inflate(R.layout.item_user, parent, false)
        return UserViewHolder(view)
    }

    override fun onBindViewHolder(holder: UserViewHolder, position: Int) {
        holder.bind(getItem(position))
    }

    class UserViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        private val nameText: TextView = itemView.findViewById(R.id.nameText)
        private val ageText: TextView = itemView.findViewById(R.id.ageText)

        fun bind(user: User) {
            nameText.text = user.name
            ageText.text = user.age.toString()
        }
    }
}

3、submitList 方法

kotlin 复制代码

public void submitList(@Nullable List<T> list) {
    mDiffer.submitList(list);
}

当调用 submitList 方法时，ListAdapter 会利用内部的 AsyncListDiffer 在后台线程比较新旧列表的差异
随后，这些差异会被转换成具体的 notifyItem 事件，在主线程上分派，从而触发 RecyclerView 的局部刷新与动画效果
应始终提交一个新的列表对象，而不是修改并重新提交同一个列表实例，否则，ListAdapter 内部的引用检查会认为列表未变，从而跳过差异计算和更新

4、DiffUtil Callback 举例说明

同一个用户，改名

kotlin 复制代码

old = User(1, "张三", 20)
new = User(1, "李四", 20)

复制代码

areItemsTheSame → 1 == 1 → true（同一个人）

areContentsTheSame → old == new → false（内容不同）

结果：触发该 item 重新绑定，更新显示的名字。不产生增删动画

同一个用户，没有变化

kotlin 复制代码

old = User(1, "张三", 20)
new = User(1, "张三", 20)

复制代码

areItemsTheSame → true

areContentsTheSame → true

结果：什么都不做，跳过 onBindViewHolder

列表里换了用户

kotlin 复制代码

old = User(1, "张三", 20)
new = User(2, "李四", 25)

复制代码

areItemsTheSame → 1 == 2 → false

结果：视为删除 User1 + 新增 User2，触发删除 + 插入动画

注：此时 areContentsTheSame 不会被调用

列表顺序变化

kotlin 复制代码

oldList = [User(1), User(2), User(3)]
newList = [User(3), User(1), User(2)]

复制代码

每个对象的 id 都能在新旧列表里匹配到，areItemsTheSame 为 true

DiffUtil 识别出这是移动，触发 notifyItemMoved 的位移动画，不会删除重建