将 JSON 转换为 Spring Boot JPA 方案!

输入 JSON 并将其转换为 Spring Boot JPA 方案!支持 Spring Data JPA, Hibernate, @Entity, @Id, @GeneratedValue, Lombok。
JSON
结果
 

将 JSON 转换为 Spring Boot JPA 方案!

把 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 或页面规格,需要快速得到一个映射到表的实体。

使用方法

  1. 以对象形式粘贴一条记录,或以数组形式粘贴多条。在任何一条记录中缺失的字段都不会加校验注解。
  2. 在 模型名 中输入实体类名(默认 MyModel)。它的小写形式也会用在包名末尾(com.hello.world.reservation)。
  3. 把 package 行改成你项目的包名,保存为 Reservation.java,再创建一个继承 JpaRepository<Reservation, Long> 的 repository。

示例

输入 (JSON)
{
  "guest_name": "Hana Lee",
  "room_no": 1204,
  "nights": 3,
  "rate": 149.5,
  "breakfast": true,
  "check_in": "2024-08-09T15:00:00"
}
输出 (Spring Data JPA)
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()。

支持的功能

  • Java 类型:整数 → Long,小数 → Double,布尔值 → Boolean,YYYY-MM-DD → LocalDate,日期时间 → LocalDateTime,其他字符串(包括纯数字字符串)→ String。
  • 对象变成 Map<String, Object>,数组变成 List<...>,两者都带有 @JdbcTypeCode(SqlTypes.JSON),由 Hibernate 6 存进 JSON 列。
  • 只要 Java 字段名与原始 key 不同,就用 @Column(name = "guest_name") 把原始 key 保留为列名;class 这样的 Java 关键字 key 会变成 class_。
  • 主键根据 JSON 决定:没有 id 或 id 为整数时生成 @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id,id 为字符串时生成普通的 @Id private String id。
  • 始终存在的字段,非空字符串得到 @NotEmpty(),其他得到 @NotNull(),因为 @NotEmpty 只适用于字符串和集合。
  • Lombok 的 @FieldNameConstants 会生成 Reservation.Fields.guestName 这样的名称常量。

使用场景

存储外部 API 数据的批处理任务

需要定期拉取并保存其他系统的预订或订单时,一份响应 JSON 就能得到实体,围绕 saveAll() 的批处理骨架也能很快写出来。

通过 `ddl-auto` 创建开发用的表

在本地开启 spring.jpa.hibernate.ddl-auto=update 后,Hibernate 会根据生成的实体建表,马上就能载入数据进行 UI 开发。

注意事项与限制

  • import 面向 Jakarta EE(Spring Boot 3、Hibernate 6)。在 Spring Boot 2 上,请把 jakarta. 改回 javax.,并用 converter 替换 @JdbcTypeCode,因为 Hibernate 5 中没有它。
  • JSON 中的 149.0 与 149 解析成同一个数字,所以会变成 Long。小数字段需要示例中带有小数部分才会输出为 Double,而金额最好使用 BigDecimal。
  • 像 2024-08-09T15:00:00+09:00 这样带偏移的时间戳,在 LocalDateTime 中会丢失偏移。如果精确时刻很重要,请使用 OffsetDateTime 或 Instant。
  • JSON 列需要数据库支持(MySQL 5.7+、PostgreSQL、H2 2.x)。对于真正的关系,请把 Map 换成 @Embedded 类或 @OneToMany 关联。

常见问题

Spring 本来就会映射成 snake_case,为什么还要在字段上加 @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 查询中用它代替字符串字面量,字段改名时出错的就是构建而不是查询。