GraphQL學(xué)習(xí):Github GraphQL API v4初探

GraphQL學(xué)習(xí):Github GraphQL API v4初探

查看GithubAPI的時(shí)候粥诫,發(fā)現(xiàn)github API升級(jí)成了V4,并且叫GraphQL API v4肃廓。不禁大吃一驚,這是個(gè)什么東東。

什么是GraphQL

GraphQL(Graph Query Language):GraphQL 是一個(gè)用于 API 的查詢語(yǔ)言容诬,是一個(gè)使用基于類型系統(tǒng)來(lái)執(zhí)行查詢的服務(wù)端運(yùn)行時(shí)(類型系統(tǒng)由你的數(shù)據(jù)定義)。

GraphQL是一門語(yǔ)言沿腰,專門用于API查詢览徒。可以類比到SQL颂龙,這種類型的語(yǔ)言學(xué)名叫DSL(domain-specific language)习蓬,譯作領(lǐng)域?qū)S谜Z(yǔ)言

為什么Github選用GraphQL呢?因?yàn)镚raphQL具有以下好處:

  • 更大的靈活性
  • 精確定義所需數(shù)據(jù)的能力(GraphQL擁有強(qiáng)類型)
  • 僅僅會(huì)返回你需要的數(shù)據(jù)(避免數(shù)據(jù)冗余)
  • GraphQL允許您通過(guò)一次調(diào)用替換多個(gè)REST請(qǐng)求以獲取指定的數(shù)據(jù)

放一張來(lái)自圖說(shuō)明下工作過(guò)程:

image

看起來(lái)與原本的REST API沒什么兩樣措嵌。

是的躲叼,大致的工作流程就是如此,不過(guò)GraphQL作為一門語(yǔ)言企巢,其中有許多的概念和語(yǔ)法押赊。但是我不想純粹做官方文檔的copyer,而是作為官方文檔的一個(gè)導(dǎo)學(xué)包斑,具體的概念和語(yǔ)法可以去

GraphQL中文網(wǎng)學(xué)習(xí)流礁。

相信你也不愛一下子看到超多陌生概念,我們還行邊用邊學(xué)吧

初探

github提供了GraphQL Explorer來(lái)輔助GraphQL學(xué)習(xí)

一個(gè)小小案例

打開GraphQL Explorer這里我們先來(lái)運(yùn)行下面的代碼:

query { 
  viewer { 
    login
  }
}

這段代碼可以查詢你github的用戶名罗丰,注意神帅,請(qǐng)先登錄。

我運(yùn)行的結(jié)果:

{
  "data": {
    "viewer": {
      "login": "smarxpan"
    }
  }
}

這里你可能會(huì)產(chǎn)生疑惑萌抵,為什么接口可以這樣請(qǐng)求找御,到底發(fā)生了什么魔法元镀?

打開抓包軟件,我們來(lái)抓個(gè)包看看霎桅。

上面的請(qǐng)求栖疑,實(shí)際上發(fā)送的內(nèi)容仍舊是個(gè)json:

{
    "query": "query { \n  viewer { \n    login\n  }\n}",
    "variables": {}
}

這里沒有什么魔法,我們看到那段代碼的內(nèi)容作為query參數(shù)的值發(fā)送給了服務(wù)端滔驶,服務(wù)端按照語(yǔ)法對(duì)其進(jìn)行解析遇革,然后返回給我們需要的值。

小小案例的具體解釋

query { 
  viewer { 
    login
  }
}

這一小段的第一句:query

GraphQL中有兩種操作:query和mutation揭糕。query代表查詢萝快,mutation是變更。查詢就是請(qǐng)求數(shù)據(jù)著角,而變更揪漩,對(duì)應(yīng)REST API的POST/PATCH/DELETE。

這兩種操作使用的請(qǐng)求方式均為post吏口,get請(qǐng)求在GraphQL不常用奄容。

query的結(jié)構(gòu)類似:

query {
  JSON objects to return
}

其內(nèi)部定義的是要返回?cái)?shù)據(jù)的json結(jié)構(gòu)。

學(xué)習(xí)和使用指引

最佳的示例當(dāng)然是《Github GraphQL Guides》产徊,其中有示例昂勒、可運(yùn)行,里面的每段代碼都可點(diǎn)擊到explorer里運(yùn)行囚痴。

語(yǔ)法學(xué)習(xí)還是推薦GraphQL中文網(wǎng):《GraphQL 入門》

還有一篇博客我覺得特別棒叁怪,是Leetcode工作的一位大神的《阻礙你使用 GraphQL 的十個(gè)問(wèn)題》

而真正使用到工作中,當(dāng)然少不了庫(kù)的使用

GraphQL服務(wù)端庫(kù)

GraphQL客戶端庫(kù)

目前主流的開發(fā)語(yǔ)言均有具體實(shí)現(xiàn)深滚,取決于你使用的是哪一種語(yǔ)言奕谭,選擇自己的開發(fā)庫(kù)用起來(lái)。

結(jié)語(yǔ)

新技術(shù)無(wú)疑是讓人興奮的痴荐,GraphQL確實(shí)解決了不少痛點(diǎn)血柳,如果項(xiàng)目沒什么歷史包袱可以搞一搞。Github作為世界上最大的同性交友網(wǎng)站生兆,其在API上使用該語(yǔ)言相信會(huì)帶動(dòng)業(yè)界的進(jìn)步难捌,學(xué)就完了。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末鸦难,一起剝皮案震驚了整個(gè)濱河市根吁,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌合蔽,老刑警劉巖击敌,帶你破解...
    沈念sama閱讀 216,372評(píng)論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異拴事,居然都是意外死亡沃斤,警方通過(guò)查閱死者的電腦和手機(jī)圣蝎,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)衡瓶,“玉大人徘公,你說(shuō)我怎么就攤上這事∠耄” “怎么了关面?”我有些...
    開封第一講書人閱讀 162,415評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)诚撵。 經(jīng)常有香客問(wèn)我缭裆,道長(zhǎng)键闺,這世上最難降的妖魔是什么寿烟? 我笑而不...
    開封第一講書人閱讀 58,157評(píng)論 1 292
  • 正文 為了忘掉前任,我火速辦了婚禮辛燥,結(jié)果婚禮上筛武,老公的妹妹穿的比我還像新娘。我一直安慰自己挎塌,他們只是感情好徘六,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,171評(píng)論 6 388
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著榴都,像睡著了一般待锈。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上嘴高,一...
    開封第一講書人閱讀 51,125評(píng)論 1 297
  • 那天竿音,我揣著相機(jī)與錄音,去河邊找鬼拴驮。 笑死春瞬,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的套啤。 我是一名探鬼主播宽气,決...
    沈念sama閱讀 40,028評(píng)論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼潜沦!你這毒婦竟也來(lái)了萄涯?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 38,887評(píng)論 0 274
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤唆鸡,失蹤者是張志新(化名)和其女友劉穎涝影,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體喇闸,經(jīng)...
    沈念sama閱讀 45,310評(píng)論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡袄琳,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,533評(píng)論 2 332
  • 正文 我和宋清朗相戀三年询件,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片唆樊。...
    茶點(diǎn)故事閱讀 39,690評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡宛琅,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出逗旁,到底是詐尸還是另有隱情嘿辟,我是刑警寧澤,帶...
    沈念sama閱讀 35,411評(píng)論 5 343
  • 正文 年R本政府宣布片效,位于F島的核電站红伦,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏淀衣。R本人自食惡果不足惜昙读,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,004評(píng)論 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望膨桥。 院中可真熱鬧蛮浑,春花似錦、人聲如沸只嚣。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)册舞。三九已至蕴掏,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間调鲸,已是汗流浹背盛杰。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評(píng)論 1 268
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留线得,地道東北人饶唤。 一個(gè)月前我還...
    沈念sama閱讀 47,693評(píng)論 2 368
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像贯钩,于是被迫代替她去往敵國(guó)和親募狂。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,577評(píng)論 2 353

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