Conversor de JSON a Struct de Go
Pega un objeto JSON (o un array JSON) para generar automáticamente las definiciones de struct de Go correspondientes con etiquetas json.
Convertir JSON en structs de Go
Recibir la respuesta de una API en Go obliga a escribir un struct que se corresponda con el JSON, junto con sus etiquetas json. Con un puñado de campos no cuesta nada, pero en cuanto el anidamiento se profundiza, recorrer la jerarquía mientras se inventan nombres de tipo se convierte en el trabajo mismo. Esta herramienta genera el juego completo de definiciones, estructuras anidadas incluidas, sin más que el JSON que usted pegue.
Conviene tener presente, eso sí, que lo que sale es un tipo deducido de una sola muestra. Las claves que no aparecieran en ella faltarán, como es natural, y cualquier campo cuyo valor fuese null pasa a ser interface{}, ya que Go no tiene un primitivo anulable al que asignarlo. Cuando todos los elementos de un arreglo son objetos, las claves se fusionan en un único struct y las presentes solo en algunos elementos quedan marcadas con omitempty. Convertir la salida en un struct de producción da por supuesto que usted cotejará estas deducciones con la especificación real de la API y las corregirá.
Cómo convertir
- Pegue el JSON Sirve igual un objeto que un arreglo; la respuesta de una API entra tal como llegó.
-
Nombre el tipo raíz
Empieza como
Root. Los nombres de los tipos anidados salen solos, convirtiendo cada nombre de propiedad a notación Pascal. - Revise los structs generados Las definiciones aparecen en orden jerárquico con sus etiquetas json ya puestas.
-
Cópielos y déles forma
Pase el resultado por
gofmty vuelva sobre lo que quedó comointerface{}o sobre lo que debería ser un puntero, siguiendo la especificación real.
Consejos para aprovecharla mejor
- Cuando todos los elementos de un array son objetos, sus claves se combinan en un solo struct. Las claves que faltan en algunos elementos reciben automáticamente una etiqueta json
omitempty. - El nombre del tipo raíz es "Root" por defecto, pero puedes cambiarlo por el que prefieras. Los nombres de struct para objetos anidados se generan automáticamente convirtiendo el nombre de la propiedad a PascalCase.
- El valor null de JSON se genera como
interface{}porque Go no tiene un tipo primitivo nativo que admita null. Considera usar un tipo puntero si necesitas un manejo más estricto. - El resultado es un borrador con columnas ligeramente alineadas. Pasarlo por
gofmtdespués de pegarlo lo ajustará al estilo estándar de tu proyecto. - Pega tal cual una respuesta JSON de ejemplo de tu API para obtener rápidamente un borrador del struct de respuesta que usarás en tu código Go.
Cuándo resulta útil
Al empezar un cliente de API
Pegar la respuesta de ejemplo de la documentación le da al instante un primer borrador del struct receptor.
Al cargar un archivo de configuración
Cuando los ajustes se guardan en JSON, la estructura puede transcribirse directamente a un tipo.
Al descifrar la especificación de un tercero
Un JSON profundamente anidado se entiende mucho mejor una vez desplegado como un conjunto de structs.
Al preparar datos de prueba
Deducir primero los tipos de una respuesta real reduce el riesgo de desajuste cuando llegue el momento de escribir simulaciones.
Términos del mapeo de tipos en Go
- Struct
- El tipo de Go que agrupa varios campos. Se corresponde con un objeto de JSON.
- Etiqueta json
- La anotación escrita tras un campo con la forma
json:"user_id", que indica al codificador cómo se alinea el nombre del campo de Go con la clave del JSON. - Omitempty
- Opción de la etiqueta json que deja el campo fuera de la salida cuando su valor es el valor cero. No significa que el campo admita nulos, distinción que conviene retener.
- Interface{}
- Tipo que acepta cualquier valor. Los nulos del JSON y los campos de tipo cambiante aterrizan aquí, lo que lo convierte en una buena señal de los puntos que revisar tras la generación.
- Notación Pascal
- La convención de poner en mayúscula cada palabra, como en
UserId. En Go esa mayúscula inicial lleva además el significado de exportarse fuera del paquete. - Tipo puntero
- Un tipo escrito como
*string. Es lo que se emplea cuando la ausencia de valor debe distinguirse de una cadena vacía.
Preguntas frecuentes
json:"clave_original"), por lo que la codificación y decodificación siguen funcionando correctamente. Las claves que empiezan por un carácter sin forma mayúscula, como el texto japonés, reciben el prefijo Field (por ejemplo, 名前 pasa a Field名前), y las claves que acaban con el mismo nombre tras la conversión (como user_id y userId) reciben un sufijo numérico, de modo que el resultado siempre compila con nombres únicos.interface{}. Una clave que solo aparece en algunos elementos de un array recibe automáticamente una etiqueta json omitempty, pero el tipo de Go en sí solo toma su valor cero, así que considera usar un puntero si necesitas distinguir "ausente" de "cero".1.0, 1e3) se clasifica como float64, y uno sin ninguno de los dos como int. El paquete encoding/json de Go no puede decodificar un número con punto decimal o exponente en un tipo entero, y por eso se distinguen así. Los enteros fuera del rango de un int de 64 bits (unos ±9,2×10^18) pasan a float64 para que la decodificación no falle. Como float64 redondea esos valores, considera json.Number o string si necesitas manejar ID grandes con exactitud.interface{}. Tendrás que usar una aserción de tipo en tiempo de ejecución para determinar el tipo real del valor.
A propósito — Por qué Go combina structs con etiquetas json
Go es un lenguaje de tipado estático, y al trabajar con JSON, el paquete encoding/json de la biblioteca estándar depende de la correspondencia entre los campos del struct y sus etiquetas json para codificar y decodificar datos. Escribir a mano un struct para la forma de la respuesta de una API externa es una tarea repetitiva que crece cada vez que se añade un campo, y se ha repetido en muchos proyectos de Go.
Esta herramienta analiza la estructura de un JSON de ejemplo y genera automáticamente las definiciones de struct y las etiquetas json correspondientes, reduciendo ese trabajo repetitivo. Una herramienta conocida en este mismo espacio es quicktype, que admite convertir a tipos de varios lenguajes; pero para el caso más simple de pegar una respuesta de API de ejemplo y obtener rápidamente un struct de Go, una herramienta enfocada en una sola tarea tiene su propia comodidad.
Como Go no tiene ninguna característica del lenguaje para hacer opcional un campo de struct, el enfoque habitual para los campos JSON que podrían faltar es añadir omitempty a la etiqueta json, o usar un tipo puntero (como *string) para distinguir un valor cero de "ningún valor". El struct generado es solo una inferencia mecánica a partir de la estructura, así que tratar la posibilidad de null y los futuros cambios de la API como algo que se debe verificar y ajustar a mano contra la especificación real es la práctica habitual.