Füge ein JSON-Beispiel ein und erhalte Java-Klassen oder records, die Jackson sofort deserialisieren kann. Verschachtelte Objekte werden zu weiteren Klassen in derselben Datei, Arrays zu List<T>.
Verwende es für DTOs, die du in Spring Boot sonst von Hand tippen würdest: Response-Typen für RestTemplate, WebClient oder Feign-Clients oder Request-Bodies für Drittanbieter-APIs. Ab Java 16 kannst du records ausgeben, und nutzt deine Codebasis bereits Lombok, hält die Lombok-Option die Ausgabe im selben Stil.
Typname ein. Nur die erste Klasse ist public, passe ihn also an den Dateinamen an.Stil zwischen class (mit Gettern/Settern) und record.class setzt du den Haken bei Lombok, um Getter/Setter durch @Data, @NoArgsConstructor und @AllArgsConstructor zu ersetzen..java-Datei ein und ergänze deine Package-Deklaration.{
"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;
}
}
snake_case-Keys wie full_name werden über @JsonProperty auf ein Feld fullName abgebildet. private ist ein Java-Schlüsselwort, daher wurde das Feld zu private_, während seine Accessoren getPrivate()/setPrivate() bleiben, und das Objekt owner wurde in eine Klasse Owner in derselben Datei ausgelagert.
class mit Gettern/Settern oder ein unveränderliches record.@Data, @NoArgsConstructor, @AllArgsConstructor samt Imports und lässt den Accessor-Code weg.@JsonProperty wird nur dort ergänzt, wo der Feldname vom JSON-Key abweicht, zusammen mit seinem Import.Integer, Long, Double, Boolean), sodass JSON-null ohne Zusatzaufwand passt.Long; Werte mit gemischten Typen werden zu Object.class oder default, bekommen ein angehängtes _; Keys, die mit einer Ziffer beginnen, bekommen das Präfix n.// Root: List<RootItem> plus die Elementklasse.Füge die Beispielantwort aus der Doku einer Zahlungs-, Karten- oder Messaging-API ein und übergib die erzeugte Klasse an restTemplate.getForObject(url, PaymentResponse.class). Je tiefer die Verschachtelung, desto mehr Felder, die du beim Schreiben von Hand übersehen könntest, bleiben dir erhalten.
Für Antworten, die du nur liest, ist ein record kürzer und hat keine Setter; Jackson ab 2.12 deserialisiert über den kanonischen Konstruktor des Records.
In einem Legacy-Projekt, in dem nur Fixture-JSON-Dateien existieren, gibst du ein Fixture ein, siehst die Feldstruktur und bekommst einen ersten DTO-Entwurf.
null im Wrapper-Typ an; nichts markiert es als optional. Ergänze selbst @NotNull o. Ä., wenn du Pflichtwerte validierst.@JsonIgnoreProperties(ignoreUnknown = true) oder das Deaktivieren von FAIL_ON_UNKNOWN_PROPERTIES in Betracht.String heraus. Um sie auf LocalDateTime oder OffsetDateTime abzubilden, brauchst du das Modul jackson-datatype-jsr310.record verschwindet die Lombok-Checkbox, da Records sie nicht brauchen.public. Teile sie in eigene Dateien auf, wenn andere Packages sie brauchen.getXxx und nicht isXxx?Der Feldtyp ist der Wrapper Boolean, nicht das primitive boolean. Jackson erkennt isXxx-Accessoren seit jeher nur für primitives boolean, daher wird getXxx verwendet, damit die Property in jeder Jackson-Version gleich gebunden wird.
record-Ausgabe @JsonProperty?Ja, umbenannte Komponenten werden als @JsonProperty("full_name") String fullName geschrieben. Jackson ab 2.12 befüllt sie über den kanonischen Konstruktor.
spring.jackson.property-naming-strategy=SNAKE_CASE setze?Mit einer globalen SNAKE_CASE-Strategie wird full_name ↔ fullName ohne Annotationen abgebildet. Wegen Schlüsselwörtern geänderte Namen wie private_ deckt die Strategie nicht ab, behalte diese Annotationen also.
Gson ignoriert @JsonProperty. Ersetze es in der Klassenausgabe durch @SerializedName, dann funktioniert dieselbe Struktur mit Gson; Records werden ab Gson 2.10 unterstützt.