用途:该技能用于创建符合最佳实践的 JPA 实体,面向 Spring Boot 项目,帮助开发者按统一规范生成实体类结构。
主要能力与规范:要求建立推荐的包结构;主键使用应用生成的 TSID 或 UUID 字符串,并以值对象配合 @EmbeddedId 表示主键;为 JPA 提供 protected 无参构造器,并提供包含全部必填字段的 public 构造器;对输入状态进行校验并对非法输入抛出异常;显式声明表名与字段列名;枚举字段使用枚举类型并加 @Enumerated(EnumType.STRING);逻辑相关字段封装为值对象,并用 @Embedded 与 @AttributeOverrides 嵌入;添加操作实体状态的领域方法;使用 @Version 实现乐观锁;创建包含 createdAt、updatedAt 审计字段的 BaseEntity 并让所有实体继承。
使用方式:TSID 需添加依赖 io.hypersistence:hypersistence-utils-hibernate-71:3.14.1,通过 TSID.Factory.getTsid() 生成字符串或长整型 ID;文中给出 IdGenerator、主键值对象、BaseEntity、AssertUtil 及示例 EventEntity 类,创建新实体时继承 BaseEntity,示例中字段含 @EmbeddedId 主键、@Embedded 值对象、@Enumerated 枚举和 @Version。
限制:资料未说明该技能支持的具体 AI 工具、触发方式、价格与平台,也未提供完整安装或调用命令之外的更多信息;示例字段与业务逻辑仅作模式参考,不代表通用实现。