GraphQL API em C++: tutorial passo a passo com exemplos práticos

Introdução: GraphQL e C++ — uma dupla poderosa para APIs modernas

GraphQL está se tornando o padrão de facto para construir APIs flexíveis e eficientes. Enquanto a maioria dos tutoriais foca em JavaScript ou Python, o C++ continua sendo indispensável para sistemas de alta carga, servidores de jogos e soluções embarcadas. Neste guia passo a passo, criaremos uma API GraphQL completa em C++ do zero, usando a biblioteca graphql-cpp e o servidor cpp-httplib.

Você aprenderá como configurar o ambiente, definir o esquema, implementar resolvers e iniciar o servidor. Todos os exemplos de código podem ser aplicados imediatamente em projetos reais.

1. Preparação do ambiente e instalação das dependências

Para trabalhar, precisaremos de:

\n
• Compilador com suporte a C++17 (GCC 8+, Clang 7+, MSVC 2019+)
\n
• CMake (versão 3.14+)
\n
• Biblioteca graphql-cpp (implementação GraphQL)
\n
• Biblioteca cpp-httplib (servidor HTTP)
\n
• Gerenciador de pacotes vcpkg (opcional, mas conveniente)
\n

Instalação via vcpkg

git clone https://github.com/Microsoft/vcpkg.git\ncd vcpkg\n./bootstrap-vcpkg.sh\n./vcpkg install graphql-cpp cpp-httplib nlohmann-json

Estrutura do projeto

graphql-cpp-api/\n├── CMakeLists.txt\n├── src/\n│   ├── main.cpp\n│   ├── schema.cpp\n│   ├── schema.h\n│   ├── resolvers.cpp\n│   └── resolvers.h\n└── vcpkg.json

CMakeLists.txt

cmake_minimum_required(VERSION 3.14)\nproject(GraphQLCppApi)\n\nset(CMAKE_CXX_STANDARD 17)\nset(CMAKE_CXX_STANDARD_REQUIRED ON)\n\nfind_package(graphql-cpp CONFIG REQUIRED)\nfind_package(cpp-httplib CONFIG REQUIRED)\nfind_package(nlohmann_json CONFIG REQUIRED)\n\nadd_executable(graphql_server\n    src/main.cpp\n    src/schema.cpp\n    src/resolvers.cpp\n)\n\ntarget_link_libraries(graphql_server\n    graphql-cpp::graphql-cpp\n    cpp-httplib::cpp-httplib\n    nlohmann_json::nlohmann_json\n)

Agora está tudo pronto para escrever o código.

2. Definição do esquema GraphQL e tipos

Vamos começar criando o esquema para uma API simples de gerenciamento de livros. Teremos os tipos Book e Author, além de consultas e mutações.

schema.h

#ifndef SCHEMA_H\n#define SCHEMA_H\n\n#include <graphqlcpp/GraphQLSchema.h>\n\nstd::shared_ptr<graphql::GraphQLSchema> createSchema();\n\n#endif

schema.cpp

#include "schema.h"\n#include "resolvers.h"\n\nstd::shared_ptr<graphql::GraphQLSchema> createSchema() {\n    using namespace graphql;\n\n    // Tipo Author\n    auto authorType = object_type("Author", {\n        field("id", int_type()),\n        field("name", string_type()),\n        field("books", list_type(int_type()))\n    });\n\n    // Tipo Book\n    auto bookType = object_type("Book", {\n        field("id", int_type()),\n        field("title", string_type()),\n        field("authorId", int_type()),\n        field("year", int_type()),\n        field("genre", string_type())\n    });\n\n    // Query root\n    auto queryType = object_type("Query", {\n        field("books", list_type(bookType), {\n            argument("genre", string_type(), true)  // argumento opcional\n        }, resolveBooks),\n        field("book", bookType, {\n            argument("id", int_type(), false)       // argumento obrigatório\n        }, resolveBookById),\n        field("authors", list_type(authorType), resolveAuthors)\n    });\n\n    // Mutation root\n    auto mutationType = object_type("Mutation", {\n        field("addBook", bookType, {\n            argument("title", string_type(), false),\n            argument("authorId", int_type(), false),\n            argument("year", int_type(), false),\n            argument("genre", string_type(), false)\n        }, resolveAddBook),\n        field("deleteBook", bool_type(), {\n            argument("id", int_type(), false)\n        }, res