总结先行:
| 上游数据类型 | distinctUntilChanged 表现 | distinctUntilChangedBy 表现 | 推荐选择 |
|---|---|---|---|
| 普通 Class (可变) | ❌ 失效(基于内存地址) | ✅ 正常(基于提取的 Key) | 必须用 By |
| String / Int 等 + 小型 Data Class | ✅ 正常(基于值/结构相等) | ✅ 正常(基于值/提取的 Key) | 用原版(更简洁) |
| 巨型 Data Class | ⚠️ 正常但性能损耗大 | ✅ 正常且性能高 | 推荐用 By(提取核心字段) |
一、示例代码
kotlin
// 发射当前关注的设备ID(字符串类型),模拟上游数据触发
val currentKeyFlow: StateFlow<String> = MutableStateFlow("device-01")
// 发射设备状态变化标识,用于触发数据流更新
val deviceStateChangedFlow: StateFlow<Long> = MutableStateFlow(System.currentTimeMillis())
// 普通Class(可变)示例
class Device(val deviceId: String, var state: DeviceState) { // 普通类,未重写equals()
private val deviceAddr = UUID.randomUUID().toString().take(8)
override fun toString(): String {
return "Device('$deviceAddr': deviceId='$deviceId', state=$state)"
}
}
// 或者: data class示例
//data class Device(val deviceId: String, val state: DeviceState)
// 上游combine组合数据流,返回Device?对象
val deviceStateFlow = combine(
currentKeyFlow,
deviceStateChangedFlow
) { currentKey, changed ->
Log.d("test", "currentKey $currentKey change $changed\n"
+ "Details: \n---\n${deviceList.joinToString("\n")}\n")
deviceList.find { it.deviceId == currentKey } // 返回Device?对象
}
//Activity/Fragment收集示例:
lifecycleScope.launch {
viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.STARTED) {
xxx.deviceStateFlow
.collect { device ->
//.....
}
}
}
二、不同上游数据类型的影响
1. 普通 Class (可变)
distinctUntilChanged:上游发射Device普通对象(未重写equals()),其比较逻辑基于对象内存地址(引用)。若修改Device对象的state状态(如从Connected改为Disconnected),对象引用未发生变化,该函数会判定为重复值,不发射新值。
distinctUntilChangedBy:同样以上游发射Device普通对象为例,该函数可提取deviceId+state作为比较Key。即使对象引用未变,只要state状态发生变化,Key就会随之改变,函数会判定为新值,正常发射新值。
2. String / Int 等 + 小型 Data Class
示例:上游发射流为 "device-01" → "device-01" → "device-02",两者均会过滤第二个"device-01",仅发射"device-01"和"device-02",效果无差异;小型Data Class同理,属性完全相同时判定为重复,无需额外处理。
3. 巨型 Data Class
示例:上游发射包含多个属性的巨型Data Class对象,distinctUntilChanged需比较所有属性,性能损耗较大;distinctUntilChangedBy仅提取核心字段作为Key,比较速度快,性能更优。
4. 上游返回空值(null)
两者均支持空值处理,distinctUntilChanged直接比较null,连续两个null会被过滤;distinctUntilChangedBy可通过选择器处理空值,避免空指针,更灵活,示例如下:
kotlin
// 安全处理空值示例
distinctUntilChangedBy { it?.deviceId ?: "default-null" }
三、总结
-
灵活性:distinctUntilChanged无自定义空间,distinctUntilChangedBy可自由定义比较Key,适配更多场景。
-
性能:复杂对象/巨型Data Class优先用distinctUntilChangedBy,简单类型用distinctUntilChanged更简洁。
-
兼容性:distinctUntilChanged不兼容可变普通对象,distinctUntilChangedBy可完美适配。