再見(jiàn) REST,你好 GraphQL
寫(xiě)過(guò)前端的都知道,REST 風(fēng)格的 API 適合簡(jiǎn)單的增刪改查。對(duì)于稍微復(fù)雜的關(guān)聯(lián)查詢,就顯得不太合適:如果設(shè)計(jì)一個(gè) REST 接口,一般情況下會(huì)返回關(guān)聯(lián)表的全部字段,以滿足更多類(lèi)似的查詢需求,如果設(shè)計(jì)多個(gè)細(xì)粒度接口,前端就需要查詢很多次,自己拼裝數(shù)據(jù)。粗粒度的接口導(dǎo)致不必要的數(shù)據(jù)傳輸,細(xì)粒度的接口導(dǎo)致函數(shù)爆炸,你見(jiàn)過(guò) JavaScript 的 Promise 滿天飛吧。
在此情景下 Facebook 的工程師于 2015 年開(kāi)源了 GraphQL 規(guī)范,讓前端自己描述自己希望的數(shù)據(jù)形式,服務(wù)端則返回前端所描述的數(shù)據(jù)結(jié)構(gòu)。簡(jiǎn)單的來(lái)說(shuō),前端要啥,后端就返回啥,非常靈活。
什么是 GraphQL?
簡(jiǎn)單來(lái)說(shuō),GraphQL 是一種面向數(shù)據(jù)的 API 查詢風(fēng)格,把所有數(shù)據(jù)都視為已連接的圖形,客戶端能夠準(zhǔn)確地獲得它需要的數(shù)據(jù),沒(méi)有任何冗余,也讓 API 更容易地隨著時(shí)間推移而演進(jìn),還能用于構(gòu)建強(qiáng)大的開(kāi)發(fā)者工具。
比如,前端只需要 hero 的 name,那么后端就只返回這個(gè) name,沒(méi)有冗余:
再比如:前端需要顯示作者的帖子信息,作者本人的信息,作者的關(guān)注者列表,假如是 REST,前端需要請(qǐng)求這三個(gè)接口,再組裝:
- /user/
獲取用戶(作者)詳細(xì)信息,可能是名稱(chēng)。  - /user/
/posts 獲取該用戶發(fā)布的帖子列表。  - /user/
/followers 獲取用戶的關(guān)注者列表。  
現(xiàn)在我們可以通過(guò) GraphQL 的一次查詢拿到全部信息,無(wú)需從好幾個(gè)異步 API 里面來(lái)回找:
- query {
 - User(id: '123') {
 - name
 - posts {
 - title
 - }
 - followers {
 - name
 - }
 - }
 - }
 
簡(jiǎn)潔明了,不是嗎?
GraphQL 帶來(lái)的改變
目前應(yīng)用開(kāi)發(fā)的主流就是前后端分離,前后端只通過(guò) API 來(lái)交流,結(jié)構(gòu)大概如下圖:
如果使用 GraphQL,那么后端將不再生產(chǎn) API,而是將 Controller 層維護(hù)為 Resolver,和前端約定一套 Schema,這個(gè) Schema 將用來(lái)生成接口文檔,前端直接通過(guò) Schema 或生成的接口文檔來(lái)進(jìn)行自己期望的請(qǐng)求。
經(jīng)過(guò)幾年一線開(kāi)發(fā)者的填坑,已經(jīng)有一些不錯(cuò)的awesome-graphql(https://github.com/chentsulin/awesome-graphql)用于開(kāi)發(fā)與生產(chǎn),很多語(yǔ)言也提供了對(duì) GraphQL 的支持,比如 JavaScript/Nodejs、Java、PHP、Ruby、Python、Go、C# 等。
GraphQL 的使用趨勢(shì)
一些比較有名的公司正在轉(zhuǎn)換 REST API 到 GraphQL,比如 Twitter、IBM、Coursera、Airbnb、Facebook、Github、攜程等,特別是 Github,它的 v4 版外部 API 只使用 GraphQL。據(jù)一位在 Twitter 工作的大佬說(shuō)硅谷不少一線二線的公司都在想辦法轉(zhuǎn)到 GraphQL 上,但是同時(shí)也說(shuō)了 GraphQL 還需要時(shí)間發(fā)展,因?yàn)閷⑺褂玫缴a(chǎn)環(huán)境需要前后端大量的重構(gòu),這無(wú)疑需要高層的推動(dòng)和決心。
GraphQL 的局限性
對(duì)于簡(jiǎn)單的應(yīng)用程序而言,設(shè)置類(lèi)型、查詢等可能會(huì)有些復(fù)雜,相比之下 REST 可以更輕松完成。
對(duì)于復(fù)雜的查詢,GraphQL 只需要一次接口請(qǐng)求,這樣雖然網(wǎng)絡(luò)層面的請(qǐng)求數(shù)被優(yōu)化了,但是數(shù)據(jù)庫(kù)層面的查詢可一點(diǎn)都不少,數(shù)據(jù)庫(kù)查詢可能會(huì)成為性能瓶頸,還有很大的優(yōu)化空間。
GraphQL 的優(yōu)勢(shì)
檢索精確的數(shù)據(jù),沒(méi)有冗余。通常,當(dāng)數(shù)據(jù)需求發(fā)生變化時(shí),您只需要修改查詢,并且不需要太多更改,從而提高前后端的開(kāi)發(fā)效率,可以快速進(jìn)行產(chǎn)品迭代。
最后的話
GraphQL 已經(jīng)被各種體量的團(tuán)隊(duì)所使用,在不同的環(huán)境、不同的語(yǔ)言下,用于增強(qiáng)移動(dòng)應(yīng)用、網(wǎng)站和 API。如果你已經(jīng)厭倦了 REST API,現(xiàn)在是時(shí)候?qū)W習(xí)一下 GraphQL 了。關(guān)注公眾號(hào)「Python七號(hào)」,學(xué)習(xí)更多技術(shù)干貨。



















 
 
 













 
 
 
 