JSON in Java-class umwandeln!

Gib JSON ein, um Java-class-Code inklusive verschachtelter Objekte zu erzeugen! Unterstützt Jackson @JsonProperty, Lombok. Spring Boot JPA @Entity · MongoDB @Document: in den Tabs oben.
JSON
Ergebnis
 

JSON in Java-class umwandeln!

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.

So funktioniert es

  1. Füge das JSON der API-Antwort in das Eingabefeld ein.
  2. Gib den DTO-Namen in Typname ein. Nur die erste Klasse ist public, passe ihn also an den Dateinamen an.
  3. Wähle unter Stil zwischen class (mit Gettern/Settern) und record.
  4. Bei class setzt du den Haken bei Lombok, um Getter/Setter durch @Data, @NoArgsConstructor und @AllArgsConstructor zu ersetzen.
  5. Füge das Ergebnis in eine .java-Datei ein und ergänze deine Package-Deklaration.

Beispiel

Eingabe (JSON)
{
  "id": 1296269,
  "full_name": "octocat/Hello-World",
  "private": false,
  "stargazers_count": 80,
  "owner": { "login": "octocat", "site_admin": false },
  "topics": ["api", "demo"]
}
Ausgabe (Java · class)
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.

Unterstützte Funktionen

  • Zwei Ausgabestile: eine normale class mit Gettern/Settern oder ein unveränderliches record.
  • Lombok-Option (nur im Klassenstil): ergänzt @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.
  • Jedes Feld verwendet einen Wrapper-Typ (Integer, Long, Double, Boolean), sodass JSON-null ohne Zusatzaufwand passt.
  • Ganzzahlen außerhalb des 32-Bit-Bereichs werden zu Long; Werte mit gemischten Typen werden zu Object.
  • Keys, die Schlüsselwörter sind, wie class oder default, bekommen ein angehängtes _; Keys, die mit einer Ziffer beginnen, bekommen das Präfix n.
  • Java kennt keine Typ-Aliase, daher erzeugt ein Array auf oberster Ebene einen Kommentar // Root: List<RootItem> plus die Elementklasse.

Anwendungsfälle

DTOs für Drittanbieter-APIs in Spring Boot

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.

Schreibgeschützte Response-Modelle als Records

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.

Ein Modell aus Test-Fixtures zurückgewinnen

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.

Hinweise und Einschränkungen

  • Ein Feld, das in manchen Elementen fehlt, kommt einfach als null im Wrapper-Typ an; nichts markiert es als optional. Ergänze selbst @NotNull o. Ä., wenn du Pflichtwerte validierst.
  • Mit Standardeinstellungen wirft Jackson bei unbekannten Keys einen Fehler. Kann die API Felder hinzufügen, zieh @JsonIgnoreProperties(ignoreUnknown = true) oder das Deaktivieren von FAIL_ON_UNKNOWN_PROPERTIES in Betracht.
  • Datums-Strings kommen als String heraus. Um sie auf LocalDateTime oder OffsetDateTime abzubilden, brauchst du das Modul jackson-datatype-jsr310.
  • Bei Auswahl von record verschwindet die Lombok-Checkbox, da Records sie nicht brauchen.
  • Verschachtelte Klassen sind package-private Klassen in derselben Datei, nicht public. Teile sie in eigene Dateien auf, wenn andere Packages sie brauchen.

Häufige Fragen

Warum heißt der Getter eines Boolean-Feldes 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.

Behält die 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.

Kann ich die Annotationen löschen, wenn ich 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.

Kann ich die Ausgabe mit Gson verwenden?

Gson ignoriert @JsonProperty. Ersetze es in der Klassenausgabe durch @SerializedName, dann funktioniert dieselbe Struktur mit Gson; Records werden ab Gson 2.10 unterstützt.