Biblioteca GraphQL JavaScript (Node.js): Guia Completo sobre Apollo Server e Ferramentas

Biblioteca GraphQL para Node.js: Apollo Server e Ferramentas de Desenvolvimento

GraphQL é uma linguagem de consulta para APIs que permite aos clientes solicitar apenas os dados de que precisam. Para desenvolvimento em Node.js, a biblioteca mais popular é o Apollo Server. Ela fornece um conjunto completo de ferramentas para criar, testar e implantar APIs GraphQL. Neste artigo, vamos detalhar os principais componentes, abordagens e exemplos de código.

O que é Apollo Server?

Apollo Server é uma biblioteca de código aberto que permite criar rapidamente um servidor GraphQL em Node.js. Ele suporta vários transportes (HTTP, WebSocket) e se integra facilmente com frameworks (Express, Koa, Fastify). Principais recursos:

• Geração automática de documentação através do GraphQL Playground.
• Suporte a subscriptions via WebSocket.
• Mecanismo de cache e agregação de dados (data loaders).
• Sistema flexível de middleware para autenticação e autorização.

Instalação e Configuração Básica

Para começar, instale os pacotes apollo-server e graphql:

npm install apollo-server graphql

Crie um servidor simples que retorna uma saudação:

const { ApolloServer, gql } = require('apollo-server');

// Definindo o schema (SDL)const typeDefs = gql`  type Query {    hello: String  }`;

// Resolvers — funções que retornam os dadosconst resolvers = {  Query: {    hello: () => 'Hello, GraphQL!',  },};

// Iniciando o servidorconst server = new ApolloServer({ typeDefs, resolvers });server.listen().then(({ url }) => {  console.log(`🚀 Servidor rodando em ${url}`);});

Tipos de Dados e Schemas

No GraphQL, o schema define todos os tipos e operações disponíveis. Tipos principais:

• String, Int, Float, Boolean, ID — tipos escalares.
• [Type] — lista de objetos.
• type — objeto personalizado.
• input — tipo para parâmetros de entrada de mutations.

Exemplo de schema para um blog:

type User {  id: ID!  name: String!  posts: [Post!]!}

type Post {  id: ID!  title: String!  content: String!  author: User!}

type Query {  user(id: ID!): User  posts(limit: Int): [Post!]!}

type Mutation {  createUser(name: String!): User!}

Resolvers: Conectando o Schema aos Dados

Cada campo do schema deve ter um resolver correspondente. Os resolvers podem obter dados de bancos de dados (MongoDB, PostgreSQL), APIs externas ou arrays estáticos.

const users = [  { id: '1', name: 'Ana' },  { id: '2', name: 'Boris' },];

const posts = [  { id: '10', title: 'GraphQL para iniciantes', content: '...', authorId: '1' },  { id: '20', title: 'Dicas de Node.js', content: '...', authorId: '2' },];

const resolvers = {  Query: {    user: (_, { id }) => users.find(u => u.id === id),    posts: (_, { limit }) => limit ? posts.slice(0, limit) : posts,  },  Mutation: {    createUser: (_, { name }) => {      const newUser = { id: String(users.length + 1), name };      users.push(newUser);      return newUser;    },  },  User: {    posts: (parent) => posts.filter(p => p.authorId === parent.id),  },};

Abordagem Code-first com TypeGraphQL

Para projetos grandes, é mais conveniente usar a abordagem code-first, onde o schema é gerado a partir de classes TypeScript. A biblioteca type-graphql permite escrever código que é ao mesmo tempo tipo e resolver.

npm install type-graphql reflect-metadata class-validator

Exemplo de classe-entidade:

import { ObjectType, Field,