Generación Swagger OpenAPI para C++

Generación Swagger/OpenAPI para C++: cómo automatizar la creación de REST API

El desarrollo web moderno en C++ requiere herramientas eficientes para crear REST API. La especificación OpenAPI (anteriormente Swagger) se ha convertido en el estándar para describir interfaces de servicios web. Sin embargo, la generación automática de código C++ a partir de especificaciones OpenAPI es una tarea compleja. En este artículo, analizaremos las mejores bibliotecas y herramientas que le ayudarán a generar código de servidor y cliente en C++ a partir de documentos OpenAPI.

¿Por qué C++ está rezagado respecto a otros lenguajes en la generación OpenAPI?

A diferencia de Python, Java o JavaScript, donde existen generadores maduros (por ejemplo, openapi-generator), C++ enfrenta varios problemas:

Falta de un estándar único para frameworks HTTP — en C++ no hay un framework web dominante como Flask o Spring.
Complejidad en la gestión de memoria — la generación de código seguro con punteros inteligentes requiere plantillas adicionales.
Variedad de tipos — la serialización JSON en C++ requiere configuración manual para estructuras complejas.

Herramientas principales para generar código C++ a partir de OpenAPI

1. OpenAPI Generator (generador oficial)

La herramienta más popular es OpenAPI Generator (anteriormente Swagger Codegen). Soporta múltiples lenguajes, incluido C++. Sin embargo, su soporte para C++ es limitado: solo genera código de cliente basado en cpprestsdk (Casablanca) o Qt.

Instalación:

# A través de npmnpm install @openapitools/openapi-generator-cli -g

# Generación de cliente C++ (cpprestsdk)openapi-generator generate -i petstore.yaml -g cpp-restsdk -o ./client

Ejemplo de código generado (Qt):

// PetApi.hclass PetApi : public AbstractOpenAPISchema {    Q_OBJECTpublic:    explicit PetApi(QObject *parent = nullptr);        void addPet(const Pet &body);    void getPetById(qint64 petId);    signals:    void addPetSignal(Pet &result);    void getPetByIdSignal(Pet &result);};

Ventajas: Soporte para múltiples formatos, comunidad activa.
Desventajas: El código generado a menudo requiere ajustes; no hay generación de servidor para C++.

2. oat++ (oatpp) — framework con soporte OpenAPI

oat++ es un framework moderno de C++ para crear REST API que incluye soporte integrado para OpenAPI. A diferencia de los generadores, oat++ utiliza un enfoque declarativo con anotaciones.

Ejemplo de descripción de endpoint:

ENDPOINT("GET", "/users/{userId}", getUser) {    auto userId = req->getPathVariable("userId");    auto user = userService->getUser(userId);        // Documentación automática OpenAPI    auto dto = UserDto::createShared();    dto->id = user->id;    dto->name = user->name;    return createDtoResponse(Status::CODE_200, dto);}

Oat++ genera automáticamente openapi.yaml basado en las anotaciones. Esto permite no escribir la especificación manualmente, sino derivarla del código.

3. Restbed + Swagger UI

Restbed es un framework HTTP ligero para C++11. Junto con la biblioteca restbed-swagger, se puede generar documentación OpenAPI dinámicamente.

#include <restbed>#include <restbed-swagger>

auto resource = std::make_shared<restbed::Resource>();resource->set_path("/api/users/{id}");

// Descripción de parámetros para Swaggerrestbed::swagger::Info info;info.set_title("User API");info.set_version("1.0.0");

auto swagger = std::make_shared<restbed::swagger::Service>(info);swagger->publish(resource);