O documento apresenta uma palestra sobre GraphQL, abordando: 1) Uma breve história do desenvolvimento do GraphQL no Facebook; 2) As principais características como uma única rota e consultas complexas; 3) Vantagens em relação a APIs REST como desempenho e versionamento.

1. Aposta ou
retrocesso?
Palestrante: Wender Machado
wenderpmachado@gmail.com
/in/wenderpmachado
VII

2. Sobre
Wender Machado
(o palestrante)
➔ 4 anos de experiência com
desenvolvimento web
➔ Desenvolvedor Full-stack
na RG Sistemas
➔ Formado em Técnico de
Informática pelo CEFET NF
➔ Graduando em Bacharelado
em Sistemas de Informação
pelo CEFET NF
2

3. Um pouco de contexto
3

4. Um pouco de contexto
➔ Até 2011 o Facebook tinha aplicativos móveis híbridos:
◆ com diversos problemas de desempenho
◆ e de usabilidade
➔ Em 2012 lançaram a versão nativa do aplicativo para iOS
◆ e, internamente, desenvolveu o GraphQL.
4
Mais em “GraphQL: The Documentary”, disponível no Youtube

5. Um pouco de contexto
➔ Em 2015 o GraphQL foi lançado publicamente.
5
Google trends:
https://trends.google.com.br/trends/explore?date=2015-10-15%202019-11-15&q=graphql

6. Um pouco de contexto
➔ Em 2016 o GitHub adotou o GraphQL em sua API pública:
6
Mais em: https://github.blog/2016-09-14-the-github-graphql-api/
API v4: https://developer.github.com/v4/
“O GraphQL representa um grande avanço no
desenvolvimento de API. Segurança de tipo, introspecção,
documentação gerada e respostas previsíveis beneficiam
os mantenedores e os consumidores de nossa plataforma.”

7. O que é GraphQL?
7

8. Primeiramente...O que é GraphQL?
➔ O GraphQL é uma especificação de linguagem de consulta de dados
8

9. “Linguagem de consulta...ah, entendi! SQL, não é?”
➔ NÃO! GraphQL não tem nada a ver com banco de
dados.
9

10. Além do Facebook e Github, quem mais usa?
“840 empresas supostamente usam o GraphQL” - stackshare.io
10

11. Características do GraphQL
11

12. Características do GraphQL: Uma única rota
12

13. REST
➔ GET /users
➔ POST /users
➔ PUT /users/:id
➔ DELETE /users/:id
13
query (...) { … }
mutation (...) { … }]
GraphQL
WebSocket (Realtime) subscription (...) { … }
Operações disponíveis
P
O
S
T

14. GraphQL
➔ POST /graphql { query: … }
Verbo HTTP Caminho Corpo
14
Estrutura da requisição

15. Exemplo usando Playground
15

16. Exemplo usando Playground
16

17. MVC
➔ Model
➔ Controller
17
Type
(InputType em caso de mutation)
Resolver
GraphQL
Arquitetura

18. GraphQL Schema Definition Language (SDL)
➔ Linguagem fortemente tipada
18

19. Schema First
19

20. Code First
20

21. ● Performance
● Versionamento
● Segurança
● GraphQL vs API rest? Será?

22. ➔ Evita o under-fetching
➔ Evita o over-fetching
◆ Diminuir o gasto de banda
O cliente decide quais informações quer consumir
22
➔ As consultas podem ser
maiores e mais complexas do
que nas APIs REST
tradicionais
➔ Quantidade imprevisível* de
dados para cada solicitação

23. Problematica: performance
23

24. Solução
24
Fonte: https://medium.com/@jcc0xp/graphql-vs-rest-pensando-de-uma-forma-inovadora-a89c0d514a0d

25. Descobrir o número de stars e o de pull requests de
um repositório no GitHub
➔ API /v3 (REST):
◆ disparar 3 requisições ao servidor
◆ baixar 83.2 KB de informações gzipadas e cabeçalhos
◆ fazer parse de 768.1 KB de JSON ou 13654 linhas
➔ API /v4 (GraphQL):
◆ disparar 1 requisições ao servidor
◆ baixar 996 B de informações gzipadas e cabeçalhos
◆ fazer parse de 93 B de JSON
25Mais em: https://blog.caelum.com.br/todo-o-poder-emana-do-cliente-explorando-uma-api-graphql/

26. ➔ Simplesmente adicione
campos quando precisar ou
marque-os como obsoletos
quando planejar parar de
usá-los.
Versionamento Evolução contínua da API
26
➔ Inviável implementar
versionamento “tradicional”:
➔ v1/user
➔ v2/user

27. Versionamento Evolução contínua da API
27
➔ Exemplo de
campo obsoleto:
(Playground)

28. Versionamento Evolução contínua da API
28
➔ Exemplo de
campo obsoleto:
(Plugin VSCode)
Fonte: https://www.apollographql.com/docs/graph-manager/editor-plugins/

29. Versionamento Evolução contínua da API
29
➔ Documentação “Automatica”

30. Questões de Segurança
30
➔ Utilização de Token no cabeçalho
➔ Verificações a partir do usuário que está solicitando alguma
ação
➔ Realizar parse para não expor exatamente o campo do banco
de dados

31. Exemplos de arquitetura: API Gateway (genérico)
31
Fonte: https://labs.getninjas.com.br/

32. Airbnb: Gateway Service
32
Fonte: medium.com/airbnb-engineering/reconciling-graphql-and-thrift-at-airbnb-a97e8d290712

33. Soluções: Apollo Platform
33
Fonte: https://www.apollographql.com/platform/

34. 34(experimente GraphQL)

35. Dúvidas?
E-mail: wenderpmachado@gmail.com
Todas redes sociais: wenderpmachado
35