Introdução ao GraphQL - Uma nova forma de criar APIs (com Ruby)

Palestra realizada no meetup da comunidade RubyOnRio em 04/06/2019.

Transcript

1. Introdução ao GraphQL Uma nova forma de criar APIs
2. Fernando Henriques • Desenvolvedor 10+ anos • Senior Full Stack Developer • JavaScript, Ruby, PHP e Java • Front-end 3000 github.com/fernandohenriques
3. Nova forma de criar APIs? Foi criada em 2012 e lançada publicamente em 2015, mas...
4. FACEBOOK STACK https://stackshare.io/facebook/facebook
5. Ecossistema rico no front-end Mais de mil pacotes no NPM para o termo “graphql”...
6. Ecossistema consolidado com Ruby 157 gems encontradas para o termo "graphql" no RubyGems
7. Alguém está usando em prod ?
8. Minha ex-empresa também usa
9. O que é o GraphQL?
10. GraphQL ➔ Criada pelo Facebook ➔ Open-source ➔ Linguagem de consulta de dados ➔ Não é um protocolo para APIs, mas funcionando como um ➔ Agnóstico: independe de linguagem ou banco de dados ➔ É uma spec! Protocolo para APIs ?
11. Motivação
12. Quem solicita decide o que quer receber (somente o que precisa) Essa é a premissa básica, motivo de sua criação
13. No REST não é assim Em uma API REST é preciso criar um novo endpoint para receber uma resposta com estrutura de dados diferente
14. Netflix
15. GraphQL REST
16. • Representational State Transfer • Verbos HTTP (GET, POST, PUT, DELETE, HEAD…) • Resource based URLs - Endpoint (/movie/10) • RESTful: capacidade de determinado sistema aplicar os conceitos REST REST (ful) API
17. Action-based URL x Resource-based URL
19. Como ficam as URLs no GraphQL?
20. Buscando dados com REST GET /babies
21. Buscando dados com GraphQL POST /graphql
22. Buscando dados por ID com REST GET /babies/1
23. Buscando dados por ID com GraphQL POST /graphql
24. Salvando dados com REST POST /babies
25. Salvando dados com GraphQL POST /graphql
26. Filtrando dados com REST POST /babies?name=joaquim
27. Filtrando dados com GraphQL POST /graphql
28. ★ Baixo custo de mudança ★ Mais poder para o front-end Duas grandes vantagens do GraphQL
29. Vamos entender como a mágica acontece
30. 1. Single endpoint 2. Well defined contract (tem schema, é tipado - o REST é schemaless, não tem contrato) 3. No more overfetching 4. No more underfetching (vários endpoints para uma feature) Conceitos fundamentais do GraphQL
31. • Documentação: auto-documentação através do Schema ◦ Chamada de introspection retorna o Schema • Legibilidade da API: sem “salada” de URLs • Menos tráfego de dados no cliente: payload menor • Tempo de desenvolvimento do back-end focado em regras de negócio e qualidade, e não em “ajudar” o front-end Problemas comuns que o GraphQL resolve
33. Problema de versionamento
34. Int: A signed 32‐bit integer Float: A signed double-precision floating-point value String: A UTF‐8 character sequence Boolean: True ou false ID: Unique identifier (não legível para humanos) Tipos primitivos Tipos e schema Enum, custom scalar, listas e non-null
35. Interface
36. Union Types
37. O GraphQL trabalha com o conceito de estado Queries e Mutations
38. Exemplo de query e mutation
39. Resolvers Responsável pela magia mais poderosa
40. Suporte a real time Subscription
41. ★ Sobrecarga de responsabilidades no front-end funciona para todos os times e projetos? ★ Nada impede o dev de escrever (é até fácil) uma query com potencial destrutivo para sua app (ex.: sem paginação) ★ Ainda precisa evoluir/padronizar os processos de autorização de acesso GraphQL não é bala de prata
42. Outros protocolos para APIs
43. GraphQL como API Gateway
46. Links úteis ★ https://graphql-ruby.org/ ★ https://www.howtographql.com/graphql-ruby/1-getting-started/ ★ https://github.com/rmosolgo/graphql-ruby/blob/master/guide s/fields/resolvers.md ★ https://github.com/graphql/graphiql
47. Show me the code! https://github.com/fernandohenriques/graphql-on-rails
48. Obrigado!