Convertit du JSON en structs Swift conformes à Codable. Les propriétés sont déclarées avec let et renommées en camelCase, et un enum CodingKeys n'est généré que pour les structs où un nom diffère de sa clé JSON.
À utiliser quand une application iOS ou macOS a besoin d'un modèle pour décoder une réponse URLSession avec JSONDecoder, ou quand vous voulez des types correspondant au JSON fictif d'une preview SwiftUI.
Nom du type le nom de la struct de premier niveau (par exemple EpisodePage).import Foundation est inclus.try JSONDecoder().decode(EpisodePage.self, from: data).{
"podcast": "Swift Talk",
"episodes": [
{ "id": 301, "title": "Async Sequences", "duration": 1840, "explicit": false },
{ "id": 302, "title": "Macros", "duration": 2215.5, "explicit": false, "guest_name": "Chris" }
],
"total_count": 2
}import Foundation
struct EpisodePage: Codable {
let podcast: String
let episodes: [Episode]
let totalCount: Int
enum CodingKeys: String, CodingKey {
case podcast
case episodes
case totalCount = "total_count"
}
}
struct Episode: Codable {
let id: Int
let title: String
let duration: Double
let explicit: Bool
let guestName: String?
enum CodingKeys: String, CodingKey {
case id
case title
case duration
case explicit
case guestName = "guest_name"
}
}
Les éléments du tableau episodes deviennent une struct Episode. duration mélange un entier (1840) et un décimal (2215.5) : il est donc Double ; guest_name, présent seulement dans le deuxième épisode, devient guestName: String?. Toute struct comportant un champ renommé reçoit un enum CodingKeys listant toutes ses clés.
Codable ; les propriétés sont des let immuables.enum CodingKeys: String, CodingKey est ajouté avec les clés d'origine.String, Int, Double, Bool, et [T] pour les tableaux.null sont des Optionals (String?) : les clés manquantes se décodent quand même.JSONValue généré et décodable.default, class ou self sont entourés de backticks.typealias Root = [RootItem].À partir d'une seule réponse d'exemple, vous obtenez un modèle à décoder dès la ligne qui suit let (data, _) = try await URLSession.shared.data(from: url).
Ajoutez Identifiable à la struct générée (quand elle a un champ id) et passez-la directement à List(page.episodes) { ... }.
Embarquez dans le bundle de l'application le JSON d'exemple de la phase de design et décodez-le avec le même modèle : les écrans peuvent être construits avant que la vraie API soit prête.
String. Pour obtenir Date, changez le type de la propriété et définissez une stratégie comme decoder.dateDecodingStrategy = .iso8601.DecodingError.keyNotFound. Ajoutez ? aux champs que l'API peut omettre, même si votre exemple les contenait toujours.let ; passez en var pour les modèles que vous modifiez en tant qu'état de vue.Identifiable ou Hashable n'est adopté.JSONValue est du code utilitaire pour les types mixtes ; si votre projet a déjà un type équivalent, supprimez-le et utilisez le vôtre.keyDecodingStrategy = .convertFromSnakeCase, puis-je supprimer les CodingKeys ?Oui, le décodeur convertit alors guest_name ↔ guestName pour vous. Ne combinez cependant pas les deux : le décodeur convertit d'abord les clés en camelCase puis les compare à la raw value "guest_name" des CodingKeys, et la correspondance échoue.
Traiter les modèles de réponse comme des types valeur est la convention Swift habituelle, et les structs reçoivent gratuitement un initialiseur memberwise, ce qui facilite la création de données de test. S'il vous faut une sémantique de référence, passez en final class et ajoutez un initialiseur.
Double.Quand une clé contient à la fois des entiers et des décimaux, Double évite de perdre en précision. À l'inverse, si toutes les valeurs d'exemple ressemblent à 4.0, le parseur JSON du navigateur les lit comme des entiers et vous pouvez obtenir Int : vérifiez les vraies valeurs de l'API.
Les CodingKeys servent aussi à l'encodage : JSONEncoder réécrit donc guest_name. Les propriétés optionnelles valant nil sont omises de la sortie.