JSON a Swift
Genera estructuras Swift que cumplen con Codable a partir de una muestra de JSON. Los nombres de las propiedades se convierten a camelCase y se añade un enum CodingKeys cuando una clave es distinta; los valores opcionales y nulos se convierten en opcionales, y los valores de tipo mixto usan un pequeño enum JSONValue que la herramienta añade al resultado. Decodifica el resultado con JSONDecoder.
Preguntas frecuentes
¿Cómo se nombran los objetos anidados?
Cada objeto anidado se convierte en su propio tipo Swift, cuyo nombre se basa en la clave que lo contiene y se escribe en PascalCase; por ejemplo, address se convierte en Address. Los objetos dentro de matrices toman el singular de la clave de la matriz; por ejemplo, users se convierte en User. Los objetos con exactamente los mismos campos comparten un tipo.
¿Cuándo es opcional un campo?
Cuando una matriz contiene varios objetos y a alguno le falta una clave, ese campo es opcional: su tipo se convierte en opcional, y Codable lo decodifica como nil cuando falta la clave. Las claves presentes en todas las muestras son obligatorias. Un único objeto no tiene otro con el que compararse, así que todas sus claves son obligatorias.
¿Cómo se gestionan los valores nulos?
Una clave que es null en algunas muestras y tiene un valor en otras se convierte en opcional, como String?. Si una clave siempre es null, la herramienta no puede determinar su tipo real, así que se convierte en JSONValue?; pega una muestra con un valor real para obtener un tipo preciso.
¿Qué tipos se usan para los números?
Los números enteros se convierten en Int y los números con decimales, en Double. Un campo que contiene ambos tipos se convierte en Double.
¿Qué ocurre con las claves que no son nombres válidos?
Los nombres de las propiedades se convierten a camelCase. Cuando al menos un nombre difiere de su clave, la estructura incluye un enum CodingKeys que asigna cada propiedad a su clave JSON. Los nombres que son palabras clave de Swift, como default, se escriben entre acentos graves.
¿Se carga o almacena mi JSON?
El JSON se envía al servidor solo para generar el código de esta solicitud y no se almacena. El generador solo lee la estructura y los tipos de valores de la muestra, así que puede reemplazar los valores sensibles por marcadores de posición del mismo tipo antes de pegarla.