Generador de structs de C++ a partir de JSON

C++ se utiliza ampliamente en ámbitos donde el rendimiento, la baja latencia y el acceso directo al hardware son críticos, tales como motores de juegos, sistemas en tiempo real, operaciones bursátiles de alta frecuencia, robótica, servicios de Linux embebido y computación científica. Estos sistemas interactúan cada vez más con API REST, microservicios y sistemas de configuración que emplean JSON como formato de datos. Si bien históricamente C++ se asociaba a protocolos binarios y formatos de serialización personalizados, el ecosistema moderno de C++ ha adoptado JSON mediante la biblioteca nlohmann/json, la cual se ha convertido en uno de los proyectos de C++ con más estrellas en GitHub. Su modelo de distribución basado en un único archivo de cabecera y su API intuitiva la convierten en la opción preferida para gestionar JSON en proyectos de C++ que no requieren restricciones de rendimiento extremadamente estrictas para el análisis (parsing) de este formato.

La biblioteca nlohmann/json ofrece diversos enfoques para deserializar JSON en tipos de C++. Para datos estructurados simples, la macro NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE resulta la opción más práctica: acepta el nombre de un tipo `struct` y una lista de nombres de campos, generando automáticamente las funciones `from_json` y `to_json` que asocian las claves JSON con los campos de la estructura según su nombre. Este enfoque basado en macros no requiere modificar la definición de la estructura, lo que lo hace no intrusivo y compatible con estructuras definidas en archivos de cabecera compartidos con código que no utiliza nlohmann/json. La vinculación generada se somete a comprobación de tipos en tiempo de compilación mediante la especialización de plantillas, detectando así discrepancias de tipos entre el JSON y la estructura de C++ durante la fase de construcción en lugar de en tiempo de ejecución.

El sistema de tipos de C++ requiere una correspondencia cuidadosa entre los valores de JSON (de tipado dinámico) y los campos de C++ (de tipado estático). Las cadenas JSON se convierten en `std::string`. Los enteros JSON pasan a ser `int64_t` para garantizar la portabilidad del rango entre plataformas de 32 y 64 bits, evitando así riesgos de desbordamiento que ocurrirían con `int` o `int32_t` al manejar identificadores de API grandes o marcas de tiempo. Los números de punto flotante JSON se convierten en `double`. Los booleanos JSON pasan a ser `bool`. Los arrays JSON se convierten en `std::vector<T>` con el tipo de elemento adecuado. El valor `null` de JSON representa el caso más complejo: C++ carece de semántica nativa de referencia nula para tipos de valor, por lo que los campos JSON que admiten valores nulos requieren `std::optional<T>` (disponible desde C++17) para representar correctamente la distinción entre presencia y ausencia del valor.

Este generador de estructuras de C++ a partir de JSON produce definiciones de estructuras con enlaces de macros `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE`, tipos de campo estándar de C++ que siguen las convenciones de mapeo mencionadas y definiciones de estructuras anidadas para objetos JSON anidados. El resultado es compatible con los estándares modernos de C++ (C++11 y versiones posteriores para funcionalidades básicas, C++17 para `std::optional`). Basta con añadir el archivo de cabecera única de `nlohmann/json` o incluirlo mediante el comando `FetchContent` de CMake para compilar y ejecutar el código generado. Para los desarrolladores de C++ que crean clientes de API, cargadores de datos de juegos, analizadores de configuración o deserializadores de mensajes de red, este generador supone una ventaja considerable en la tarea de modelado de datos necesaria para cualquier integración con JSON.