SuperAPI AI 工具集

kotlin-best-practices

编程与开发

查看项目

更新于 10-15 18:45

技能介绍

用途:这是一份 Kotlin 编码规范速查,供编写或审查 Kotlin 代码时参考,统一空安全、错误处理、枚举、ORM 与事务等写法。

主要约定: 空安全:禁止使用 !!,改用 ?.、?: 或空值检查配合智能转换。 错误处理:Manager 层返回 Either<ClientException, T>,不抛异常;Controller 层用 .throwOrValue() 解包。 枚举:存在枚举时不得硬编码字符串,统一使用 EnumName.VALUE.value。 Exposed ORM:表继承 UUIDTable,字段用 text() 而非 varchar();查询始终过滤 deletedAt.isNull();软删除通过更新时间戳实现,不做硬删除。 事务:读操作使用 db.replica,写操作使用 db.primary;多表写入放在单个事务块中,全部成功或全部回滚。 转换:在 Response DTO 内放 companion object { fun from(entity) },不单独建 mapper 文件。

应避免:!!、@Suppress(应修复根因)、抛异常(改返回 Either.left())、SQL 中的 VARCHAR(用 TEXT)、枚举值硬编码字符串、表基类直接继承(改用 UUIDTable)、字段注入(改用构造器注入)。

使用方式与限制:资料未提供安装或调用方式,更多示例见其 code-patterns.md 文件;具体项目适配方式暂未提供。