用途
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 表达式部分。