JSON zu Swift Konverter — Codable-Typen generieren

Swift-Codable-Modelle aus JSON

Swifts Protokoll Codable macht JSON-Dekodierung zu einer einzigen Zeile – sobald Sie Typen haben, die exakt zur Payload passen. Dieser JSON-zu-Swift-Konverter erzeugt diese Typen aus einem Beispiel. Jedes Objekt wird zu einem struct (oder einer class), das Codable erfüllt, Schlüssel werden zu camelCase-Eigenschaften, verschachtelte Objekte werden zu eigenen Typen, Arrays zu typisierten Swift-Arrays, und Werte, die in einem Teil des Beispiels fehlen oder null sind, werden zu Optionals. Explizite CodingKeys-Enums ordnen jede Eigenschaft dem ursprünglichen JSON-Schlüssel zu, sodass snake_case-APIs ohne eigene Strategie dekodiert werden.

Die Engine dahinter ist quicktype, das alle Elemente jedes Arrays zusammenführt, bevor es Typen ableitet. Ein Feld, das nur in einigen Einträgen vorkommt, wird dennoch zu einer optionalen Eigenschaft – das erspart den gefürchteten Dekodierfehler keyNotFound zur Laufzeit.

Structs, Klassen und Hilfsfunktionen

Structs sind der Standard, weil Werttypen für Modelle in SwiftUI und im meisten modernen iOS- und macOS-Code idiomatisch sind. Wechseln Sie zu Klassen, wenn Sie Referenzsemantik oder Objective-C-Interoperabilität benötigen. Standardmäßig enthält die Ausgabe zudem praktische Helfer – Initialisierer aus JSON-Daten und Strings, die Methoden jsonData() und jsonString() sowie einen with(...)-Mutator –, die die Modelle in Tests und Previews leicht nutzbar machen. Aktivieren Sie Types only, wenn Sie eine minimale Datei nur mit den Codable-Deklarationen bevorzugen.

Tipps vor dem Einfügen in Xcode

Verwenden Sie ein reichhaltiges Beispiel mit mehreren Array-Elementen und ausgefüllten optionalen Feldern. Benennen Sie den Root-Typ von Root in etwas Sinnvolles wie FeedResponse um; der Download übernimmt diesen Namen. Erwägen Sie danach, String-Felder mit bekannten Werten in Enums umzuwandeln, Date mit passender dateDecodingStrategy zu verwenden und Eigenschaften als var zu markieren, wo Sie Mutation brauchen. Alles geschieht lokal in Ihrem Browser, sodass private API-Antworten nie hochgeladen werden.