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

上一篇文章：

处理数据

嵌套字段

看例子：

我想查看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成功后返回的字段。

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

右侧是返回的结果。

 

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

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

 

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

下篇开始实战。