Masukkan source DTO, POJO, atau record Java dan dapatkan JSON yang kemungkinan besar dihasilkan oleh setup Jackson default Spring Boot. Key diambil dari field yang dideklarasikan, dengan @JsonProperty, @JsonIgnore, @JsonIgnoreProperties serta pengecualian static/transient diterapkan.
Gunakan untuk membuat contoh Swagger atau payload contoh bagi frontend dari DTO request atau respons sebuah controller, atau sekadar untuk memeriksa key apa saja yang akan dikeluarkan class Lombok @Data.
static class, record dan enum bersarang di input yang sama agar field yang mereferensikannya terisi sesuai strukturnya.Tipe akar diatur ke Otomatis, class yang tidak dipakai class lain sebagai tipe field yang dipilih. Ketika entity saling mereferensikan, pilih yang Anda inginkan dari daftar.@Schema(example = ...), snippet REST Docs, atau body request MockMvc.@Data
@JsonIgnoreProperties({"password"})
public class MemberResponse {
private Long memberId;
@JsonProperty("nick_name")
private String nickname;
private String password;
private Grade grade = Grade.SILVER;
private LocalDate birthDate;
private List<Address> addresses;
private static final long serialVersionUID = 1L;
public enum Grade { BRONZE, SILVER, GOLD }
public record Address(String zipCode, String city, boolean primary) {}
}{
"memberId": 0,
"nick_name": "",
"grade": "SILVER",
"birthDate": "1970-01-01",
"addresses": [
{
"zipCode": "",
"city": "",
"primary": false
}
]
}password dihapus oleh @JsonIgnoreProperties({"password"}) di level class, dan serialVersionUID yang static final tidak pernah muncul. Initializer Grade.SILVER dibaca, jadi grade bernilai "SILVER", bukan konstanta pertama enum. record Address yang bersarang dijabarkan menjadi array objek.
@JsonProperty("x") atau @JsonProperty(value = "x").@JsonIgnore, key yang tercantum di @JsonIgnoreProperties({...}) level class, serta field static atau transient.record Java 16+, deklarasi static class bersarang, dan field yang diwarisi lewat extends (field parent lebih dulu).@JsonProperty("x") pada sebuah konstanta mengubah string-nya menjadi x.LocalDateTime → 1970-01-01T00:00:00, LocalDate → 1970-01-01, Instant/OffsetDateTime/ZonedDateTime → string ISO yang diakhiri Z, java.util.Date/Timestamp → 1970-01-01T00:00:00.000+00:00.BigDecimal dan Long menjadi 0, Optional<T> dibuka menjadi T, byte[] menjadi string Base64, dan UUID serta ObjectId MongoDB mendapat nilai yang formatnya valid.List, Set dan array mendapat satu elemen contoh; map seperti Map<Long, V> dengan key numerik memakai "0", selain itu "key".Nilai example yang ditulis manual akan melenceng setiap kali field ditambahkan ke DTO. Buat JSON dari source DTO lalu rapikan nilainya dari sana, sehingga tidak ada key yang hilang atau salah eja.
Buat JSON request langsung dari DTO @RequestBody dan tempel ke text block (""") di test Anda. Key yang diganti namanya dengan @JsonProperty sudah diterapkan, sesuai dengan binding sebenarnya.
Developer frontend yang tidak membaca kode backend mendapat struktur JSON endpoint secara langsung, tanpa harus menafsirkan class Java.
= "guest", = 100, = true) atau konstanta enum (= Grade.SILVER); selain itu, seperti new ArrayList<>() atau pemanggilan method, kembali ke placeholder tipe.getFullName() atau boolean isVip(), ditambahkan sebagai properti seperti yang dilakukan Jackson, dengan memperhatikan @JsonIgnore/@JsonProperty pada getter tersebut. Sebaliknya, field private tanpa getter dianggap terlihat (seperti dengan Lombok @Getter/@Data).@JsonNaming(SnakeCaseStrategy.class), spring.jackson.property-naming-strategy) dan pola tanggal @JsonFormat tidak diterapkan.@JsonValue pada enum tidak dievaluasi, jadi enum seperti itu tetap menampilkan konstantanya (atau nama @JsonProperty-nya).Page<T>/Slice<T> Spring Data disederhanakan menjadi array elemen; serialisasi Page yang sebenarnya berupa objek dengan content, pageable dan lainnya.@Data atau @Getter?Ya. Key dibangun dari field yang dideklarasikan, jadi getter dan setter yang dibuat Lombok saat compile tidak perlu ada di source.
LocalDateTime berupa string dan bukan array angka?Spring Boot mendaftarkan jackson-datatype-jsr310 dan menonaktifkan WRITE_DATES_AS_TIMESTAMPS secara default, sehingga menghasilkan string ISO; contoh mengikuti default tersebut. ObjectMapper Jackson polos bisa saja menulis array seperti [1970,1,1,0,0].
Entity memiliki struktur field yang sama, jadi bisa di-parse dengan baik. Asosiasi dua arah seperti @OneToMany akan berputar terus, jadi dijabarkan sekali lalu dipotong dengan null atau array kosong. Ada juga halaman khusus Spring Boot JPA → JSON.
@JsonIgnore ada di setter atau di getter dari field yang sudah ada?Anotasi pada deklarasi field selalu berlaku, dan anotasi pada getter hanya berlaku jika tidak ada field dengan nama itu. @JsonIgnore pada setter, atau pada getter dari field yang dideklarasikan, tidak diterapkan, jadi pindahkan ke field untuk melihat efeknya.