Startseite › Entwickler-Tools › JSON in Swift-Struct

JSON in Swift-Struct

Füge ein JSON-Objekt oder eine API-Antwort ein und erhalte sofort einsetzbare Swift-Codable-Structs mit Eigenschaften in camelCase, CodingKeys, Optionals und verschachtelten Typen. Alles läuft in deinem Browser.

Zuletzt aktualisiert:

Dein JSON wird lokal in diesem Tab verarbeitet und nie hochgeladen. Tipp: Strg + Eingabe erzeugt den Code.

Anzeige
Anzeige

Anleitung: JSON in Swift-Struct

  1. Füge dein JSON in das linke Feld ein oder öffne eine .json-Datei. Ein Beispiel ist geladen, damit du die Ausgabe sofort siehst.
  2. Benenne das Root-Struct, zum Beispiel User oder APIResponse.
  3. Wähle, wie Eigenschaftsnamen gebildet werden: camelCase mit CodingKeys, Namen für .convertFromSnakeCase oder die JSON-Schlüssel unverändert.
  4. Lege Optionals, Protokolle und Stil fest: Codable oder Decodable, let oder var, Zugriff public, verschachtelte Typen, Date-Parsing.
  5. Klicke auf Swift-Structs erzeugen, kopiere dann den Code oder lade die .swift-Datei herunter und dekodiere mit JSONDecoder.

Beispiel: JSON in Swift-Codable-Structs

Diese API-Antwort hat snake_case-Schlüssel, ein Datum, ein verschachteltes Array von Objekten und ein Feld, das in einem Element fehlt:

{ "user_id": 42, "display_name": "Ada", "joined_at": "2024-05-01T09:30:00Z",
  "posts": [ { "id": 1, "title": "Hello", "score": 4.5 },
             { "id": 2, "title": "Draft", "score": 3, "cover_url": "a.png" } ] }

Mit den Standardoptionen erzeugt der Generator:

struct Root: Codable {
    let userID: Int
    let displayName: String
    let joinedAt: Date
    let posts: [Post]

    enum CodingKeys: String, CodingKey {
        case userID = "user_id"
        case displayName = "display_name"
        case joinedAt = "joined_at"
        case posts
    }
}

struct Post: Codable {
    let id: Int
    let title: String
    let score: Double
    let coverURL: String?

    enum CodingKeys: String, CodingKey {
        case id, title, score
        case coverURL = "cover_url"
    }
}

let decoder = JSONDecoder()
decoder.dateDecodingStrategy = .iso8601
let root = try decoder.decode(Root.self, from: jsonData)

coverURL ist optional, weil nur ein Beitrag es hat, und score ist Double, weil ein Wert 4.5 ist.

Wie JSON-Werte auf Swift-Typen abgebildet werden

JSON-WertSwift-Typ
"Text"String
"2024-05-01T09:30:00Z"Date (mit .iso8601, wenn die Option aktiv ist)
42Int
3.14, 1e6Double
true / falseBool
"x" oder null oder ein fehlender SchlüsselString?
{ … }Ein verschachteltes struct
{}[String: JSONValue]
[1, 2] / [][Int] / [JSONValue]
[1, "two"] oder immer nullJSONValue

CodingKeys oder convertFromSnakeCase?

Beide Ansätze dekodieren dasselbe snake_case-JSON. Explizite CodingKeys halten die Zuordnung im Typ sichtbar, erlauben Swift-Initialismen wie userID und coverURL und funktionieren unabhängig davon, wie der Decoder konfiguriert ist. .convertFromSnakeCase hält die Structs kürzer, aber die Eigenschaftsnamen müssen exakt zu seiner Umwandlung passen (user_id wird zu userId), und jeder Decoder, der den Typ liest, muss die Strategie setzen. Wähle oben die passende Option, und der Generator benennt die Eigenschaften für dich.

  • Unbekannte Schlüssel ignoriert JSONDecoder, du kannst also Eigenschaften löschen, die du nicht brauchst.
  • Ein fehlender nicht optionaler Schlüssel wirft DecodingError.keyNotFound; mach die Eigenschaft optional, wenn die API sie manchmal weglässt.
  • Identifiable: Structs mit einer Eigenschaft id können Identifiable für SwiftUI-Listen übernehmen, indem du es zur Protokollliste hinzufügst.

Häufige Fragen

Wann fügt der Generator ein CodingKeys-Enum hinzu?

Das synthetisierte Codable von Swift ordnet Eigenschaftsnamen exakt den JSON-Schlüsseln zu. Weicht ein Eigenschaftsname von seinem Schlüssel ab (zum Beispiel userName für user_name), braucht das Struct ein CodingKeys-Enum, das jede Eigenschaft ihrem Schlüssel zuordnet. Der Generator fügt CodingKeys nur zu Structs hinzu, die es brauchen, und listet alle Eigenschaften dieses Structs auf, weil ein CodingKeys-Enum jede gespeicherte Eigenschaft abdecken muss, die dekodiert wird.

Was macht die Option convertFromSnakeCase?

JSONDecoder kann snake_case-Schlüssel mit decoder.keyDecodingStrategy = .convertFromSnakeCase selbst umwandeln. Dabei werden Unterstriche entfernt, das erste Wort kleingeschrieben und die folgenden Wörter großgeschrieben, sodass aus avatar_url avatarUrl wird (nicht avatarURL). Dieser Modus benennt Eigenschaften genau so, wie diese Strategie sie erzeugt, sodass keine CodingKeys nötig sind, außer bei Schlüsseln mit Zeichen wie Bindestrichen.

Welche Eigenschaften werden Optionals?

Standardmäßig ist eine Eigenschaft optional (String?), wenn ihr Wert irgendwo im JSON null ist oder der Schlüssel bei manchen Elementen eines Arrays fehlt. Synthetisiertes Codable dekodiert Optionals mit decodeIfPresent, sodass ein fehlender Schlüssel oder null zu nil wird, statt einen Fehler zu werfen. Du kannst auch alle Eigenschaften optional machen, was bei APIs, die du nicht kontrollierst, am sichersten ist.

Wie werden Datumsangaben behandelt?

Strings im ISO-8601-Format für Internet-Datum und -Uhrzeit, etwa 2024-05-01T09:30:00Z, werden bei aktivierter Option zu Date. Setze decoder.dateDecodingStrategy = .iso8601, damit JSONDecoder sie lesen kann. Diese Strategie akzeptiert keine Sekundenbruchteile, daher bleiben Zeitstempel wie 2024-05-01T09:30:00.123Z ein String; schalte die Option aus, um alle Datumsangaben als Strings zu behalten.

Was ist das Enum JSONValue?

Swift hat kein Codable-Gegenstück zu Any, daher verwendet ein Feld, dessen Typ sich nicht bestimmen lässt (immer null, gemischte Strings und Zahlen oder ein leeres Objekt), ein kleines Enum JSONValue, das am Ende des Codes erzeugt wird. Es dekodiert jeden JSON-Wert in Cases wie .string, .number, .bool, .array, .object und .null und kodiert ihn wieder zurück.

Wie werden Zahlen typisiert?

Ganze Zahlen werden zu Int, das auf allen aktuellen Apple-Plattformen 64 Bit hat, und Zahlen mit Dezimalpunkt oder Exponent zu Double. Mischt ein Feld ganze und Dezimalzahlen, wird Double verwendet.

Wird mein JSON hochgeladen?

Nein. Parsen und Codeerzeugung sind reines JavaScript auf dieser Seite, sodass API-Antworten mit persönlichen oder geheimen Daten nie dein Gerät verlassen.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Daten- & Dateiformat-Konverter ansehen →