SuperAPI AI 工具集

kotlin-backend-jpa-entity-mapping

编程与开发

查看项目

更新于 10-15 23:47

技能介绍

用途:为 Kotlin + Spring Data JPA/Hibernate 项目提供正确的持久化实体建模指导,覆盖实体设计、标识与相等性、唯一性约束、查询与抓取规则以及常见 ORM 陷阱。

主要能力:强调 JPA 实体不要使用 data class(data class 会按全部字段生成 equals/hashCode,状态变化后破坏 Set/Map 成员关系,copy() 还会产生游离副本),应使用普通类,data class 留给 DTO;建议区分传输 DTO 与持久化实体;要求确认 kotlin("plugin.jpa") 或等价的无参构造支持,并保证类与成员可被代理。标识与相等性方面:无既有约定时采用基于 ID 的相等性与稳定 hashCode;数据库生成 ID 用可空 var id: Long? = null 加 protected set,不用 0L 作哨兵;equals 仅比较 ID,hashCode 返回基于类的常量,toString 不引用懒加载集合。唯一性约束方面:幂等 API 需数据库约束加应用层检查双保险,数据库约束保证正确性,应用检查提供清晰错误,Spring Data 可自动派生 findByXAndY 查询。查询与抓取方面:通过实际查询计数或 SQL 日志诊断 N+1,优先使用 @EntityGraph、JOIN FETCH、批量抓取或 DTO 投影,注意集合抓取连接与分页的取舍。

使用方式:作为编码规范与审查清单应用于实体类、Repository 与服务层设计;资料未提供安装命令或调用方式。

适用场景:Kotlin 后端 Spring Data JPA 项目的实体建模、幂等写入、抓取优化与并发控制。

限制:资料未提供收费、价格、平台或效果数据;具体项目约定优先于通用建议。