SuperAPI AI 工具集

kotlin-patterns

编程与开发

查看项目

更新于 10-15 17:20

技能介绍

用途:为 Orca 服务的 Kotlin/Spring Boot 后端开发提供统一的代码模式,适用于实现后端功能、编写服务层、仓库层与控制器时参考。

主要能力:资料给出了实体(Entity)、服务(Service)、仓库(Repository,使用 JOOQ)、控制器(Controller)、API 接口、DTO 与异常等分层模式。

实体:使用 data class,包含 id: UUID、name: String、createdAt: Instant、updatedAt: Instant?。

服务:以 @Service 注解,构造注入仓库与相关服务。create 方法使用 @Transactional(propagation = Propagation.NEVER),返回 Pair<EntityResponse, Boolean> 以支持幂等操作;并提供 findById 与 findAll。

仓库:以 @Repository 注解,注入 DSLContext,用 JOOQ 的 selectFrom、where、insertInto、returning 实现查询、保存与记录到实体的转换。

控制器:@RestController 实现 API 接口,create 根据是否新建返回 201 或 200,getById 找不到时抛出 ResourceNotFoundRestException。

API 接口:使用 @Tag、@Operation、@PostMapping、@GetMapping 等注解定义路由与文档。

DTO:CreateRequest 使用 @field:NotBlank、@field:Size 校验;EntityResponse 用于返回。异常使用类型化异常,如 ResourceNotFoundRestException、ValidationRestException、ConflictRestException。

空安全指南:可选操作用 ?.let{},匹配用 when,避免 !!,改用 .single()、.firstOrNull(),幂等操作返回 Pair<Result, Boolean>。

使用方式与限制:资料未提供安装命令、依赖配置或具体项目集成步骤,暂未提供收费、平台等信息。