Ubah kelas Java menjadi JSON!

Tempel kode Java (class·record) dan dapatkan contoh JSON! Mendukung Jackson @JsonProperty, @JsonIgnore, Lombok. Berguna untuk dokumentasi API dan body request uji (mock request body).
Java
Hasil
 

Ubah kelas Java menjadi JSON!

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.

Cara menggunakan

  1. Tempel source DTO apa adanya. Import, anotasi Lombok, constructor, dan method boleh tetap ada.
  2. Sertakan deklarasi static class, record dan enum bersarang di input yang sama agar field yang mereferensikannya terisi sesuai strukturnya.
  3. Dengan 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.
  4. Salin output ke @Schema(example = ...), snippet REST Docs, atau body request MockMvc.

Contoh

Input (Java)
@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) {}
}
Output (JSON)
{
  "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.

Fitur yang didukung

  • Nama field menjadi key, dan bisa ditimpa oleh @JsonProperty("x") atau @JsonProperty(value = "x").
  • Dikecualikan: field @JsonIgnore, key yang tercantum di @JsonIgnoreProperties({...}) level class, serta field static atau transient.
  • Mendukung komponen record Java 16+, deklarasi static class bersarang, dan field yang diwarisi lewat extends (field parent lebih dulu).
  • Field enum berisi konstanta pertama sebagai string, atau konstanta yang disebut di initializer field; @JsonProperty("x") pada sebuah konstanta mengubah string-nya menjadi x.
  • Tanggal mengikuti output Jackson default Spring Boot: 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.
  • Wrapper numerik seperti 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".

Kasus penggunaan

Mengisi contoh springdoc / Swagger

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.

Body request untuk test MockMvc atau RestAssured

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.

Berbagi bentuk respons dengan frontend

Developer frontend yang tidak membaca kode backend mendapat struktur JSON endpoint secara langsung, tanpa harus menafsirkan class Java.

Catatan dan batasan

  • Initializer field dipakai jika berupa literal (= "guest", = 100, = true) atau konstanta enum (= Grade.SILVER); selain itu, seperti new ArrayList<>() atau pemanggilan method, kembali ke placeholder tipe.
  • Getter tanpa field yang sesuai, seperti 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).
  • Aturan penamaan global (@JsonNaming(SnakeCaseStrategy.class), spring.jackson.property-naming-strategy) dan pola tanggal @JsonFormat tidak diterapkan.
  • Method @JsonValue pada enum tidak dievaluasi, jadi enum seperti itu tetap menampilkan konstantanya (atau nama @JsonProperty-nya).
  • Field Page<T>/Slice<T> Spring Data disederhanakan menjadi array elemen; serialisasi Page yang sebenarnya berupa objek dengan content, pageable dan lainnya.

FAQ

Apakah tetap berfungsi jika accessor dibuat oleh Lombok @Data atau @Getter?

Ya. Key dibangun dari field yang dideklarasikan, jadi getter dan setter yang dibuat Lombok saat compile tidak perlu ada di source.

Mengapa 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].

Bisakah saya menempel entity JPA?

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.

Bagaimana jika @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.