GraphQL(三)

一、改造定义的方式

把类型的定义改造成构造类型的定义：

在之前都用的是type { },里面跟的是字段。构造形式是借助GraphQLObjectType这个函数来定义，将字段定义在fields中，并且每个字段中都有type。

好处：方便维护，使用字符串定义的如果出错了，不好维护。例如：我们的定义的字符串非常的长，但是他报错的时候就只会报buildSchema这一行出错。

如果改成这种构造函数类型的话，哪里出错就会知道是那个type出错。

1、使用GraphQLObjectType定义type(类型)



2、使用GraphQLObjectType定义query(查询)

3、创建Schema

也就是把之前的定义Schema分成了三个步骤来完成，这样是非常便于维护的。

二、查询与变更

这里我们引入官网的例子来进行说明，首先去github上面克隆代码。

1.克隆代码：git clone https://github.com/apollographql/starwars-server

2. 进入根目录 ： cd starwars-server

3. 安装包 ：npm install

4. 启动项目 : npm start

字段

在GraphQL的查询中，请求结构中包含了所预期结果的结构，这个就是字段。并且响应的结构和请求结构基本一致，这是GraphQL的一个特性，这样就可以让请求发起者很清楚的知道自己想要什么。

这里在请求的时候，默认的是query，这里也可以不写query，使用{ }直接进行查询，但是这样查询就相当于我们js中的匿名函数一样，所以我们可以在查询的时候去给他起个名字。如果我们有很多的query没有定义的话，在代码中就不方便去找到它，起个名字就能方便的定位到它。

别名

如果一次查询多个相同对象，但是值不同，这个时候就需要起别名了，否则json的语法就不能通过了。

可以看出，两个 hero 字段将会存在冲突，但是我们可以给他另取一个别名，我们也就可以在一次请求中得到两个结果。

当然我们也可以给hero里面的字段起个别名：

片段

查询的属相如果相同，可以采用片段的方式进行简化定义。

采用片段形式进行查询

我们使用片段的方式查询了重复的字段。片段的概念经常用于将复杂的应用数据需求分割成小块，特别是将大量不同片段的 UI 组件组合成一个初始数据获取的时候。

变量

一般情况下，我们将参数写在了查询字符串内。但是在很多应用中，字段的参数可能是动态传递的。如果将这些动态参数直接传进查询字符串并不好，GraphQL可以将动态值提取到查询之外，然后作为分离的字典传进去。这些动态值即称为变量。

传递参数的时候，可以使用QUERY VARIAVBLES 里面进行定义。

由于这里的Episode是枚举类型，由于这里的枚举类型只定义了三种形式，所以它的值只能是这三种类型。我们可以按shift+空格键 来查看这里需要填写的内容。


变量和参数的区别 ：

参数：放在字段后面，用来定制化的查询字段。

变量：服务于参数，解决参数不是写死的，而是用户传递进来的。

变更

Mutation的中文意思就是“修改，变更”。任何查询都可以被实现为导致数据写入。建立一个约定来规范任何导致写入的操作都应该通过变更（mutation）来发送。

mutation会返回一个对象，之后可以继续查询返回的对象。修改数据后，可以在同一个请求中查询修改后的数据。

内联片段

GraphQL schema 具备定义接口和联合类型的能力。如果要查询的字段返回的是接口或者联合类型，那么可能需要使用内联片段来取出下层具体类型的数据：

hero这个查询返回的Character是一个接口类型，Human和Droid实现了这个接口。这样Human和Droid就会有Character所有的字段，同时它也有它自己的字段。但是由于hero它返回的类型是Character，所以我们只能查询Character上面的字段，如果查询Droid自己的字段时，就会报错。

因此，这里使用内联片段来进行查询。

元字段

当我们不知道要 GraphQL 服务中获得什么类型，这时候就需要一些方法在客户端来决定如何处理这些数据。GraphQL 允许在查询的任何位置请求 __typename，一个元字段，以获得那个位置的对象类型名称。
例如：下面这个union类型中的Human、Droid、Starship之前没有任何关联。

并且Human、Droid、Starship没有一个具体的返回字段，我们可以使用__typename来查看返回的具体的类型。

然后根据这个返回的类型来定义片段，进行查询。