上一篇文章: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成功後返回的欄位。
然後在左下方設定好引數,執行操作即可。
右側是返回的結果。
我們再反查一遍,看看是否新增了新的評論:
我點選了兩次,所以新增加了兩個評論。
好吧簡介就寫到這吧,儘管很不完整。
下篇開始實戰。