Kotlin中 StateFlow 或 SharedFlow 的区别

StateFlow 和 SharedFlow 是 Kotlin 协程(Coroutines) 提供的两种 响应式数据流(Reactive Streams) ,用于在应用程序中处理异步数据流,类似于 RxJava 的 Observable 或 Flowable,但更轻量且与 Kotlin 协程深度集成。


1. StateFlow(状态流)

StateFlow 是一种 热流(Hot Flow),它会存储当前的状态值,并在状态变化时通知所有订阅者。

特点

  • 必须有初始值(不能为空)。

  • 只保留最新的值(新订阅者会立即收到当前值)。

  • 是 SharedFlow 的特殊情况 (相当于 replay=1 的 SharedFlow)。

  • 适用于 UI 状态管理 (如 ViewModel 暴露 UI 状态)。

示例

Kotlin 复制代码
// 定义 StateFlow(通常在 ViewModel 中)
private val _counterState = MutableStateFlow(0) // 初始值 0
val counterState: StateFlow<Int> = _counterState.asStateFlow()

// 更新值
fun increment() {
    _counterState.value++ // 自动通知所有订阅者
}

// 在 Activity/Fragment 中监听
lifecycleScope.launch {
    viewModel.counterState.collect { value ->
        textView.text = "Count: $value"
    }
}

2. SharedFlow(共享流)

SharedFlow 也是一种 热流 ,但它不存储状态,而是用于 广播事件(如一次性事件、通知等)。

特点

  • 没有初始值(可以发送任意数量的数据)。

  • 可以配置缓存大小 (replay 控制新订阅者能收到多少历史数据)。

  • 适用于事件总线、通知等场景(如 Toast 消息、导航事件)。

示例

Kotlin 复制代码
// 定义 SharedFlow(通常在 ViewModel 中)
private val _toastEvent = MutableSharedFlow<String>() // 无初始值
val toastEvent: SharedFlow<String> = _toastEvent.asSharedFlow()

// 发送事件
fun showToast(message: String) {
    viewModelScope.launch {
        _toastEvent.emit(message) // 发送事件
    }
}

// 在 Activity/Fragment 中监听
lifecycleScope.launch {
    viewModel.toastEvent.collect { message ->
        Toast.makeText(this, message, Toast.LENGTH_SHORT).show()
    }
}

StateFlow vs SharedFlow

特性 StateFlow SharedFlow
初始值 ✅ 必须有 ❌ 不需要
缓存历史数据 仅最新值 可配置 (replay)
适用场景 UI 状态管理(如 LiveData 替代) 事件总线、通知
是否热流 ✅ 是 ✅ 是
线程安全 ✅ 是(协程作用域内) ✅ 是

因此,以下面这段代码举例:

Kotlin 复制代码
/**
     * 应用中心数据变化,更新应用中心小组件的显示
     */
    private fun WidgetSelectorViewModel.observerAppList() = coroutineScope.launch {
        appWidgets.onEach { list ->
            Log.d(TAG, "observerAppList setDataList")
            gridAdapterApp.setDataList(list)
            appItemBinding?.groupNoData?.isVisible = list.isEmpty()
        }.launchIn(coroutineScope)
    }  

功能总结:

这段代码的主要作用是监听应用小组件列表(appWidgets)的变化,每当列表更新时:

将新列表设置给网格适配器(gridAdapterApp)以更新UI

根据列表是否为空来显示或隐藏"无数据"的提示

所有这些操作都在协程中异步执行

这是一种典型的响应式编程模式,通过观察数据流来自动更新UI,避免了手动刷新数据的需要。

首先是函数定义:

Kotlin 复制代码
private fun WidgetSelectorViewModel.observerAppList() = coroutineScope.launch {
  • 这是一个 WidgetSelectorViewModel 的扩展函数

  • 函数是私有的(private)

  • 返回一个协程启动器(launch)

  • 函数名为 observerAppList(),表示它用于观察应用列表

其次是函数体:

Kotlin 复制代码
appWidgets.onEach { list ->
    gridAdapterApp.setDataList(list)
    appItemBinding?.groupNoData?.isVisible = list.isEmpty()
}.launchIn(coroutineScope)
  • appWidgets 可能是一个 StateFlow 或 SharedFlow(取决于它的定义)。

  • onEach 会在每次数据变化时执行,更新 UI。

  • launchIn(coroutineScope) 表示在指定的协程作用域内启动这个流。


总结

  • StateFlow → 用于 UI 状态管理 (如 LiveData 的替代)。

  • SharedFlow → 用于 事件通知(如 Toast、导航事件)。

  • 两者都是 热流,即使没有订阅者也会发送数据。

  • 通常结合 ViewModel + collect 使用,实现响应式 UI 更新。

如果你的 appWidgets 是一个应用列表的状态,那它更适合用 StateFlow;如果是临时事件(如刷新完成通知),则更适合 SharedFlow。

相关推荐
dialect_29 分钟前
KMP算法
开发语言·c++·算法
jktantan1 小时前
Vue keep-alive 切标签后滚动位置回顶?因为 onDeactivated 里读到的 scrollTop 是 0
前端·javascript·vue.js
总要学点什么1 小时前
第89篇:三维特效-螺旋圆效果——让螺旋臂卷起一圈圈外扩的涟漪
开发语言·javascript·ecmascript·webgl·cesium·空间分析·1024程序员节
前端精髓2 小时前
调用openrouter的免费API模型
java·前端·javascript
开开心心_Every3 小时前
快速隐藏程序工具自定义快捷键一键切换
java·开发语言·前端·spring·智能手机·word·intellij-idea
chenbingjie_c3 小时前
C++ 多态完全指南:从虚函数重写到虚函数表原理
开发语言·c++
吴卫斌3 小时前
定投ETF实战指南(四):行业/主题ETF——定投的“进攻端“
开发语言·python·股票·量化
超级架构师4 小时前
PRAXO-CORE 2.5.0:用 conformance 和显式边界构建 Go Agent 框架
开发语言·人工智能·后端·golang·ai编程·智能体框架·praxo-core
叼烟扛炮5 小时前
Linux 学习笔记(四十三):网络编程进阶——自定义协议解决 TCP 粘包与守护进程
linux·开发语言·网络·笔记·tcp/ip
LMT流氓兔5 小时前
第五单元——第十六课:给书店助手加上网页界面
java·开发语言·jvm·人工智能·oracle·langchain·1024程序员节