使用ASP.NET Core開發GraphQL伺服器 -- 預備知識(下)

solenovex發表於2018-10-04

上一篇文章:https://www.cnblogs.com/cgzl/p/9734083.html

處理資料

巢狀欄位

看例子:

我想檢視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成功後返回的欄位。

然後在左下方設定好引數,執行操作即可。

右側是返回的結果。

 

我們再反查一遍,看看是否新增了新的評論:

我點選了兩次,所以新增加了兩個評論。

 

好吧簡介就寫到這吧,儘管很不完整。

下篇開始實戰。

 

相關文章