Tampal sampel JSON dan dapatkan kelas Java atau record yang boleh terus di-deserialize oleh Jackson. Objek bersarang menjadi kelas tambahan dalam fail yang sama, dan array menjadi List<T>.
Gunakannya untuk DTO yang selalunya anda taip sendiri dalam Spring Boot: jenis response bagi klien RestTemplate, WebClient atau Feign, atau body request untuk API pihak ketiga. Pada Java 16+ anda boleh menjana record, dan jika codebase anda sudah menggunakan Lombok, pilihan Lombok mengekalkan output dalam gaya yang sama.
Nama jenis. Hanya kelas pertama yang public, jadi padankan dengan nama fail.class (dengan getter/setter) atau record di bawah Gaya.class, tandakan Lombok untuk menggantikan getter/setter dengan @Data, @NoArgsConstructor dan @AllArgsConstructor..java dan tambah deklarasi package anda.{
"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;
}
}
Kunci snake_case seperti full_name dipetakan kepada field fullName melalui @JsonProperty. private ialah kata kunci Java, jadi field itu menjadi private_ manakala accessor-nya kekal getPrivate()/setPrivate(), dan objek owner dipisahkan menjadi kelas Owner dalam fail yang sama.
class biasa dengan getter/setter, atau record yang immutable.@Data, @NoArgsConstructor, @AllArgsConstructor berserta import dan membuang kod accessor.@JsonProperty hanya ditambah apabila nama field berbeza daripada kunci JSON, bersama import-nya.Integer, Long, Double, Boolean), jadi null JSON boleh diterima tanpa kerja tambahan.Long; nilai berjenis campuran menjadi Object.class atau default diberi _ di hujungnya; kunci yang bermula dengan digit diberi awalan n.// Root: List<RootItem> serta kelas elemennya.Tampal sampel response daripada dokumentasi API pembayaran, peta atau pemesejan dan hantar kelas yang dijana kepada restTemplate.getForObject(url, PaymentResponse.class). Semakin dalam struktur bersarangnya, semakin banyak field yang tidak terlepas berbanding menulisnya sendiri.
Untuk response yang hanya dibaca, record lebih ringkas dan tiada setter; Jackson 2.12+ men-deserialize melalui canonical constructor record tersebut.
Dalam projek legacy yang hanya mempunyai fail JSON fixture, masukkan satu fixture untuk melihat susunan field dan mendapatkan draf pertama DTO.
null dalam jenis wrapper; tiada apa-apa yang menandakannya sebagai opsyenal. Tambah @NotNull atau yang seumpamanya sendiri jika anda mengesahkan nilai wajib.@JsonIgnoreProperties(ignoreUnknown = true) atau mematikan FAIL_ON_UNKNOWN_PROPERTIES.String. Memetakannya kepada LocalDateTime atau OffsetDateTime memerlukan modul jackson-datatype-jsr310.record akan menyembunyikan checkbox Lombok, kerana record tidak memerlukannya.public. Pecahkan ke fail berasingan jika package lain memerlukannya.getXxx dan bukan isXxx?Jenis field ialah wrapper Boolean, bukan boolean primitif. Sejak dahulu Jackson hanya mengenali accessor isXxx untuk boolean primitif, jadi getXxx digunakan supaya property bind dengan cara yang sama pada mana-mana versi Jackson.
record mengekalkan @JsonProperty?Ya, komponen yang dinamakan semula ditulis sebagai @JsonProperty("full_name") String fullName. Jackson 2.12 atau lebih baharu mengisinya melalui canonical constructor.
spring.jackson.property-naming-strategy=SNAKE_CASE, bolehkah saya membuang anotasi?Dengan strategi SNAKE_CASE global, full_name ↔ fullName dipetakan tanpa anotasi. Nama yang diubah kerana kata kunci, seperti private_, tidak diliputi oleh strategi itu, jadi kekalkan anotasi tersebut.
Gson mengabaikan @JsonProperty. Gantikannya dengan @SerializedName dalam output class dan struktur yang sama akan berfungsi dengan Gson; record disokong mulai Gson 2.10.