GraphQL é uma linguagem de consulta para APIs que permite que clientes solicitem exatamente os dados de que precisam através de um único ponto de entrada. Ele define um esquema que especifica quais consultas os clientes podem fazer e como os dados estão relacionados. Resolvers retornam os dados solicitados e mutações permitem modificações, enquanto subscriptions fornecem atualizações em tempo real. Ferramentas como Apollo e GraphQL Playground facilitam o desenvolvimento com GraphQL.

1. Introdução ao GraphQL
Por @guigaoliveira

2. O que é GraphQL?

3. “GraphQL is a query language for your API, and
a server-side runtime for executing queries by
using a type system you define for your data.”
https://graphql.org/learn

4. Quem utiliza?

6. Qual a motivação?

7. Alguns cuidados/problemas com REST

8. Como o GraphQL ajuda

9. Visão geral

10. Visão geral

11. Os princípios básicos do GraphQL
Query para obter dados
Mutation para manipulação de dados
Subscription para obter dados em tempo real

12. Alguns conceitos
Queries: os clientes as enviam para especificar os dados de que precisam.
Schema: O contrato para comunicação cliente-servidor. Especifica quais consultas
os clientes podem fazer, o que pode ser buscado e os relacionamentos entre os
tipos.
Resolvers: Uma função ou método que resolve um valor para um tipo ou campo
no schema.

13. Query - Exemplo
POST /graphql Retorno

14. Query - Várias ao mesmo tempo e apelidos
POST /graphql Retorno

15. Query - Nested
POST /graphql Retorno

16. Mutation - Exemplo
POST /graphql Retorno

17. Mutation - Removendo dados
POST /graphql Retorno

18. Mutation - Caso de erro
POST /graphql Retorno

19. Schema

20. Scalar Types
Existem 5 tipos escalares integrados ao GraphQL: Int, Float, String, Boolean e ID.
Escalares podem ser personalizados:

21. Enums
Um Enum é semelhante a um tipo escalar, mas pode ser apenas um dos vários
valores definidos no esquema.

22. As diretivas e algumas aplicações

23. As diretivas e algumas aplicações

24. As diretivas e algumas aplicações

25. Resolvers
Os resolvers recebem os seguintes argumentos:
● root - Resultado do tipo anterior / pai
● args - argumentos fornecidos para o campo
● context - um objeto mutável que é fornecido a todos os resolvers
● info - contém (Abstract syntax tree) AST da consulta e mais
informações de execução

26. Resolvers

27. Default resolvers

29. Bibliotecas / Ferramentas
● Apollo Client/Server/Engine (React / Node.js)
● Relay (React)
● Prisma (Javascript/Typescript/Flow/Go/)
● GraphiQL
● GraphQL Editor
● GraphQL Voyager
● GraphQL Playground
● GraphQL Docs

30. OK...MAS E A DEMO?
Servidor:
https://codesandbox.io/embed/graphql-intro-server-pcc8w
Cliente:
https://codesandbox.io/embed/graph-intro-client-f4ekh

31. Referências
● https://graphql.org/
● https://www.apollographql.com/docs/
● https://alligator.io/graphql/graphql-sdl/
● https://pt.slideshare.net/AmazonWebServices/introduction-to-graphql-95577414
● https://yos.io/2016/11/02/graphql-in-an-age-of-rest/
● https://github.com/prisma/prisma/blob/master/docs/1.15/understand-prisma/introduction-to-graph
ql-server-development-aa02.mdx
● https://blog.codecasts.com.br/entendendo-o-que-%C3%A9-graphql-atrav%C3%A9s-de-exemplos
-c2fa35e8bf63
● https://pt.slideshare.net/brunolemos/graphql-apis-mais-robustas-e-flexveis
● https://www.howtographql.com/