把 JSON 转换成 Spring Boot 3 上 Spring Data JPA 所用的 @Entity 类。生成的单个 Java 文件包含 jakarta.persistence 和 jakarta.validation 的 import、@Id 主键、每个 key 对应的 private 字段、Lombok 的 @Getter、@Setter 和 @FieldNameConstants,以及 Bean Validation 的 @NotEmpty/@NotNull。
它面向 Spring Boot 后端开发:手里有对接方提供的示例 JSON 或页面规格,需要快速得到一个映射到表的实体。
模型名 中输入实体类名(默认 MyModel)。它的小写形式也会用在包名末尾(com.hello.world.reservation)。package 行改成你项目的包名,保存为 Reservation.java,再创建一个继承 JpaRepository<Reservation, Long> 的 repository。{
"guest_name": "Hana Lee",
"room_no": 1204,
"nights": 3,
"rate": 149.5,
"breakfast": true,
"check_in": "2024-08-09T15:00:00"
}package com.hello.world.reservation;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import jakarta.validation.constraints.NotEmpty;
import jakarta.validation.constraints.NotNull;
import java.time.LocalDateTime;
import lombok.Getter;
import lombok.Setter;
import lombok.experimental.FieldNameConstants;
@Entity
@FieldNameConstants
@Getter
@Setter
public class Reservation {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@NotEmpty()
@Column(name = "guest_name")
private String guestName;
@NotNull()
@Column(name = "room_no")
private Long roomNo;
@NotNull()
private Long nights;
@NotNull()
private Double rate;
@NotNull()
private Boolean breakfast;
@NotNull()
@Column(name = "check_in")
private LocalDateTime checkIn;
}room_no、nights 这样的整数变成了 Long,rate 变成 Double,check_in 变成 LocalDateTime。每个 snake_case key 都加上了 @Column(name = "...");由于每个值都有内容,String 字段 guestName 得到 @NotEmpty(),其他字段得到 @NotNull()。
Long,小数 → Double,布尔值 → Boolean,YYYY-MM-DD → LocalDate,日期时间 → LocalDateTime,其他字符串(包括纯数字字符串)→ String。Map<String, Object>,数组变成 List<...>,两者都带有 @JdbcTypeCode(SqlTypes.JSON),由 Hibernate 6 存进 JSON 列。@Column(name = "guest_name") 把原始 key 保留为列名;class 这样的 Java 关键字 key 会变成 class_。id 或 id 为整数时生成 @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id,id 为字符串时生成普通的 @Id private String id。@NotEmpty(),其他得到 @NotNull(),因为 @NotEmpty 只适用于字符串和集合。@FieldNameConstants 会生成 Reservation.Fields.guestName 这样的名称常量。需要定期拉取并保存其他系统的预订或订单时,一份响应 JSON 就能得到实体,围绕 saveAll() 的批处理骨架也能很快写出来。
在本地开启 spring.jpa.hibernate.ddl-auto=update 后,Hibernate 会根据生成的实体建表,马上就能载入数据进行 UI 开发。
jakarta. 改回 javax.,并用 converter 替换 @JdbcTypeCode,因为 Hibernate 5 中没有它。149.0 与 149 解析成同一个数字,所以会变成 Long。小数字段需要示例中带有小数部分才会输出为 Double,而金额最好使用 BigDecimal。2024-08-09T15:00:00+09:00 这样带偏移的时间戳,在 LocalDateTime 中会丢失偏移。如果精确时刻很重要,请使用 OffsetDateTime 或 Instant。Map 换成 @Embedded 类或 @OneToMany 关联。@Column(name = ...)?Spring Boot 默认的命名策略恰好会把 guestName 变成 guest_name,但只要 key 不是纯粹的 snake_case,或者策略被修改,这种对应就会失效。显式的名称能让映射不受配置影响始终正确。
@NotNull 吗?如果 classpath 中有 spring-boot-starter-validation(Hibernate Validator),Hibernate 会在 persist 和 update 之前执行 Bean Validation,并抛出 ConstraintViolationException。没有它时,这些注解会被忽略。
@FieldNameConstants 有什么用?Lombok 会生成 Reservation.Fields.checkIn 这样的字符串常量。在 Sort.by(Reservation.Fields.checkIn) 或 Specification/Criteria 查询中用它代替字符串字面量,字段改名时出错的就是构建而不是查询。