Biblioteca GraphQL em C++: implementação de API com graphql-cpp

Biblioteca GraphQL para C++: graphql-cpp

No mundo das tecnologias web modernas, o GraphQL tornou-se um padrão para construir APIs flexíveis e eficientes. Se você desenvolve em C++ e deseja implementar suporte para este protocolo, precisará de uma biblioteca confiável. Uma das melhores soluções é a graphql-cpp — uma biblioteca de código aberto que permite criar servidores GraphQL completos em C++ com o mínimo de esforço.

O que é graphql-cpp?

graphql-cpp é uma biblioteca leve, mas poderosa, que implementa a especificação GraphQL (junho de 2018) em C++14 e superior. Ela fornece todos os componentes necessários: analisador de consultas, sistema de tipos, mecanismo de execução de consultas e suporte a subscriptions. A biblioteca não depende de frameworks HTTP de terceiros, permitindo sua integração em qualquer projeto — desde sistemas embarcados até servidores de alta carga.

Principais recursos

• Suporte completo ao esquema GraphQL: objetos, interfaces, tipos union, enum, escalares e tipos input.
• Validação e execução de consultas: validador e executor integrados com suporte a consultas complexas, fragmentos e diretivas.
• Suporte a Subscriptions: implementação através de fluxos reativos.
• Resolvers personalizáveis: sistema flexível para vincular lógica de negócios aos campos do esquema.
• Compatibilidade com C++17/20: uso de recursos modernos da linguagem para máxima performance.
• Sem dependências: não requer Boost, POCO ou outras bibliotecas externas.

Instalação e configuração

A biblioteca é distribuída como header-only (arquivos de cabeçalho). Para instalar, clone o repositório:

git clone https://github.com/your-repo/graphql-cpp.gitcd graphql-cppmkdir build && cd buildcmake ..makesudo make install

No seu projeto, basta incluir um arquivo de cabeçalho:

#include <graphqlcpp/GraphQL.h>

Exemplo: criando uma API simples

Vamos criar um esquema para obter informações sobre usuários.

1. Definição do esquema

using namespace graphqlcpp;

auto schema = Schema::create(R"(    type Query {        user(id: ID!): User        users: [User]    }    type User {        id: ID!        name: String!        email: String    })");

2. Implementação dos resolvers

// Exemplo de armazenamento de dadosstd::map<std::string, User> users = {    {"1", {"1", "Alice", "alice@example.com"}},    {"2", {"2", "Bob", "bob@example.com"}}};

// Resolver para o campo userschema->addResolver("Query", "user", [](const ResolverArgs& args) {    auto id = args.getArgument<std::string>("id");    if (users.count(id)) return users[id];    return nullptr; // null, se o usuário não for encontrado});

// Resolver para o campo usersschema->addResolver("Query", "users", [](const ResolverArgs&) {    std::vector<User> result;    for (const auto& [_, user] : users) {        result.push_back(user);    }    return result;});

3. Processamento da consulta

std::string query = R"(    {        user(id: "1") {            name            email        }    })";

auto result = schema->execute(query);std::cout << result.dump(2) << std::endl;

Saída:

{  "data": {    "user": {      "name": "Alice",      "email": "alice@example.com"    }  }}

Vantagens para um site educacional

• Documentação clara: a biblioteca possui comentários detalhados no código e exemplos para cada tipo.
• Baixa barreira de entrada: para começar, basta conhecer o básico de C++ e os conceitos fundamentais.