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我们会给服务器发送请求来修改和更新数据，并且会接收到包含更新数据的反馈。