GraphQL 基礎(chǔ)教程

前置知識:React/Redux/Restful API

關(guān)于為什么要使用GraphQL 前面已有幾篇文章鋪墊蜡豹,這里主要總結(jié)用法炬灭。開始使用GraphQL之前,要安裝一些依賴:

apollo-boost 包含啟動阿波羅客戶端的所有依賴
react-apollo  視圖層面的集合
graphql-tag  解析查詢語句必須
graphql 也是解析查詢語句

強烈安利https://codesandbox.io運行實踐,可以減少電腦文件夾的凌亂感……下圖是安裝依賴的步驟:

安裝依賴

初始化完成后,頁面顯示正常嗡害。這時需要從依賴里引入幾樣東西:

引入ApolloClient并新建一個實例client;
引入ApolloProvider并且包裹頁面組件畦攘,ApolloProvider有一個屬性client用于連接GraphQL和React霸妹,它的用法類似Redux里的Provider。
引入gql用于解析GraphQL知押;
引入Query組件用于包裹頁面組件叹螟。

Query組件是這個項目里面最重要的組件之二,另外一個是Mutation台盯“照溃可以認為他們分別對應(yīng)著Restful API 里面的GET和POST/PUT/DELETE等功能。
以下圖查詢狗類品種為例静盅,在第12行g(shù)ql語句部分聲明查詢狗的id和breed種類良价。然后第28行將該查詢語句作為Query組件的query屬性值,在第33行渲染部分,我們遍歷返回值明垢,在頁面顯示所有的狗的品種名稱蚣常,得到右圖的結(jié)果。

查詢狗的品種

如果我們只想查詢某一品種的狗的圖片痊银,可以通過variables屬性傳遞參數(shù)抵蚊,在第16行查詢語句里新增查詢的字段名,第23行傳遞我們想查詢的實參mix溯革,第28行添加形參breed品種贞绳,右圖也成功地查詢到了該品種的圖片。
傳參查看具體品種的圖片

Query部分的基本用法就是這樣鬓照,如果還有顯示加載狀態(tài)熔酷、錯誤處理、輪詢和重新獲取的需求豺裆,可以繼續(xù)參閱文檔拒秘。https://www.apollographql.com/docs/react/essentials/queries.html
相比Query部分,Mutation部分復(fù)雜一點臭猜,但是道理是相通的躺酒。這里以(萬年不變的)新增和編輯TODO為例,項目包括1個Query和2個Mutation蔑歌,Query部分總是查詢當前的待辦事項羹应,Mutation部分則是處理新增和編輯的操作。
新增編輯待辦事項例子

可以看到次屠,兩處的gql語句的寫法园匹,我們要拿到的值只有事項的id 和 事項內(nèi)容的type 兩個。
兩條mutation語句

寫一個輸入框劫灶,點擊新增按鈕后裸违,輸入框的內(nèi)容便新增到了頁面,Mutation的屬性只有mutation和children是必須的本昏。
其他的屬性也可圈可點供汛,update有很多實用的方法,比如可以通過cache.readQuery 和 cache.writeQuery查詢和修改Query涌穆,就好像是和服務(wù)端通信一樣怔昨,update第二個參數(shù)是一個包含Mutation結(jié)果的對象。
optimisticResponse 可以讓頁面響應(yīng)更快宿稀,你的調(diào)用會被執(zhí)行兩次趁舀,一次是頁面的結(jié)果,另一次是真實的結(jié)果祝沸。比如一個評論功能矮烹,當你點擊提交按鈕的時候巡蘸,頁面立即就更新了而無需等待服務(wù)端響應(yīng)。
新增部分update第一個參數(shù)是cache

更新部分mutation嵌套在query里
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末擂送,一起剝皮案震驚了整個濱河市悦荒,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌嘹吨,老刑警劉巖搬味,帶你破解...
    沈念sama閱讀 221,430評論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異蟀拷,居然都是意外死亡碰纬,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,406評論 3 398
  • 文/潘曉璐 我一進店門问芬,熙熙樓的掌柜王于貴愁眉苦臉地迎上來悦析,“玉大人,你說我怎么就攤上這事此衅∏看鳎” “怎么了?”我有些...
    開封第一講書人閱讀 167,834評論 0 360
  • 文/不壞的土叔 我叫張陵挡鞍,是天一觀的道長骑歹。 經(jīng)常有香客問我,道長墨微,這世上最難降的妖魔是什么道媚? 我笑而不...
    開封第一講書人閱讀 59,543評論 1 296
  • 正文 為了忘掉前任,我火速辦了婚禮翘县,結(jié)果婚禮上最域,老公的妹妹穿的比我還像新娘。我一直安慰自己锈麸,他們只是感情好镀脂,可當我...
    茶點故事閱讀 68,547評論 6 397
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著掐隐,像睡著了一般狗热。 火紅的嫁衣襯著肌膚如雪钞馁。 梳的紋絲不亂的頭發(fā)上虑省,一...
    開封第一講書人閱讀 52,196評論 1 308
  • 那天,我揣著相機與錄音僧凰,去河邊找鬼探颈。 笑死,一個胖子當著我的面吹牛训措,可吹牛的內(nèi)容都是我干的伪节。 我是一名探鬼主播光羞,決...
    沈念sama閱讀 40,776評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼怀大!你這毒婦竟也來了纱兑?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,671評論 0 276
  • 序言:老撾萬榮一對情侶失蹤化借,失蹤者是張志新(化名)和其女友劉穎潜慎,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體蓖康,經(jīng)...
    沈念sama閱讀 46,221評論 1 320
  • 正文 獨居荒郊野嶺守林人離奇死亡铐炫,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,303評論 3 340
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了蒜焊。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片倒信。...
    茶點故事閱讀 40,444評論 1 352
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖泳梆,靈堂內(nèi)的尸體忽然破棺而出鳖悠,到底是詐尸還是另有隱情,我是刑警寧澤优妙,帶...
    沈念sama閱讀 36,134評論 5 350
  • 正文 年R本政府宣布竞穷,位于F島的核電站,受9級特大地震影響鳞溉,放射性物質(zhì)發(fā)生泄漏瘾带。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 41,810評論 3 333
  • 文/蒙蒙 一熟菲、第九天 我趴在偏房一處隱蔽的房頂上張望看政。 院中可真熱鬧,春花似錦抄罕、人聲如沸允蚣。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,285評論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽嚷兔。三九已至,卻和暖如春做入,著一層夾襖步出監(jiān)牢的瞬間冒晰,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,399評論 1 272
  • 我被黑心中介騙來泰國打工竟块, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留壶运,地道東北人。 一個月前我還...
    沈念sama閱讀 48,837評論 3 376
  • 正文 我出身青樓浪秘,卻偏偏與公主長得像蒋情,于是被迫代替她去往敵國和親埠况。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 45,455評論 2 359

推薦閱讀更多精彩內(nèi)容