📚 课程目录第4章 lambda 回调提升事件

第4章 lambda 回调提升事件：从子组件到父组件的事件传递、接口定义、避免泄露

4.1 原理：为什么需要 lambda 回调？

在 Jetpack Compose 状态提升中，数据从父组件向下单向流动，而事件则必须从子组件向上流动。如果子组件直接修改父组件的状态，会破坏单向数据流，使状态源模糊、难以调试。lambda 回调机制是标准的“子组件 → 父组件”事件传递方式：

职责分离：子组件仅负责触发事件（告知“发生了什么”），不关心事件如何被处理。
状态集中：父组件持有状态，通过 lambda 接收事件并执行状态修改。
可测试性：子组件可以独立测试，只需 mock 回调 lambda 即可验证行为。

从实现角度看，lambda 在 Kotlin 中是匿名函数对象，传递 lambda 引用而不是整个状态对象，能避免子组件持有对父组件的强引用，从而防止内存泄漏。

4.2 实现流程

定义回调类型：通常使用函数类型 (参数类型) → Unit 作为回调类型，例如 onClick: () → Unit 或 onValueChange: (String) → Unit。
父组件传递 lambda：在调用子组件时，传入 lambda 表达式或函数引用（如 onClick = { /* 处理事件 */ }）。
子组件调用回调：在合适的时机（如按钮点击、文本输入变化）调用 onClick() 或 onValueChange(newValue)。
避免泄露：确保 lambda 不持有已销毁 Activity 或 Fragment 的引用，利用 remember 保持 lambda 的稳定性，不使用 remember 时 lambda 会在每次重组时重新创建。
调试验证：在回调中添加 Log.d 输出，观察事件是否被正确传递和处理。

  核心契约：回调函数的参数列表应包含子组件需要传递的数据，通常是最小化信息原则，只传递必要的数据，避免传递整个状态对象。

4.3 代码示例：带文本输入的事件提升

以下示例展示一个自定义输入框组件 MyTextField，它将输入内容通过 onValueChange 回调提升到父组件：

@Composable
fun MyTextField(
    value: String,
    onValueChange: (String) -> Unit,
    modifier: Modifier = Modifier
) {
    TextField(
        value = value,
        onValueChange = { newText ->
            onValueChange(newText)   // 只传递新文本，不保存状态
        },
        modifier = modifier
    )
}

@Composable
fun ParentScreen() {
    var text by remember { mutableStateOf("") }

    // lambda 引用：使用 remember 避免重组时重复创建
    val onValueChange: (String) -> Unit = remember {
        { newValue -> text = newValue }
    }

    MyTextField(
        value = text,
        onValueChange = onValueChange
    )

    Text("当前输入: $text")
}

避免泄露要点：

在 ParentScreen 中，onValueChange 使用 remember { ... } 包裹，确保 lambda 只创建一次，不会因重组而重复生成。
lambda 内部只修改 Compose 状态（text），不引用外部 View 或 Activity，防止跨生命周期泄漏。
如果回调需要调用 ViewModel 方法，应使用 remember 传入稳定引用。

4.4 接口定义：函数类型 vs 自定义接口

方式	语法	适用场景	内存泄漏风险
函数类型（推荐）	`onEvent: (T) -> Unit`	单一事件回调，参数简单	低（通过 remember 控制引用）
自定义接口	`interface OnEventListener { fun onEvent(param: T) }`	需要多个方法时（如 onClick、onLongClick）	中（接口实现可能持有多余引用）
Lambda 引用	`onClick = ::handleClick`	直接引用已有函数	低（函数本身不捕获外部变量）

在 Jetpack Compose 中，优先使用函数类型，因为它更简洁且与 Kotlin 高阶函数完美配合。当需要多个回调时，可使用 data class 包裹多个 lambda。

4.5 调试：如何验证事件传递

Log 输出：在父组件 lambda 中插入 Log.d("StateHoisting", "onValueChange called: $newValue")。
Composable 检查工具：使用 Android Studio Layout Inspector 查看重组次数，若 lambda 未使用 remember，重组时回调解引用会变化，导致不必要的重组。
单元测试：使用 Compose 测试规则，模拟 Lambda 调用并验证状态变更。

4.6 常见错误与解决方案

错误	现象	原因	解决方案
回调未触发	事件无效	子组件未调用回调或者条件不满足	检查子组件逻辑，添加 Log 确认调用点
内存泄漏	Activity 无法被 GC	lambda 捕获了 Activity/View 实例	确保 lambda 内仅引用 Composable 状态或 ViewModel，避免直接引用 Context
重组无限循环	UI 卡顿	lambda 未使用 `remember`，每次重组都创建新引用导致	使用 `remember` 或 `derivedStateOf` 稳定引用

重要：不要在 lambda 中执行耗时操作或将异步任务直接传递给回调。如果需要在事件后执行副作用，应在父组件中使用 LaunchedEffect 或 DisposableEffect。

4.7 性能与稳定性优化

稳定引用：使用 remember 确保回调 lambda 在重组间保持不变，避免子组件因参数变化而重组。
避免过度捕获：lambda 应只捕获最少的变量。若需要访问状态，推荐使用 by 委托或 remember 包裹的状态变量。
使用 derivedStateOf：如果回调逻辑依赖多个状态，在父组件中先用 derivedStateOf 计算后再传入 lambda，减少计算次数。
延迟初始化：在 ViewModel 中定义回调对象，作为 ViewModel 的属性，避免 Composable 重建时产生新的实例。