Füge @Entity-Klassen von Spring Boot JPA ein und sieh Beispiel-JSON in der Form, die Jackson erzeugt, wenn ein Controller diese Entities zurückgibt. Feldnamen, @JsonIgnore und @JsonProperty, von einer @MappedSuperclass geerbte Felder und die Datumstypen aus Java 8 werden alle nach dem Standard-Jackson-Setup von Spring Boot behandelt.
Verwende es für Beispiele in REST Docs oder Swagger, für Request-Bodies in Postman oder um zu prüfen, welche Felder nach außen dringen, wenn eine Entity ohne DTO ausgeliefert wird.
JPA ein. Imports und Lombok-Annotationen dürfen bleiben; nimm Elternklassen, verwandte Entities und Enums mit auf, damit ihre Werte befüllt werden.public-Klasse gewählt.@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 und Patient verweisen aufeinander, daher ist die public-Klasse Appointment die Wurzel, und Patient.appointments wird zu einem leeren Array abgeschnitten, statt endlos zu kreisen. id und createdAt aus BaseEntity kommen zuerst, und residentNumber fehlt wegen @JsonIgnore. LocalDateTime ist ein ISO-String ohne Offset, und das Enum zeigt seine erste Konstante, "BOOKED".
static- und transient-Felder sowie @JsonIgnore-Felder werden übersprungen, ebenso Namen, die in einem @JsonIgnoreProperties({"..."}) auf Klassenebene aufgeführt sind.@JsonProperty("doctor_name") benennt den JSON-Key um.@MappedSuperclass oder ein beliebiges extends) in der Eingabe, kommen ihre Felder zuerst.private Status status = Status.ACTIVE; oder private int visits = 0; erscheint als dieser Wert, und berechnete Getter ohne zugehöriges Feld (public int getAge()) tauchen als zusätzliche Keys auf, so wie Jackson sie ausgeben würde.LocalDate → 1970-01-01, LocalDateTime → 1970-01-01T00:00:00, java.util.Date → 1970-01-01T00:00:00.000+00:00.BigDecimal und Long ergeben 0, UUID eine UUID aus lauter Nullen und byte[] den Base64-String "AA==".List/Set ergeben ein Array mit einem Element, Map<Long, String> ein passend geschlüsseltes Objekt ({"0": ""}), und Optional<T> wird zu seinem inneren Wert ausgepackt.@OneToMany mit @ManyToOne) werden dort, wo sie zurückverweisen, mit null oder einem leeren Array abgeschnitten.Erzeuge das JSON für @Schema(example = ...) oder Doku-Snippets direkt aus der Entity und füge sie bei jeder Feldänderung erneut ein, damit die Doku synchron bleibt.
Gibst du Entities ohne DTOs zurück, prüfe, ob Felder wie Passwörter oder Ausweisnummern in Antworten landen. Die Felder in der Ausgabe sind genau die, die Jackson serialisieren würde.
Verwende die Ausgabe als Gerüst für mockMvc.perform(post("/appointments").content(...)) und entferne das erzeugte id und die Timestamps, bevor du Werte einträgst.
StackOverflowError). Sieht die Ausgabe abgeschnitten aus, ist das dein Hinweis auf @JsonManagedReference/@JsonBackReference, @JsonIgnore oder ein DTO.@Transient wird von Jackson standardmäßig nicht ignoriert, solche Felder bleiben also in der Ausgabe; entfernt werden nur Felder mit dem Java-Schlüsselwort transient.FetchType.LAZY-Assoziationen können sich in der Praxis als Hibernate-Proxies nicht serialisieren lassen; die Ausgabe geht davon aus, dass alles geladen ist.null, und @Column-Constraints wie nullable oder length werden nicht angewendet.[2024,1,1]?Spring Boot deaktiviert WRITE_DATES_AS_TIMESTAMPS, daher wird LocalDateTime als ISO-String geschrieben. Ein selbst gebauter ObjectMapper, bei dem nur JavaTimeModule registriert ist, schreibt womöglich stattdessen Arrays.
@Getter?Das Tool arbeitet mit Felddeklarationen. Echtes Jackson serialisiert standardmäßig über Getter (oder öffentliche Felder), private Felder ohne Getter können in echten Antworten also fehlen.
@Document-Klassen einfügen?Sie folgen denselben Jackson-Regeln, MongoDB-spezifische Besonderheiten wie ObjectId und @Field behandelt aber die Seite Spring Data MongoDB zu JSON.