将 JSON 转换为 Java class!

输入 JSON,即可生成包含嵌套对象的 Java class 代码!支持 Jackson @JsonProperty, Lombok。Spring Boot JPA @Entity · MongoDB @Document 请在上方标签中选择。
JSON
结果
 

将 JSON 转换为 Java class!

粘贴一份 JSON 示例,就能得到 Jackson 可以直接反序列化的 Java 类或 record。嵌套对象会成为同一文件中的额外类,数组变成 List<T>。

可以用它生成 Spring Boot 中原本要手写的 DTO:RestTemplate、WebClient 或 Feign 客户端的响应类型,或第三方 API 的请求体。在 Java 16+ 上可以输出 record;如果代码库已经在用 Lombok,Lombok 选项能让输出保持同样的风格。

使用方法

  1. 把 API 响应 JSON 粘贴到输入框中。
  2. 在 类型名 中输入 DTO 的名称。只有第一个类是 public,所以请与文件名保持一致。
  3. 在 风格 中选择 class(带 getter/setter)或 record。
  4. 选择 class 时,勾选 Lombok 会用 @Data、@NoArgsConstructor 和 @AllArgsConstructor 替代 getter/setter。
  5. 把结果粘贴到 .java 文件中,并加上你的 package 声明。

示例

输入 (JSON)
{
  "id": 1296269,
  "full_name": "octocat/Hello-World",
  "private": false,
  "stargazers_count": 80,
  "owner": { "login": "octocat", "site_admin": false },
  "topics": ["api", "demo"]
}
输出 (Java · class)
import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;

public class Repository {
    private Integer id;
    @JsonProperty("full_name") private String fullName;
    @JsonProperty("private") private Boolean private_;
    @JsonProperty("stargazers_count") private Integer stargazersCount;
    private Owner owner;
    private List<String> topics;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getFullName() {
        return fullName;
    }

    public void setFullName(String fullName) {
        this.fullName = fullName;
    }

    public Boolean getPrivate() {
        return private_;
    }

    public void setPrivate(Boolean private_) {
        this.private_ = private_;
    }

    public Integer getStargazersCount() {
        return stargazersCount;
    }

    public void setStargazersCount(Integer stargazersCount) {
        this.stargazersCount = stargazersCount;
    }

    public Owner getOwner() {
        return owner;
    }

    public void setOwner(Owner owner) {
        this.owner = owner;
    }

    public List<String> getTopics() {
        return topics;
    }

    public void setTopics(List<String> topics) {
        this.topics = topics;
    }
}

class Owner {
    private String login;
    @JsonProperty("site_admin") private Boolean siteAdmin;

    public String getLogin() {
        return login;
    }

    public void setLogin(String login) {
        this.login = login;
    }

    public Boolean getSiteAdmin() {
        return siteAdmin;
    }

    public void setSiteAdmin(Boolean siteAdmin) {
        this.siteAdmin = siteAdmin;
    }
}

full_name 这样的 snake_case key 通过 @JsonProperty 映射到 fullName 字段。private 是 Java 关键字,所以字段变成了 private_,而访问器仍是 getPrivate()/setPrivate();owner 对象被拆分成同一文件中的 Owner 类。

支持的功能

  • 两种输出风格:带 getter/setter 的普通 class,或不可变的 record。
  • Lombok 选项(仅限 class 风格):添加 @Data、@NoArgsConstructor、@AllArgsConstructor 及相应 import,并去掉访问器代码。
  • 只有字段名与 JSON key 不同时才会添加 @JsonProperty 及其 import。
  • 每个字段都使用包装类型(Integer、Long、Double、Boolean),因此 JSON 的 null 无需额外处理就能装下。
  • 超出 32 位范围的整数变成 Long;类型混杂的值变成 Object。
  • class、default 这样的关键字 key 会加上后缀 _;以数字开头的 key 会加上 n 前缀。
  • Java 没有类型别名,所以顶层为数组时会生成 // Root: List<RootItem> 注释和元素类。

使用场景

Spring Boot 中第三方 API 的 DTO

粘贴支付、地图或消息 API 文档中的示例响应,再把生成的类传给 restTemplate.getForObject(url, PaymentResponse.class)。嵌套越深,相比手写就越不容易漏掉字段。

用 record 表示只读的响应模型

对于只读取的响应,record 更简短,也没有 setter;Jackson 2.12+ 会通过 record 的规范构造函数进行反序列化。

从测试 fixture 还原模型

在只剩 fixture JSON 文件的遗留项目中,把 fixture 放进来就能看到字段布局,得到 DTO 的初稿。

注意事项与限制

  • 在部分元素中缺失的字段只是以 null 出现在包装类型中,不会被标记为可选。如果要校验必填值,请自行添加 @NotNull 等注解。
  • 默认设置下,Jackson 遇到未知 key 会抛出异常。如果 API 可能新增字段,请考虑使用 @JsonIgnoreProperties(ignoreUnknown = true) 或关闭 FAIL_ON_UNKNOWN_PROPERTIES。
  • 日期字符串输出为 String。要映射到 LocalDateTime 或 OffsetDateTime,需要 jackson-datatype-jsr310 模块。
  • 选择 record 时会隐藏 Lombok 复选框,因为 record 不需要它。
  • 嵌套类是同一文件中的包级私有类,而不是 public。如果其他包需要使用,请拆分到单独的文件中。

常见问题

为什么布尔字段的 getter 是 getXxx 而不是 isXxx?

字段类型是包装类 Boolean,而不是基本类型 boolean。Jackson 长期以来只对基本类型 boolean 识别 isXxx 访问器,所以使用 getXxx,让属性在任何 Jackson 版本中都以相同方式绑定。

record 输出会保留 @JsonProperty 吗?

会,改名的组件会写成 @JsonProperty("full_name") String fullName。Jackson 2.12 或更高版本会通过规范构造函数填充它们。

设置了 spring.jackson.property-naming-strategy=SNAKE_CASE,能删掉注解吗?

使用全局的 SNAKE_CASE 策略时,full_name ↔ fullName 无需注解就能映射。但像 private_ 这样因关键字而改的名称不在策略覆盖范围内,那些注解请保留。

输出能配合 Gson 使用吗?

Gson 会忽略 @JsonProperty。在 class 输出中把它换成 @SerializedName,同样的结构就能用于 Gson;record 从 Gson 2.10 开始支持。