API GraphQL en C++: guía completa con ejemplos

API GraphQL con C++: Tutorial paso a paso

GraphQL es un poderoso lenguaje de consultas para API que permite a los clientes obtener exactamente los datos que necesitan, y nada más. Aunque C++ no es el lenguaje más popular para crear API web, su rendimiento y control sobre la memoria lo convierten en una excelente opción para sistemas de alta carga. En este tutorial crearemos un servidor GraphQL funcional en C++ utilizando la biblioteca graphql-cpp.

Qué se necesita para empezar

Para trabajar necesitarás:

• Compilador con soporte para C++17 (GCC 8+, Clang 7+, MSVC 2019+)
• CMake versión 3.14 o superior
• Biblioteca graphql-cpp (instalación mediante vcpkg o compilación desde el código fuente)
• Biblioteca libmicrohttpd para el servidor HTTP

Instalemos las dependencias mediante vcpkg:

git clone https://github.com/microsoft/vcpkg.gitcd vcpkg./bootstrap-vcpkg.sh./vcpkg install graphql-cpp libmicrohttpd

Creación de la estructura básica del proyecto

Empecemos con la configuración del proyecto CMake. Crea el archivo CMakeLists.txt:

cmake_minimum_required(VERSION 3.14)project(graphql-cpp-tutorial)

set(CMAKE_CXX_STANDARD 17)set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(graphql-cpp CONFIG REQUIRED)find_package(MHD CONFIG REQUIRED)

add_executable(graphql-server main.cpp)target_link_libraries(graphql-server     graphql-cpp::graphql-cpp    MHD::MHD)

Ahora creemos el archivo principal main.cpp con un servidor mínimo:

#include <graphql-cpp/GraphQL.h>#include <microhttpd.h>#include <iostream>#include <string>

using namespace graphql::cpp;

// Función para manejar peticiones HTTPstatic enum MHD_Result request_handler(void* cls,    struct MHD_Connection* connection,    const char* url,    const char* method,    const char* version,    const char* upload_data,    size_t* upload_data_size,    void** con_cls) {        const char* response_str = "{\\"data\\":{\\"hello\\":\\"world\\"}}";    struct MHD_Response* response = MHD_create_response_from_buffer(        strlen(response_str),         (void*)response_str,         MHD_RESPMEM_PERSISTENT    );    MHD_add_response_header(response, "Content-Type", "application/json");    int ret = MHD_queue_response(connection, MHD_HTTP_OK, response);    MHD_destroy_response(response);    return ret == MHD_YES ? MHD_YES : MHD_NO;}

int main() {    struct MHD_Daemon* daemon = MHD_start_daemon(        MHD_USE_INTERNAL_POLLING_THREAD,        4000,        NULL, NULL,        &request_handler,        NULL,        MHD_OPTION_END    );        if (daemon == NULL) {        std::cerr << "Error al iniciar el servidor" << std::endl;        return 1;    }        std::cout << "Servidor ejecutándose en http://localhost:4000/graphql" << std::endl;    getchar();    MHD_stop_daemon(daemon);    return 0;}

Definición del esquema GraphQL

Ahora agreguemos un esquema GraphQL real. Creemos el tipo Book y el tipo raíz Query:

#include <graphql-cpp/Schema.h>#include <graphql-cpp/Type.h>#include <vector>#include <memory>

using namespace graphql::cpp;

// Modelo de datosstruct Book {    int id;    std::string title;    std::string author;    int year;};

// Repositorio de libros (simulación de base de datos)class BookRepository {public:    static std::vector<Book> getAll() {        return {            {1, "Guerra y Paz", "León Tolstói", 1869},            {2, "Crimen y Castigo", "Fiódor Dostoyevski", 1866},            {3, "El Maestro y Margarita", "Mijaíl Bulgákov", 1967}        };    }        static Book getById(int id) {        auto books = getAll();        for (const auto& book