Convertir JSON en Swift — Générateur Codable

Des modèles Swift Codable à partir de JSON

Le protocole Codable de Swift réduit le décodage JSON à une seule ligne — une fois que vous disposez de types qui correspondent exactement à la charge utile. Ce convertisseur JSON vers Swift génère ces types à partir d'un exemple. Chaque objet devient une struct (ou une class) conforme à Codable, les clés deviennent des propriétés en camelCase, les objets imbriqués deviennent leurs propres types, les tableaux deviennent des tableaux Swift typés, et les valeurs absentes ou nulles dans une partie de l'exemple deviennent des optionnels. Des énumérations CodingKeys explicites relient chaque propriété à la clé JSON d'origine, si bien que les API en snake_case se décodent sans stratégie personnalisée.

Le moteur sous-jacent est quicktype, qui fusionne tous les éléments de chaque tableau avant d'inférer les types. Un champ présent dans certains éléments seulement devient tout de même une propriété optionnelle, ce qui évite la redoutable erreur de décodage keyNotFound à l'exécution.

Structs, classes et utilitaires

Les structs sont le choix par défaut, car les types valeur sont idiomatiques pour les modèles dans SwiftUI et dans la plupart du code iOS et macOS moderne. Passez aux classes lorsque vous avez besoin de la sémantique de référence ou de l'interopérabilité avec Objective-C. Par défaut, la sortie contient aussi des utilitaires pratiques — des initialiseurs à partir de données et de chaînes JSON, les méthodes jsonData() et jsonString(), ainsi qu'un mutateur with(...) — qui rendent les modèles faciles à utiliser dans les tests et les aperçus. Cochez Types only si vous préférez un fichier minimal ne contenant que les déclarations Codable.

Conseils avant de coller dans Xcode

Utilisez un exemple riche, avec plusieurs éléments de tableau et des champs optionnels renseignés. Renommez le type racine de Root en un nom parlant comme FeedResponse ; le téléchargement reprendra ce nom. Envisagez ensuite de transformer les champs de type chaîne à valeurs connues en énumérations, d'utiliser Date avec une dateDecodingStrategy adaptée, et de déclarer les propriétés en var lorsque vous avez besoin de mutation. Tout se passe en local dans votre navigateur : les réponses d'API privées ne sont jamais envoyées.