JSON till Swift — Generera Codable-typer

Swift Codable-modeller från JSON

Swifts Codable-protokoll gör JSON-avkodning till en enda rad — när du väl har typer som matchar payloaden exakt. Den här JSON till Swift-konverteraren genererar de typerna från ett exempel. Varje objekt blir en struct (eller class) som implementerar Codable, nycklar blir camelCase-egenskaper, nästlade objekt blir egna typer, arrayer blir typade Swift-arrayer och värden som saknas eller är null i någon del av exemplet blir optionals. Explicita CodingKeys-enums kopplar varje egenskap tillbaka till den ursprungliga JSON-nyckeln, så att API:er med snake_case avkodas utan någon egen strategi.

Motorn bakom är quicktype, som slår ihop alla element i varje array innan typerna infereras. Ett fält som bara finns i vissa objekt blir ändå en optional egenskap, vilket undviker det fruktade avkodningsfelet keyNotFound vid körning.

Structs, klasser och hjälpfunktioner

Structs är standard eftersom värdetyper är idiomatiska för modeller i SwiftUI och i det mesta av modern iOS- och macOS-kod. Byt till klasser när du behöver referenssemantik eller Objective-C-interop. Som standard innehåller resultatet också bekvämlighetshjälpare — initialiserare från JSON-data och strängar, metoderna jsonData() och jsonString() samt en with(...)-mutator — som gör modellerna lätta att använda i tester och förhandsvisningar. Markera Types only om du föredrar en minimal fil med enbart Codable-deklarationerna.

Tips innan du klistrar in i Xcode

Använd ett rikt exempel med flera arrayelement och ifyllda valfria fält. Byt namn på rottypen från Root till något meningsfullt som FeedResponse; nedladdningen använder det namnet. Överväg därefter att göra om strängfält med kända värden till enums, använda Date med en matchande dateDecodingStrategy och markera egenskaper som var där du behöver ändra dem. Allt sker lokalt i din webbläsare, så privata API-svar laddas aldrig upp.