Como Criar Fragmentos Fragment para Incluir na Query (Aula Tutorial do Curso de GraphQL)
Summary
Resumo da Aula sobre Fragmentos
Nesta aula, abordamos o conceito de fragmentos em consultas (queries). Observamos que, frequentemente, repetimos as mesmas propriedades em diferentes consultas. Para evitar essa repetição, usamos fragmentos para reutilizar listas de propriedades.
Conceito de Fragmentos
Fragmentos permitem definir um conjunto de propriedades que podem ser reutilizadas em diferentes consultas. Por exemplo, se em todas as consultas queremos incluir id
e nome
de uma companhia, podemos criar um fragmento.
Exemplo de Criação de Fragmento
-
Definição do Fragmento:
- Palavras-chave:
fragment
- Nome do fragmento:
campos básicos da companhia
- Tipo do recurso:
companhia
- Propriedades:
id
e nome
fragment campos básicos da companhia on companhia {
id
nome
}
-
Uso do Fragmento:
Para usar o fragmento em uma consulta, basta adicionar ...
seguido do nome do fragmento:
{
companhia1: companhia(id: 1) {
...campos básicos da companhia
}
}
Aninhamento de Fragmentos
É possível criar fragmentos que incluem outros fragmentos. Por exemplo, podemos criar um novo fragmento chamado campos básicos com fundação da companhia
, que inclui id
e nome
de campos básicos da companhia
, além da propriedade fundado em
.
fragment campos básicos com fundação da companhia on companhia {
...campos básicos da companhia
fundadoEm
}
Exercício Proposto
- Experimente criar um fragmento que inclua a propriedade
fundado em
, utilizando um fragmento anterior. Ou, crie um novo fragmento para esta funcionalidade.
Conclusão
Os fragmentos são uma ferramenta poderosa para reutilizar código em consultas GraphQL, facilitando a manutenção e a legibilidade. Experimente diferentes combinações e estruturas de fragmentos. Até a próxima aula!
Video Transcript
Tamos de volta, nesta aula vamos falar de fragmentos.
Então, você note que, por exemplo, nós temos duas queries, né?
E cada query tem esta regala de companhia 1, companhia 3, tem este.
Note que a gente sempre quase fala as mesmas coisas.
E D não me fluidada N, e D não me fluidada N, e D não me fluidada N.
Então, não teria um método para a gente reutilizar este cara e falar só uma coisa
em vez de ficar se repetindo várias vezes.
Então, para isso que serve os fragmentos.
A gente vai definir fragmentos para poder reutilizar uma lista de propriedades
quando a gente faz a nossa queries.
Então, por exemplo, vamos supor que a gente sempre dá diz,
e D nome, e D nome, e D nome.
E este é o detalhe básico da companhia. A gente pode fazer um fragment.
Olha só, vou adicionar aqui a palavra-chave fragment.
Vou ter que dizer o nome deste fragment.
Vamos dizer campos básicos da companhia.
Pode nomear qualquer maneira que você quiser.
Aí você fala on e o recurso, companhia.
Aí abre as chaves e põe as propriedades que você quer reutilizar a lista,
e D nome.
Então, este é o nome do fragmento campos básico da companhia
on o nome do recurso, neste caso companhia, o tipo.
As propriedades que você quer copiar e reutilizar.
Por exemplo, estou aqui nessa query, obtendo duas companhias, e tem esse companhia ID1.
Eu não quero digitar ID e nome de novo aqui, eu posso fazer o seguinte.
Eu ponho o nome do fragmento, campos básico da companhia,
e adiciono o prefixo de três pontos.
Então, ele vai copiar propriedades desta fragmento, que nesse caso o ID1, o ID e o nome,
e vai pôr aqui e vai dar na mesma, tá?
Vou rodar duas companhias.
Na hora de que apareceu o ID e o nome, da mesma maneira.
E assim eu posso fazer para cá e para cá, quero ver você fazer aí.
E aí, vamos lá.
Em vez de digitar ID e nome de novo, você vai falar três pontos, o nome do fragmento.
Mesma coisa aqui, três pontos, o nome do fragmento.
Agora ele vai copiar o ID e o nome deste fragmento e vai substituir aqui em cada uma dessas queries.
Eu estou aqui, tá? Olha o ID e o nome.
Tá?
Esse é o fragmento. Você pode fazer vários fragmentos e reutilizar a lista de parâmetros,
em vez de digitar eles toda vez.
Se você quiser, por exemplo, mais um exercício, olha que o fundado está aparecendo aqui.
Você pode incluir isso numa fragmento, pode até usar esse fragmento,
ou pode fazer outro fragmento, se você quiser.
Por exemplo.
Fragment, mas eu estou fazendo fragmento.
Campos básico com fundação da companhia.
On, companhia.
Vamos ver se dá até para copiar os propriedades do fragmento aqui.
Três pontos, campos básicos da companhia e a adiciona fundada em.
Em vez de falar esses caras aqui, você pode falar esse fragment.
Vamos ver se funciona mesmo.
Tá, então funcionou aqui.
ID, nome, fundado em.
Então, o que é que eu fiz? Eu vou ter um fragmento dentro de outro fragmento.
Em vez de pôr fundado em aqui, que você poderia fazer, isso também está certo.
Eu queria só ilustrar que você pode botar fragmento dentro de outro fragmento.
Tem esse fragmento chamado básico com fundação da companhia,
que inclui as propriedades do fragmento campos básicos da companhia, que é o ID e o nome.
E, além disso, inclui a fundada em.
E eu fiz aqui, ó, copiar as propriedades do básico com fundação da companhia e apareceu aqui.
Tá.
Então, deixe como exercício para você usar...
fazer esperimentos com esse fundado em e outros aqui.
Então, pode adicionar aqui e usar só um fragmento,
ou pode criar um novo fragmento que copia de outro fragmento.
Tá, só come exercício.
Então, por essa aula é só e até a próxima.