使用ASP.NET Core开发GraphQL服务器 -- 预备知识(下)

2018-10-10 10:33:28 浏览数 (1)

处理数据

嵌套字段

看例子:

我想查看viewer下的repositories。注意里面的edges,一旦看到这个词,通常就表示有连接到某个数组的数据。在这里就是一个集合的repository。

edges里面的node代表viewer列表里不同的repository。

查询报错了,因为这里需要多repositories有个翻页的动作,所以需要first或last参数。

添加first参数以后就可以看到正确的结果了:

把参数换成last也可以,我就不试了。

连接 Connection

查看Docs,可以看到viewer下repositories的返回类型是RepositoryConnection:

再点击进去:

可以看到RepositoryConnection下面的edges是一个RepositoryEdge的列表。

继续点击进去,可以看到RepositoryEdge下面的node就是一个Repository:

把上面的关系用图来表示就是:

多重嵌套字段

直接看例子就行:

翻页

之前的例子使用了first或last参数进行翻页,但除此之外还有很多种方式可以用来翻页。

具体如何翻页,还要看您如何在schema中定义。

下面再看一个例子:

查看文档,可以看到issues所有的参数定义:

它们都是用来过滤数据和进行翻页的。

为查询起名

之前的例子我们大多把query关键字忽略了,而完整的写法应该是:

query就像是查询的名称,但是如果都叫query就不好区分了,所以我们可以为查询起名,就在query后边加上名字即可:

这样这个查询既让人明白又可以复用。查询的结果还是一样的。

查询变量

之前例子的参数值都是写死的,我们可以在查询的名称后边加上参数变量,使用$ 名称表示变量,然后将变量传递给相应的字段。而变量的值可以在左下角的窗口里设定:

这个查询结果还是一样的。

变化 Mutation 

之前的例子都是查询数据。下面讲讲如何修改数据。

修改数据就需要用到 mutation

Mutation的特点如下:

  • 和REST里的POST,PUT和DELETE相似。
  • Mutation里使用payload发送数据。
  • GraphQL修改schema背后的数据集。
  • API定义了哪些mutation是允许的。

下面看例子,我要为一个Repository的Issue添加评论,首先查询,获得一个Issue的id:

然后做mutation:

这里使用mutation关键字,随后跟着mutation的名字和参数变量。该参数变量的类型是AddCommentInput,是一个定义好的对象。

addComment这个操作里面定义的字段是要在mutation成功后返回的字段。

然后在左下方设定好参数,执行操作即可。

右侧是返回的结果。

我们再反查一遍,看看是否添加了新的评论:

我点击了两次,所以新增加了两个评论。

好吧简介就写到这吧,尽管很不完整。

下篇开始实战。

0 人点赞