graphql入门

字段:Fields

最简单的查询就是告诉 Graphql 你想要的字段是什么:

参数:Arguments

给字段添加参数。

别名:Aliases

使用别名,可以重命名结果里的字段的名字。

两个 字段有冲突,我们可以分别给它们起个别名,这样可以用一个请求就能同时得到这两个结果。

片断:Fragments

GraphQL 里的 fragments 创建可以重复使用的单元,fragments 的目的就是把应用里的经常用的复杂的数据需求分割成小块。

操作名:Operation name

在执行 query 以外的操作,或者传递动态变量的时候,在查询里必须得加上 GraphQL 操作。

操作类型可以是 query,mutation,或者 subscription 还有 describes

变量:Variables

查询可能是动态的,GraphQL 提供了一种方法,可以把查询中的动态值从查询里单独拿出来,放到一个独立的 dictionary 里面,这些动态值在 GraphQL 里叫变量(variables)。

使用变量,要做三件事:

  • 用 $variableName 替换查询中的静态值。
  • 声明 $variableName 是查询中可以接受的一个变量。
  • 用独立的变量字典传递 variableName: value 。

指令:Directives

使用指令,配合变量,可以动态地改变查询的结构。

GraphQL 有两个指令:

  • @include(if: Boolean),如果参数的值是 true 才会在查询结果中包含字段。
  • @skip(if: Boolean),参数的值如果是 true,忽略这个字段。

修改:Mutaions

修改数据用 mutation。

跟查询一样,在一个修改中也可以包含多个字段,不过一个重要的区别是,查询字段并行执行,修改字段是一个接一个地被执行。

传统的API使用场景中,我们会有需要修改服务器上数据的场景,mutations就是应这种场景而生。mutations被用以执行写操作,通过mutations我们会给服务器发送请求来修改和更新数据,并且会接收到包含更新数据的反馈。

日记本

如果觉得我的文章对您有用,请随意赞赏。您的支持将鼓励我继续创作!

赞赏支持
被以下专题收入,发现更多相似内容