Kotlin MVVM架构下点击RecyclerView项更新ViewModel LiveData方法咨询

API 探路者

2026-5-13

如何在RecyclerView的CheckBox点击时更新MVVM架构中的ViewModel LiveData？

作为Kotlin新手，我正在开发一个基于MVVM架构的应用。目前已经通过Repository用Retrofit发起网络请求，把数据返回给ViewModel，在Fragment中观察LiveData变化并更新RecyclerView Adapter，这部分功能运行正常。但现在我需要实现点击RecyclerView列表项中的CheckBox时，更新ViewModel里的LiveData，却不知道正确的实现方式。

我的相关代码如下：

ViewModel代码

class MainActivityViewModel : ViewModel() { 
    private var mutableLiveGitUsers: MutableLiveData<ArrayList<GitUsers>>? = null 
    private lateinit var gitUsersRepository: GitUsersRepository 
    var allUsersListener: AllUsersListener? = null 
    fun init() { 
        gitUsersRepository = GitUsersRepository() 
        allUsersListener?.onStarted() 
        mutableLiveGitUsers = gitUsersRepository.getGitUsers() 
        allUsersListener?.onSuccess(mutableLiveGitUsers!!) 
    } 
    fun getGitUsersData(): MutableLiveData<ArrayList<GitUsers>>? { 
        return mutableLiveGitUsers 
    } 
}

Fragment观察代码

mutableLiveGitUsers.observe(this, Observer { 
    progressBar.hide() 
    rvAllUsersAdapter = AllUsersAdapter(mainActivityViewModel.getGitUsersData()?.value!!) 
    rvAllUsers.adapter = rvAllUsersAdapter 
    rvAllUsersAdapter.notifyDataSetChanged() 
})

RecyclerView Adapter代码

class AllUsersAdapter(private var gitUsersArrayList: ArrayList<GitUsers>) : RecyclerView.Adapter<AllUsersAdapter.AllUsersViewHolder>() { 
    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): AllUsersViewHolder { 
        val inflater: LayoutInflater = LayoutInflater.from(parent.context) 
        val v: View = inflater.inflate(R.layout.items_all_users, parent, false) 
        return AllUsersViewHolder(v) 
    } 
    override fun getItemCount(): Int { 
        return gitUsersArrayList.size 
    } 
    override fun onBindViewHolder(holder: AllUsersViewHolder, position: Int) { 
        holder.tvUserName.text = gitUsersArrayList[position].login 
        Glide.with(holder.itemView.context) 
            .load(gitUsersArrayList[position].avatarUrl) 
            .centerCrop() 
            .into(holder.imageView) 
        holder.checkBox.isSelected = gitUsersArrayList.get(position).isSelected 
        holder.checkBox.setOnCheckedChangeListener{compoundButton, isChecked -> 
            if (isChecked){ 
                /* 此处需更新LiveData以在Fragment中观察并同步UI */
                Log.d("TESTC","AllUsersAdapter IsChecked") 
            }else{ 
                Log.d("TESTC","AllUsersAdapter UnChecked") 
            } 
        } 
    } 
    class AllUsersViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) { 
        var tvUserName: TextView = itemView.findViewById(R.id.tvUserName) 
        var imageView: ImageView = itemView.findViewById(R.id.imageView) 
        var checkBox: CheckBox = itemView.findViewById(R.id.checkBox) 
    } 
}

解决方案：遵循MVVM的关注点分离原则

在MVVM架构中，Adapter的职责仅仅是展示数据和传递用户交互事件，不应该直接持有ViewModel或者修改LiveData。我们需要通过回调接口把CheckBox的点击事件传递给Fragment，再由Fragment通知ViewModel更新数据，最终通过LiveData的变化同步UI。

步骤1：确保GitUsers数据类的isSelected字段是可变的

首先要确认你的GitUsers数据类中，isSelected是var类型（如果是val的话无法修改）：

data class GitUsers(
    val login: String,
    val avatarUrl: String,
    var isSelected: Boolean = false // 用var定义，默认值设为false
)

步骤2：给Adapter添加点击回调接口

在Adapter中定义一个接口，用于将CheckBox的选中事件传递给Fragment：

class AllUsersAdapter(
    private var gitUsersArrayList: ArrayList<GitUsers>,
    private val onItemCheckedListener: OnItemCheckedListener // 添加回调参数
) : RecyclerView.Adapter<AllUsersAdapter.AllUsersViewHolder>() {

    // 定义回调接口
    interface OnItemCheckedListener {
        fun onItemChecked(position: Int, isChecked: Boolean)
    }

    // ... 省略其他原有代码 ...

    override fun onBindViewHolder(holder: AllUsersViewHolder, position: Int) {
        val user = gitUsersArrayList[position]
        holder.tvUserName.text = user.login
        Glide.with(holder.itemView.context)
            .load(user.avatarUrl)
            .centerCrop()
            .into(holder.imageView)
        
        // 用isChecked而非isSelected，避免状态错乱
        holder.checkBox.isChecked = user.isSelected
        
        holder.checkBox.setOnCheckedChangeListener { _, isChecked ->
            // 先更新本地数据状态
            user.isSelected = isChecked
            // 通过回调通知Fragment
            onItemCheckedListener.onItemChecked(position, isChecked)
        }
    }

    // ... 省略ViewHolder代码 ...
}

步骤3：在ViewModel中添加更新用户选中状态的方法

ViewModel需要提供一个方法来更新LiveData中的用户数据，并且要确保LiveData能通知观察者（Fragment）：

class MainActivityViewModel : ViewModel() { 
    private var mutableLiveGitUsers: MutableLiveData<ArrayList<GitUsers>>? = null 
    private lateinit var gitUsersRepository: GitUsersRepository 
    var allUsersListener: AllUsersListener? = null 

    fun init() { 
        gitUsersRepository = GitUsersRepository() 
        allUsersListener?.onStarted() 
        mutableLiveGitUsers = gitUsersRepository.getGitUsers() 
        allUsersListener?.onSuccess(mutableLiveGitUsers!!) 
    } 

    fun getGitUsersData(): MutableLiveData<ArrayList<GitUsers>>? { 
        return mutableLiveGitUsers 
    }

    // 添加更新用户选中状态的方法
    fun updateUserSelection(position: Int, isChecked: Boolean) {
        mutableLiveGitUsers?.value?.let { users ->
            if (position in users.indices) {
                users[position].isSelected = isChecked
                // 手动触发LiveData更新通知（因为修改的是列表对象的属性，而非替换整个列表）
                mutableLiveGitUsers?.postValue(users)
            }
        }
    }
}

步骤4：修改Fragment代码，实现Adapter回调并优化Adapter初始化

Fragment需要实现Adapter的回调接口，调用ViewModel的更新方法，同时优化Adapter的初始化逻辑（不要每次观察到数据都重新创建Adapter，而是更新数据）：

// 在Fragment中实现Adapter的回调接口
class YourFragment : Fragment(), AllUsersAdapter.OnItemCheckedListener {

    private lateinit var mainActivityViewModel: MainActivityViewModel
    private lateinit var rvAllUsersAdapter: AllUsersAdapter

    // ... 省略其他初始化代码 ...

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        
        // 初始化ViewModel（假设已通过ViewModelProvider获取实例）
        mainActivityViewModel = ViewModelProvider(this)[MainActivityViewModel::class.java]
        
        // 初始化Adapter，传入空列表和回调
        rvAllUsersAdapter = AllUsersAdapter(arrayListOf(), this)
        rvAllUsers.adapter = rvAllUsersAdapter

        // 观察LiveData变化
        mainActivityViewModel.getGitUsersData()?.observe(viewLifecycleOwner, Observer { users ->
            progressBar.hide()
            // 更新Adapter数据，而非重新创建Adapter
            rvAllUsersAdapter.gitUsersArrayList = users
            rvAllUsersAdapter.notifyDataSetChanged()
        })
    }

    // 实现回调方法，调用ViewModel更新数据
    override fun onItemChecked(position: Int, isChecked: Boolean) {
        mainActivityViewModel.updateUserSelection(position, isChecked)
    }
}

步骤5：额外优化：给Adapter添加数据更新方法（可选）

为了让Adapter代码更规范，可以添加专门的更新数据方法，而非直接修改成员变量：

class AllUsersAdapter(
    private var gitUsersArrayList: ArrayList<GitUsers>,
    private val onItemCheckedListener: OnItemCheckedListener
) : RecyclerView.Adapter<AllUsersAdapter.AllUsersViewHolder>() {

    // ... 省略其他代码 ...

    // 添加更新数据的方法
    fun updateData(newUsers: ArrayList<GitUsers>) {
        gitUsersArrayList.clear()
        gitUsersArrayList.addAll(newUsers)
        notifyDataSetChanged()
    }
}

然后在Fragment中替换为：

mainActivityViewModel.getGitUsersData()?.observe(viewLifecycleOwner, Observer { users ->
    progressBar.hide()
    rvAllUsersAdapter.updateData(users)
})

为什么要这么做？

遵循MVVM架构原则：Adapter只负责UI展示和事件传递，ViewModel负责业务逻辑和数据管理，Fragment作为中间层协调二者，职责清晰。
避免内存泄漏：Adapter不持有ViewModel引用，不会因为ViewModel的生命周期导致内存泄漏。
数据一致性：所有数据的修改都通过ViewModel统一处理，确保LiveData中的数据和UI展示一致。

内容的提问来源于stack exchange，提问作者Chirag Parekh

Kotlin MVVM架构下点击RecyclerView项更新ViewModel LiveData方法咨询

ViewModel代码 #

Fragment观察代码 #

RecyclerView Adapter代码 #

解决方案：遵循MVVM的关注点分离原则 #