粘贴一份 JSON 示例,就能得到 Jackson 可以直接反序列化的 Java 类或 record。嵌套对象会成为同一文件中的额外类,数组变成 List<T>。
可以用它生成 Spring Boot 中原本要手写的 DTO:RestTemplate、WebClient 或 Feign 客户端的响应类型,或第三方 API 的请求体。在 Java 16+ 上可以输出 record;如果代码库已经在用 Lombok,Lombok 选项能让输出保持同样的风格。
类型名 中输入 DTO 的名称。只有第一个类是 public,所以请与文件名保持一致。风格 中选择 class(带 getter/setter)或 record。class 时,勾选 Lombok 会用 @Data、@NoArgsConstructor 和 @AllArgsConstructor 替代 getter/setter。.java 文件中,并加上你的 package 声明。{
"id": 1296269,
"full_name": "octocat/Hello-World",
"private": false,
"stargazers_count": 80,
"owner": { "login": "octocat", "site_admin": false },
"topics": ["api", "demo"]
}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 类。
class,或不可变的 record。@Data、@NoArgsConstructor、@AllArgsConstructor 及相应 import,并去掉访问器代码。@JsonProperty 及其 import。Integer、Long、Double、Boolean),因此 JSON 的 null 无需额外处理就能装下。Long;类型混杂的值变成 Object。class、default 这样的关键字 key 会加上后缀 _;以数字开头的 key 会加上 n 前缀。// Root: List<RootItem> 注释和元素类。粘贴支付、地图或消息 API 文档中的示例响应,再把生成的类传给 restTemplate.getForObject(url, PaymentResponse.class)。嵌套越深,相比手写就越不容易漏掉字段。
对于只读取的响应,record 更简短,也没有 setter;Jackson 2.12+ 会通过 record 的规范构造函数进行反序列化。
在只剩 fixture JSON 文件的遗留项目中,把 fixture 放进来就能看到字段布局,得到 DTO 的初稿。
null 出现在包装类型中,不会被标记为可选。如果要校验必填值,请自行添加 @NotNull 等注解。@JsonIgnoreProperties(ignoreUnknown = true) 或关闭 FAIL_ON_UNKNOWN_PROPERTIES。String。要映射到 LocalDateTime 或 OffsetDateTime,需要 jackson-datatype-jsr310 模块。record 时会隐藏 Lombok 复选框,因为 record 不需要它。public。如果其他包需要使用,请拆分到单独的文件中。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 会忽略 @JsonProperty。在 class 输出中把它换成 @SerializedName,同样的结构就能用于 Gson;record 从 Gson 2.10 开始支持。