GET /api/escolas?cidade=saopaulo
GET /api/alunos?escola=pedrosegundo
GET /api/alunos?id=1
GET /api/escolas?id=2

São pelo menos quatro requisições, além do trabalho de mapear as notas de cada aluno e criar um ranking, agora imagine que esse aluno vai vir com nome, idade, escola, maior nota e data de nascimento, sendo que só
precisamos da maior nota e do nome do aluno, bom é nesse ponto que eu te digo O GraphQL resolve!

O GraphQL foi criado pela equipe de engenheiros do Facebook, que basicamente precisavam lidar com problemas no Feed de Noticias
em suas aplicações mobile, tendo como um principio satisfazer aos requisitos de visualização em produtos e aos desenvolvedores que a constroem, em poucas palavras ele entrega aquilo que você pede de forma objetiva e clara.

Vamos ao código

Para começarmos a criar nossa aplicação vamos configurar o nosso server.js e instalar alguns pacotes.

npm install express graphql apollo-server-express — save

Depois de configurar nosso body-parser nos passamos um schema, um context(não se preocupe logo falaremos sobre os loaders) e definimos o graphiql como true.

O primeiro ponto é entender o schema, ele é o cara que define a API do seu servidor, nele você vai criar os tipos e suas propriedades, além das
suas mutações e consultas.

Criando os Tipos

Definimos um ObjectType e seus campos, repare que ele possui um nome e alguns campos, os campos possuem tipos que são do próprio GraphQL. Também temos um tipo List que pode ser de String, Int ou de ObjectType.

Para criar uma query, que é tipo um select do nosso ObjectType, definimos seus campos, que são seus métodos com um tipo de retorno, args (os parâmetros) e o resolve (a função a ser executada).
O resolve é onde eu efetivamente faço minha consulta, recomendo que tente ser o mais objetivo nesse ponto, se precisar executar outra ação durante a query faça isso fora do resolve e apenas chame a função.

As mutations, seriam nossos updates e deletes, seguem basicamente a mesma regra, tendo sempre um resolve e um type pelo menos.

Com isso vamos gerar nosso schema, tudo que fazemos aqui é criar um schema separado para cada objeto e depois o merge deles gerando um único schema.
O schema tem pelo menos uma query, quanto a mutation você pode ver que eu adicionei aqueles funções apenas nos campos, mas eu poderia fazer o mesmo que fiz com as queries.

Contudo temos um problema, o GraphQL faz ‘n+1 requests a base’, pois os resolves são apenas funções independentes uma da outra, o que vai acarretar em varias consultas idênticas a base, bom para lidar com isso vou usar o Dataloader, que também foi criado pelo Facebook.

Vou adicionar um link no final explicando detalhadamente como ele funciona.

Vamos passar nossa função de busca para o loader, que vai reunir nossas consultas em uma única.

Tudo pronto agora podemos testar nossa API, acessando localhost:4000/graphiql onde você consegue visualizar e testar suas querys e mutations.

Para executar uma mutation é só invocar ela passando os parâmetros

Voltando ao nosso problema das notas, precisamos listar todos os alunos de todas as escola, com GraphQL podemos personalizar nossa consulta e
fazer isso:

Para que possamos analisar nossas requisições vamos adicionar o Apollo Engine, que é um gateway feito para ajudar a avaliar o estado de uma
API GraphQL.

Conclusão

O objetivo deste artigo é apresentar o GraphQL dentro de um cenário real, não pense que ele é uma bala de prata, isso não existe.
O GraphQL traz muitos benefícios, desde o número de requisições ao aproveitamento dos dados, mas ele também possui alguns problemas como o n+1, então tente sempre avaliar bem o seu problema antes de apontar uma solução.

No próximo artigo vou mostrar como consumir nossa API com VueJS, usando o Apollo Client. Você também pode ver o projeto completo no meu repositório.

Este é meu primeiro artigo técnico, espero que tenha gostado e claro que tenha aprendido algo novo.

Fontes:

- Dataloader
- How to GraphQL
- GraphQL Origem

Lembro-me bem de quando éramos uma dupla, éramos bons no que fazíamos, não interessasse o que fosse eu tinha uma ideia maluca na cabeça e você os passos perfeitos pra torná-la possível.
Posso dizer, com certeza, que entre nossas melhores receitas a minha favorita foi o ensopado de codorna, era uma receita polonesa, bem complexa até. Eu fiquei nervoso e preocupado na época, mas tive a brilhante ideia de finalizar o prato em menos de 20 minutos, não foi tão brilhante assim, mas consegui terminar a receita, ou melhor nós conseguimos.
Graças a sua dica sobre o molho de mostarda seguido de uma pitada de açúcar, aquilo deu um equilíbrio a receita; mas se não me falha a memória eu exagerei na mostarda, me desculpe por isso.

Passei vários meses te procurando, nas gavetas, no armário da cozinha, embaixo do colchão, até que cansei. Sempre imaginei que era culpa minha, desatenção eu diria, me perguntei diversas vezes como eu podia ter perdido você assim, sem entender ao menos o porque.
Nesse tempo eu também tentei outros livros e outras receitas, afinal o restaurante não podia parar, bom não vou mentir pra você, estava certo ao dizer que cada pimenta é única e que cada prato exige um pitada diferente da mesma.
Mais alguns meses e lá estava eu, cozinhando sem meu livro, cheguei a um ponto onde tive que aprender a medir quantidade, temperatura e tempo de preparo sozinho, tenho orgulho de te dizer que fiquei realmente bom nisso e por um momento imaginei que tudo isso era parte de algum acaso do destino que me deu uma chance de melhorar e que quando eu te encontra-se estaríamos ambos prontos para o tão sonhado Pavlova, um dos pratos mais difíceis que já tínhamos visto.
Depois de muita pesquisa e também uns planos malucos eu conclui o que aconteceu com você, talvez eu esteja enganado, mas se depender de você provavelmente eu vou morrer sem saber não é?

Faz um bom tempo meu caro, eu não sei como está indo no seu novo restaurante, mas você tinha receitas incríveis, então sei que está bem e também deve estar maior, com novas receitas. Sobre meu novo livro de receitas, não tenho um. Deixei de lado isso e voltei a usar meu velho bloco de notas, que esta sendo de grande ajuda.
Mas não escrevi isso com o objetivo de te dizer obrigado, escrevi isso pra te dizer que eu nunca teria levado o livro de sobremesas para casa aquele dia e que o fato de você ter sumido me fez perceber que no final você nunca esteve aqui, eu tinha que ir atrás dos ingredientes, eu tinha que preparar tudo, no final você era só um livro, no final eu não aprendi nada com você, por que no final era só eu e um livro qualquer de receitas.

Não se esqueça que o que te torna especial não é sua capa dura ou suas receitas com 200 passos, mas sim o chefe que está por trás dos pratos, o verdadeiro autor das receitas, aquele que um dia cozinhou ao meu lado, aquele que um dia eu chamei de amigo, aquele que um dia eu fui obrigado a deixar pra trás.
Por fim gostaria de te pedir um favor, se acaso se encontrar com seu autor diga a ele que eu o admirei por muito tempo, mas isso mudou.
Do seu velho chef, Zero

O verão tem suas vantagens, por ser quente ele te deixa eufórico e sempre disposto, mas conforme ele vai passando te deixa desconfortável, com preguiça e até falta de ar; por que essa intensidade toda te faz querer descansar um pouco, só tem um problema nisso, descansar é a ultima coisa que o verão quer que você faça e se insistir nisso ele vai embora.

O verão é aquela pessoa que passa pela sua vida sem dar explicações de porque esta ali ou porque ainda continua, mas uma hora ela vai embora dizendo no máximo um até logo.

Agora vou explicar porque a primavera é pior, tudo começa com o fim de um inverno frio e vazio, sem metas ou animo pras coisas eu me deparo com uma arvore e um ninho de passarinhos, todos os dias no caminho do trabalho observo o ninho e em especial um dos filhotes, o mais barulhento por sinal.

Com o tempo eu decido ficar mais próximo dele, mas nunca demais e ai esta o problema da primavera, por que ela não é algo tão intenso como o verão, ela é mais sutil e sem perceber eu já estava envolvido nisso.

No inicio eu me recusava a me aproximar demais do pássaro, mas logo me peguei dando dicas de voo para ele, sabe o que era mais curioso? ele tinha interesse no que eu dizia e se mostrava empolgado na quantidade de coisas que seria capaz de fazer.

Um dia o pássaro estava pronto para voar, mas eu não estava pronto pra ficar sem ele, então eu sabotei seu primeiro voo, é eu sei isso foi infantil, mas essa é uma das características da primavera, ela te faz se sentir invencível e único, afinal os pássaros parecem cantar só pra você.

O sol não é quente demais , nem o vento forte demais, tudo está em uma proporção indescritível e o mais incrível é que tudo transmite vida, as chuvas ocasionais no fim da tarde com aquele cheiro que vem logo ao caírem no asfalto ou aquele vento que te abraça no fim da tarde, até mesmo a manhã quentinha que te deixa animado pra começar o dia.

Depois de algumas tentativas do pássaro fracassadas e até algumas sabotadas por mim ele ficou diferente, não tinha a mesma vontade de antes, estava morrendo ali mesmo.

Eu sabia o que tinha que fazer, tinha que deixar ele ir, tinha que motivá-lo a partir e aceitar que seria para sempre, essa é a diferença da primavera pro verão, enquanto o verão vai embora e leva consigo toda a intensidade, a primavera te faz expulsa-la e ser obrigado a ficar com as lembranças de toda a estação.

Então eu fiz, motivei o pássaro a sair voando, ele se recusava de inicio, mas então mostrei a ele meu pior lado, assim ele não teria porque ficar. Funcionou ele foi embora, foi horrível a sensação de vê-lo partir me odiando, sabendo que nunca mais voltaria, fiquei ali parado por horas pensando em como foi incrível ter vivido essa fase, mas também chorando da raiva que me dava por ter feito tudo aquilo. Naquele dia em questão eu me lembrei da primeira coisa que aprendi sobre as pessoas, elas não morrem de verdade, no fundo elas são esquecidas, e foi o que fiz eu o esqueci e levando comigo só alguns flashes e frases incompletas.

A primavera é aquela pessoa que chega devagar na sua vida, te arranca sorrisos e te deixa sempre confortável, mas ela é nova e precisa aprender muita coisa e sera você a pessoa que vai ensinar pra ela, vai ser incrível porque todos os dias terá algo novo a ensinar, estará motivado sempre, mas ela precisa ir embora e sera você a pessoa encarregada de lhe ajudar nisso.

Neste dia em questão eu recomendo ser direto e simples, não faça muito alarde apenas diga adeus, tente não olhar pra traz e respire devagar porque vai ser ali que você vai perceber o tanto de coisas que fez e que viveu, os flashes virão de uma vez, as memorias vão se misturar, vai sentir raiva, alegria e remorso, tudo de uma vez. Como eu disse respire devagar, não tem nada que possa fazer, contente-se com o fato de que essa sera a ultima vez que a primavera passara por sua vida, diferente do verão você não vivera duas ou três primaveras, o que pode acontecer é ela voltar como brisas fracas em um outono qualquer para te lembrar daquilo que você tenta esquecer.