原生移动开发 / 系统课时

Room、Flow 与 ViewModel

Room、Flow 与 ViewModel

这一节把 Room 的可观察查询接到 ViewModel 和 Compose:数据库表一旦变化,查询结果会沿着 Flow 自动变成界面状态,不需要手动重新查询,也不让界面直接依赖 DAO。

学习目标

  • 用 Flow<List<T>> 暴露 Room 的持续查询结果
  • 在 ViewModel 中把 Flow 转成生命周期合适的 StateFlow
  • 在 Compose 中安全收集状态,并理解写入触发刷新链路

从数据库变化到界面刷新

Room 的 SELECT 查询可以直接返回 Flow。当被查询的表发生变化时,Room 会使对应查询失效并重新执行;新的结果继续从同一条流发出。Repository 负责屏蔽 DAO,ViewModel 再把冷 Flow 转成可持有当前值的 StateFlow,界面只观察状态。

Room 查询结果流向 Compose 的数据链路

这种分层的关键不是“多包一层”,而是让数据只有一个清晰来源:DAO 负责数据库访问,Repository 对上层提供数据能力,ViewModel 负责界面状态,Composable 不保存数据库副本。

串起 DAO、Repository 与 ViewModel

下面是片段示例,假设 Android 模块已经配置 Room、Kotlin Coroutines、Lifecycle Compose 与 Jetpack Compose。依赖注入方式可以按项目选择,示例只聚焦查询、写入和状态收集。

kotlin
import androidx.compose.foundation.layout.Column
import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.lifecycle.ViewModel
import androidx.lifecycle.compose.collectAsStateWithLifecycle
import androidx.lifecycle.viewModelScope
import androidx.room.Dao
import androidx.room.Entity
import androidx.room.PrimaryKey
import androidx.room.Query
import androidx.room.Upsert
import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.SharingStarted
import kotlinx.coroutines.flow.StateFlow
import kotlinx.coroutines.flow.stateIn
import kotlinx.coroutines.launch

@Entity(tableName = "tasks")
data class TaskEntity(
    @PrimaryKey val id: Long,
    val title: String
)

@Dao
interface TaskDao {
    @Query("SELECT * FROM tasks ORDER BY id")
    fun observeAll(): Flow<List<TaskEntity>>

    @Upsert
    suspend fun upsert(task: TaskEntity)
}

class TaskRepository(private val dao: TaskDao) {
    val tasks: Flow<List<TaskEntity>> = dao.observeAll()

    suspend fun save(task: TaskEntity) = dao.upsert(task)
}

class TaskViewModel(private val repository: TaskRepository) : ViewModel() {
    val tasks: StateFlow<List<TaskEntity>> = repository.tasks.stateIn(
        scope = viewModelScope,
        started = SharingStarted.WhileSubscribed(5_000),
        initialValue = emptyList()
    )

    fun addTask() {
        viewModelScope.launch {
            repository.save(TaskEntity(id = 1, title = "离线任务"))
        }
    }
}

@Composable
fun TaskScreen(viewModel: TaskViewModel) {
    val tasks by viewModel.tasks.collectAsStateWithLifecycle()

    Column {
        Button(onClick = viewModel::addTask) {
            Text("添加任务")
        }
        tasks.forEach { task ->
            Text(task.title)
        }
    }
}

预期结果

text
初始界面只显示“添加任务”按钮。
点击按钮后,Room 表发生变化,Flow 发出新列表,界面自动出现“离线任务”。

这里没有在点击后调用一次“重新查询”。写入让 Room 感知表变化,DAO 的 Flow 发出新结果,StateFlow 更新后 Compose 自动重组,这正是可观察查询的价值。

为什么在 ViewModel 中转成 StateFlow

DAO 返回的 Flow 表达“数据会继续变化”,但界面通常还需要一个随时可读取的当前状态。stateIn 把上游 Flow 共享为 StateFlow,并使用 viewModelScope 把状态生命周期限定在 ViewModel 内。

SharingStarted.WhileSubscribed(5_000) 表示界面没有订阅者后短暂保留上游订阅,再停止不必要的工作;重新出现订阅者时会继续收集。界面侧用 collectAsStateWithLifecycle(),可避免界面不可见时仍持续做无意义的状态收集。

保持单向数据流

读取路径是 Room → DAO → Repository → ViewModel → UI,写入事件则反向进入 ViewModel,再由 Repository 调用 DAO。不要让 Composable 直接拿 DAO,也不要在 Repository 和 ViewModel 各维护一份可变列表,否则数据库、缓存副本和界面状态很容易出现不同步。

如果页面只需要一次性读取,可以使用挂起查询;如果页面应该持续反映本地数据库变化,就让 DAO 返回 Flow,并把数据库作为这条状态链路的事实来源。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Room、Flow 与 ViewModel

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通