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