SuperAPI AI 工具集

gof-kotlin-idioms

编程与开发

查看项目

更新于 10-16 16:27

技能介绍

本技能用于把每一个 GoF 设计模式翻译成惯用的 Kotlin 写法,并对若干模式说明何时 Kotlin 的语言特性可以直接取代该模式。

适用时机:已经通过 gof-identify 选定了某个 GoF 模式且目标语言是 Kotlin;用户希望得到惯用的 Kotlin 代码而非 Java 味的 Kotlin;代码审查中需要判断「这处 Kotlin 模式用法是否地道」。

不适用时机:目标语言不是 Kotlin;用户仍在挑选模式(应转向 gof-identify);框架特定模式(Spring、Arrow)不在范围内。

核心内容按模式给出惯用 Kotlin 构造,并标注语言何时取代模式:

Strategy:使用函数类型而非接口,例如以 private val compare: (Item, Item) -> Int 构造 Sorter;基于接口的 Strategy 在 Kotlin 中很少需要。若有多个紧密相关的操作,可归入 sealed interface,使 when 具备穷尽性。

Observer:使用 Flow / SharedFlow / StateFlow,几乎不应自行维护观察者列表。StateFlow 始终有当前值并合并重复值,适合消费方总需要最新值的状态(UI 状态、当前用户、连接状态),以 .value 读取、用 .collect 观察;SharedFlow 没有必需的当前值,可重放 N 条历史值、可缓冲,适合事件;Flow(冷流)对每个收集者重新执行发射逻辑,适合拉取驱动的流;Deferred(async { … }.await())是一次性异步值。

Decorator:用 by 进行类委托,只覆写需要变化的方法。注意 is 检查看不穿 by:装饰器实现的是接口而非被包装的具体类,因此对具体被包装类型做 is 检查说明抽象已泄漏,应重构或统一通过接口处理。

Factory:在类型上使用伴生对象工厂方法或顶层函数;Factory Method / Abstract Factory 同理,可用 sealed interface PizzaFactory 并在调用点做穷尽 when。

Singleton:直接使用 object,语言保证线程安全,无需双重检查锁或 getInstance()。为便于测试,优先依赖注入。

Command:使用函数类型(() -> Unit 或 suspend () -> Result<X>),或需要模式匹配时用 sealed interface 的命令类型;撤销/重做时每个命令携带自己的 undo()。

Adapter:单一方法用扩展函数即可,多方法可用包装类;限界上下文之间的 ACL 参见 ddd-context-mapping。

Facade:顶层函数或小型类即可,但纪律(无状态、保持窄接口)仍然适用。

Template Method:把可变步骤作为 lambda 参数传入的函数常可取代基于子类的模板;当步骤在多次调用间共享状态时,子类方式仍然合适。

Iterator:直接实现 Iterator<T> 和/或 Iterable<T>,用 iterator { … } 构建器配合 yield 做惰性迭代;转换/过滤管线用 Sequence<T>。

Composite、State:使用 sealed 层级 + 穷尽 when 获得编译期检查,State 由上下文委托给当前状态,可消除「忘记处理某个状态」类缺陷。

Proxy:虚拟代理用 by lazy,远程代理用生成的桩(gRPC、Retrofit、OpenAPI 代码生成);保护代理建议在控制器/边界层做授权,而非进程内可被绕过的代理。

Builder:默认使用命名参数 + 默认值;仅当构造确实分阶段(中间校验、类型状态)或 DSL 更易读时才使用显式 Builder;DSL 构建器使用最后一个参数为带接收者的 lambda。

Prototype:使用 data class 的 copy(...),注意 copy() 是浅拷贝,嵌套可变集合会与副本共享,深拷贝需使用不可变嵌套类型或显式复制。

Bridge:通过构造参数进行普通组合即可,无需抽象类。

Visitor:几乎总是优先 sealed + 穷尽 when;仅在层级确实开放或访问者需跨访问携带丰富状态时才用经典 Visitor。

另外还给出作用域函数速查:apply 配置接收者并返回接收者;also 做副作用并返回接收者;let 以 it 变换接收者并返回 lambda 结果;run 类似 let 但接收者为 this;with 作为顶层函数传入接收者。应根据接收者风格(this 与 it)与返回值(接收者与 lambda 结果)来选择。

决策启发式:在 Kotlin 中优先语言特性而非模式;优先不可变;标记/变体层级用 sealed interface,需要共享状态时才用 sealed class;值式包装用 data class,身份重要或持有可变状态时用普通类;顶层函数或扩展函数能做同样的事就不要用基于类的模式实现。

反模式包括:Java 味的 Kotlin(有 object 还写 getInstance 式 Singleton、用函数类型可解决却写接口式 Strategy);为没有封闭变体集合的东西使用 sealed 层级;不覆写任何方法却加行为的 by 委托;有状态的 object 声明;用 lateinit var 伪装不可变性。

相关技能:全部十三个 gof-* 模式技能、负责挑选模式的 gof-identify,以及 DDD 模式的姊妹适配器 ddd-kotlin-idioms。参考资料包括 Kotlin 语言文档(object、data class、value class、sealed class / sealed interface、by 类委托、协程 / Flow、作用域函数)、《Head First Design Patterns(第 2 版)》与《Kotlin Design Patterns and Best Practices(Alexey Soshin)》。