SuperAPI AI 工具集

kp-select

编程与开发

查看项目

更新于 10-16 16:26

技能介绍

用途

kp-select 是一个关于 Kotlin 协程 select { … } 表达式的技能。select 表达式可同时在多个挂起子句(通道接收、Deferred 等待、超时)上挂起,并在第一个子句就绪时恢复执行。它是协程安全的,且偏向声明顺序。

适用场景包括:

  • 在多个通道之间进行多路复用,即“等待来自这些来源中任意一个的输入”。
  • 竞争多个 Deferred<T>,并对最先完成者采取行动(其他分支自然失败)。
  • 实现超时:在真实操作与 onTimeout 子句之间做 select。
  • 跨通道状态构建非阻塞轮询,而不锁死调用协程。

不适用场景包括:

  • 单一来源——直接使用 await、receive 或 delay 即可。select 只会增加仪式感而无收益。
  • 在 Flow 上需要“取最新”语义——应使用 flatMapLatest,而非 select。
  • 在备选算法之间做选择(与时机无关)——应使用配置开关。

主要能力

基本用法示例:

suspend fun firstReady(a: ReceiveChannel<Int>, b: ReceiveChannel<Int>): Int = select {
    a.onReceive { it }
    b.onReceive { it }
    onTimeout(5_000) { -1 }
}

当任意子句变为就绪(a 上有值到达、b 上有值到达,或经过 5 秒),select 就会恢复并运行对应的 lambda。lambda 的返回值成为 select 表达式的值。

常见子句:

  • ch.onReceive { v -> … } —— 从通道接收值;lambda 获得该值。
  • ch.onReceiveCatching { result -> … } —— 通道变体,将关闭作为值暴露出来而不是抛出异常。
  • def.onAwait { v -> … } —— 等待一个 Deferred<T>;lambda 获得结果。
  • ch.onSend(value) { … } —— 向通道发送值;若发送成功则运行 lambda。
  • onTimeout(d) { … } —— 若没有其他子句就绪,则在时长 d 后触发。

偏向性:当多个子句同时就绪时,select 偏向于最先声明的子句。需谨慎使用——按优先级排列子句顺序。

单次执行:select { … } 只触发一次,然后完成。要循环处理多个来源的事件,需将 select 包裹在 while (isActive) { … } 中。

while (isActive) {
    select<Unit> {
        commands.onReceive { handle(it) }
        ticker.onReceive { tick() }
    }
}

使用方式

决策启发式:

  • 仅当有 ≥2 个挂起源需要等待时才使用 select。只有一个来源时,直接调用更清晰。
  • 对于希望有回退值的软超时,使用 onTimeout;对于取消整个操作的硬超时,使用 withTimeout。
  • 偏向排序意味着热来源可能饿死冷来源。若饥饿问题重要,可混入随机打乱、轮询或 onTimeout。

反模式:

  • 对单一来源使用 select——增加仪式感而无收益。
  • 在 select 子句中做繁重工作——子句应是小型的调度器;实际工作应在 select 返回后进行。
  • 在子句中未同步地修改共享状态——会引发跨子句竞态条件。
  • 长时间运行的 select 循环没有取消检查——确保循环体尊重 isActive 或周期性 yield。

适用场景

适用于需要同时等待多个挂起来源中任意一个先就绪的协程代码,典型如通道多路复用、Deferred 竞争、超时回退、非阻塞轮询。

限制

  • 仅适用于具备 ≥2 个挂起来源的场景,单一来源时应直接调用。
  • 单次执行,循环处理需自行包裹 while (isActive)。
  • 存在声明顺序偏向,可能导致热来源饿死冷来源。

另见:kp-channels(select 在通道上最有用)、kp-launch-vs-async(onAwait 让 select 可在 Deferred<T> 上多路复用)、kp-structured-concurrency(将 select 与 coroutineScope 结合以获得干净的取消)。

参考:Kotlin Coroutines(Marcin Moskała)中关于 select 表达式的专门章节;Kotlin 协程官方指南中 select 表达式部分。