Convierte JSON en structs de Swift que adoptan Codable. Las propiedades se declaran con let y se renombran a camelCase, y solo se genera un enum CodingKeys en los structs donde algún nombre difiere de su clave JSON.
Úsalo cuando una app de iOS o macOS necesita un modelo para decodificar con JSONDecoder una respuesta de URLSession, o cuando quieres tipos que coincidan con el JSON mock que hay detrás de una preview de SwiftUI.
Nombre del tipo el nombre del struct de nivel superior (por ejemplo EpisodePage).import Foundation ya está incluido.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"
}
}
Los elementos del array episodes pasan a ser un struct Episode. duration mezcla un entero (1840) y un decimal (2215.5), así que es Double; guest_name, que solo aparece en el segundo episodio, es guestName: String?. Cualquier struct con un campo renombrado recibe un enum CodingKeys que lista todas sus claves.
Codable; las propiedades son let inmutables.enum CodingKeys: String, CodingKey con las claves originales.String, Int, Double, Bool y [T] para arrays.null son Optionals (String?), así que las claves ausentes se siguen decodificando.JSONValue generado y decodificable.default, class o self se envuelven entre backticks.typealias Root = [RootItem].A partir de una sola respuesta de ejemplo obtienes un modelo que puedes decodificar en la línea siguiente a let (data, _) = try await URLSession.shared.data(from: url).
Añade Identifiable al struct generado (cuando tenga un campo id) y pásalo directamente a List(page.episodes) { ... }.
Incluye en el bundle de la app el JSON de ejemplo de la fase de diseño y decodifícalo con el mismo modelo, para poder construir las pantallas antes de que la API real esté lista.
String. Para obtener Date, cambia el tipo de la propiedad y configura una estrategia como decoder.dateDecodingStrategy = .iso8601.DecodingError.keyNotFound. Añade ? a los campos que la API puede omitir, aunque tu ejemplo siempre los tuviera.let; cámbialas a var en los modelos que modifiques como estado de la vista.Identifiable o Hashable.JSONValue es código auxiliar para tipos mixtos; si tu proyecto ya tiene un tipo equivalente, bórralo y usa el tuyo.keyDecodingStrategy = .convertFromSnakeCase, ¿puedo borrar los CodingKeys?Sí, en ese caso el decoder convierte guest_name ↔ guestName por ti. Pero no combines ambas cosas: el decoder convierte primero las claves a camelCase y luego las compara con el raw value "guest_name" de CodingKeys, así que la coincidencia falla.
Tratar los modelos de respuesta como tipos de valor es la convención habitual en Swift, y los structs obtienen gratis un inicializador memberwise, lo que facilita construir datos de prueba. Si necesitas semántica de referencia, cambia a final class y añade un inicializador.
Double.Cuando una clave contiene tanto enteros como decimales, Double evita perder precisión. Al revés, si todos los valores del ejemplo son del tipo 4.0, el parser JSON del navegador los lee como enteros y puedes obtener Int, así que comprueba los valores reales de la API.
Los CodingKeys también se usan al codificar, así que JSONEncoder vuelve a escribir guest_name. Las propiedades opcionales que valen nil se omiten en la salida.