Tampal kelas @Entity JPA Spring Boot dan lihat contoh JSON dalam bentuk yang dihasilkan oleh Jackson apabila controller memulangkan entity tersebut. Nama medan, @JsonIgnore dan @JsonProperty, medan yang diwarisi daripada @MappedSuperclass, serta jenis tarikh Java 8 semuanya dikendalikan mengikut tetapan Jackson lalai Spring Boot.
Gunakannya untuk contoh REST Docs atau Swagger, body request Postman, atau untuk mengaudit medan yang terbocor apabila entity didedahkan tanpa DTO.
JPA. Import dan anotasi Lombok boleh dibiarkan; sertakan kelas induk, entity berkaitan dan enum supaya nilainya diisi.public yang dipilih.@MappedSuperclass
public abstract class BaseEntity {
@Id @GeneratedValue
private Long id;
private LocalDateTime createdAt;
}
@Entity
public class Appointment extends BaseEntity {
private LocalDate visitDate;
private BigDecimal fee;
@Enumerated(EnumType.STRING)
private Status status;
@ManyToOne(fetch = FetchType.LAZY)
private Patient patient;
public enum Status { BOOKED, DONE, CANCELED }
}
@Entity
class Patient extends BaseEntity {
private String name;
@JsonIgnore
private String residentNumber;
@OneToMany(mappedBy = "patient")
private List<Appointment> appointments;
}{
"id": 0,
"createdAt": "1970-01-01T00:00:00",
"visitDate": "1970-01-01",
"fee": 0,
"status": "BOOKED",
"patient": {
"id": 0,
"createdAt": "1970-01-01T00:00:00",
"name": "",
"appointments": []
}
}Appointment dan Patient saling merujuk, jadi kelas public Appointment ialah akar dan Patient.appointments dipotong menjadi array kosong dan bukannya berulang tanpa henti. id dan createdAt daripada BaseEntity diletakkan dahulu, dan residentNumber hilang kerana @JsonIgnore. LocalDateTime ialah rentetan ISO tanpa offset, dan enum menunjukkan pemalar pertamanya, "BOOKED".
static dan transient serta medan @JsonIgnore dilangkau, begitu juga nama yang disenaraikan dalam @JsonIgnoreProperties({"..."}) di peringkat kelas.@JsonProperty("doctor_name") menamakan semula kunci JSON.@MappedSuperclass atau sebarang extends) ada dalam input, medannya diletakkan dahulu.private Status status = Status.ACTIVE; atau private int visits = 0; dipaparkan sebagai nilai tersebut, dan getter terkira tanpa medan sandaran (public int getAge()) muncul sebagai kunci tambahan, sama seperti yang dikeluarkan oleh Jackson.LocalDate → 1970-01-01, LocalDateTime → 1970-01-01T00:00:00, java.util.Date → 1970-01-01T00:00:00.000+00:00.BigDecimal dan Long memberikan 0, UUID memberikan UUID serba sifar, dan byte[] memberikan rentetan base64 "AA==".List/Set memberikan array satu elemen, Map<Long, String> memberikan objek dengan kunci yang sepadan ({"0": ""}), dan Optional<T> dibuka kepada nilai dalamannya.@OneToMany dengan @ManyToOne) dipotong dengan null atau array kosong di tempat ia berpusing kembali.Jana JSON untuk @Schema(example = ...) atau snippet dokumentasi terus daripada entity, dan tampal semula setiap kali medan berubah supaya dokumentasi kekal selari.
Jika anda memulangkan entity tanpa DTO, semak sama ada medan seperti kata laluan atau nombor kad pengenalan masuk ke dalam respons. Medan dalam output ialah medan yang akan diserialkan oleh Jackson.
Gunakan output sebagai rangka untuk mockMvc.perform(post("/appointments").content(...)), buang id dan timestamp yang dijana sebelum mengisi nilai.
StackOverflowError) pada association dua hala. Jika output kelihatan terpotong, itu petanda untuk menggunakan @JsonManagedReference/@JsonBackReference, @JsonIgnore atau DTO.@Transient tidak diabaikan oleh Jackson secara lalai, jadi medan sedemikian kekal dalam output; hanya medan dengan kata kunci Java transient yang dibuang.FetchType.LAZY boleh gagal diserialkan sebagai proxy Hibernate dalam praktik; output menganggap semuanya telah dimuatkan.null, dan kekangan @Column seperti nullable atau length tidak diterapkan.[2024,1,1]?Spring Boot mematikan WRITE_DATES_AS_TIMESTAMPS, jadi LocalDateTime ditulis sebagai rentetan ISO. ObjectMapper yang dibina sendiri dengan hanya JavaTimeModule didaftarkan mungkin menulis array sebaliknya.
@Getter Lombok?Alat ini berfungsi berdasarkan pengisytiharan medan. Jackson sebenar menserialkan melalui getter (atau medan public) secara lalai, jadi medan private tanpa getter mungkin tiada dalam respons sebenar.
@Document MongoDB juga?Ia mengikut peraturan Jackson yang sama, tetapi perkara khusus MongoDB seperti ObjectId dan @Field diterangkan di halaman Spring Data MongoDB ke JSON.