编辑“︁ViewModel”︁

= ViewModel =

'''ViewModel'''是Android架构组件之一，旨在以生命周期感知的方式存储和管理界面相关的数据。它允许数据在配置更改（如屏幕旋转）后继续存在，同时帮助分离业务逻辑与UI组件。

== 核心特性 ==
* '''生命周期感知'''：自动关联Activity/Fragment生命周期
* '''数据持久化'''：在配置更改时保留数据
* '''UI分离'''：减少Activity/Fragment的业务逻辑负担
* '''作用域控制'''：通过[[ViewModelScope]]管理协程

== 基本用法 ==
=== 创建ViewModel ===
<syntaxhighlight lang="kotlin">
class UserViewModel : ViewModel() {
    private val _users = MutableLiveData<List<User>>()
    val users: LiveData<List<User>> = _users
    
    init {
        loadUsers()
    }
    
    private fun loadUsers() {
        viewModelScope.launch {
            _users.value = repository.getUsers()
        }
    }
}
</syntaxhighlight>

=== 在Activity中使用 ===
<syntaxhighlight lang="kotlin">
class UserActivity : AppCompatActivity() {
    private lateinit var viewModel: UserViewModel
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        viewModel = ViewModelProvider(this).get(UserViewModel::class.java)
        
        viewModel.users.observe(this) { users ->
            // 更新UI
        }
    }
}
</syntaxhighlight>

== 进阶特性 ==
=== 带参数的ViewModel ===
需使用[[ViewModelProvider.Factory]]：
<syntaxhighlight lang="kotlin">
class UserViewModelFactory(private val userId: String) : ViewModelProvider.Factory {
    override fun <T : ViewModel> create(modelClass: Class<T>): T {
        return UserViewModel(userId) as T
    }
}

// 使用方式
val factory = UserViewModelFactory("user123")
viewModel = ViewModelProvider(this, factory).get(UserViewModel::class.java)
</syntaxhighlight>

=== 与SavedStateHandle集成 ===
在进程重建时保存临时数据：
<syntaxhighlight lang="kotlin">
class StateViewModel(private val savedStateHandle: SavedStateHandle) : ViewModel() {
    val currentQuery: LiveData<String> = savedStateHandle.getLiveData("query")
    
    fun setQuery(query: String) {
        savedStateHandle["query"] = query
    }
}
</syntaxhighlight>

== 生命周期示意图 ==
<mermaid>
graph TD
    A[Activity创建] --> B[ViewModel创建]
    B --> C[配置更改]
    C --> D[Activity销毁重建]
    D --> E[重用原ViewModel]
    E --> F[最终销毁]
</mermaid>

== 最佳实践 ==
1. '''不要持有Context引用'''：可能导致内存泄漏
2. '''轻量化ViewModel'''：复杂逻辑应委托给Repository层
3. '''使用LiveData暴露数据'''：确保UI安全更新
4. '''合理使用作用域'''：viewModelScope会自动取消协程

== 与其他组件的关系 ==
* 与[[LiveData]]配合实现数据观察
* 通过[[Room]]访问本地数据库
* 使用[[WorkManager]]处理后台任务
* 结合[[DataBinding]]简化UI更新

[[Category:Android开发]]
[[Category:Kotlin编程]]
[[Category:架构组件]]