再见 REST,你好 GraphQL

开发 前端
对于稍微复杂的关联查询,就显得不太合适:如果设计一个 REST 接口,一般情况下会返回关联表的全部字段,以满足更多类似的查询需求,如果设计多个细粒度接口,前端就需要查询很多次,自己拼装数据。

写过前端的都知道,REST 风格的 API 适合简单的增删改查。对于稍微复杂的关联查询,就显得不太合适:如果设计一个 REST 接口,一般情况下会返回关联表的全部字段,以满足更多类似的查询需求,如果设计多个细粒度接口,前端就需要查询很多次,自己拼装数据。粗粒度的接口导致不必要的数据传输,细粒度的接口导致函数爆炸,你见过 JavaScript 的 Promise 满天飞吧。

在此情景下 Facebook 的工程师于 2015 年开源了 GraphQL 规范,让前端自己描述自己希望的数据形式,服务端则返回前端所描述的数据结构。简单的来说,前端要啥,后端就返回啥,非常灵活。

什么是 GraphQL?

简单来说,GraphQL 是一种面向数据的 API 查询风格,把所有数据都视为已连接的图形,客户端能够准确地获得它需要的数据,没有任何冗余,也让 API 更容易地随着时间推移而演进,还能用于构建强大的开发者工具。

比如,前端只需要 hero 的 name,那么后端就只返回这个 name,没有冗余:

再比如:前端需要显示作者的帖子信息,作者本人的信息,作者的关注者列表,假如是 REST,前端需要请求这三个接口,再组装:

  • /user/获取用户(作者)详细信息,可能是名称。
  • /user//posts 获取该用户发布的帖子列表。
  • /user//followers 获取用户的关注者列表。

现在我们可以通过 GraphQL 的一次查询拿到全部信息,无需从好几个异步 API 里面来回找:

  1. query { 
  2.   User(id: '123') { 
  3.     name 
  4.     posts { 
  5.       title 
  6.     } 
  7.     followers { 
  8.       name 
  9.     } 
  10.   } 

简洁明了,不是吗?

GraphQL 带来的改变

目前应用开发的主流就是前后端分离,前后端只通过 API 来交流,结构大概如下图:

如果使用 GraphQL,那么后端将不再生产 API,而是将 Controller 层维护为 Resolver,和前端约定一套 Schema,这个 Schema 将用来生成接口文档,前端直接通过 Schema 或生成的接口文档来进行自己期望的请求。

经过几年一线开发者的填坑,已经有一些不错的awesome-graphql(https://github.com/chentsulin/awesome-graphql)用于开发与生产,很多语言也提供了对 GraphQL 的支持,比如 JavaScript/Nodejs、Java、PHP、Ruby、Python、Go、C# 等。

GraphQL 的使用趋势

一些比较有名的公司正在转换 REST API 到 GraphQL,比如 Twitter、IBM、Coursera、Airbnb、Facebook、Github、携程等,特别是 Github,它的 v4 版外部 API 只使用 GraphQL。据一位在 Twitter 工作的大佬说硅谷不少一线二线的公司都在想办法转到 GraphQL 上,但是同时也说了 GraphQL 还需要时间发展,因为将它使用到生产环境需要前后端大量的重构,这无疑需要高层的推动和决心。

GraphQL 的局限性

对于简单的应用程序而言,设置类型、查询等可能会有些复杂,相比之下 REST 可以更轻松完成。

对于复杂的查询,GraphQL 只需要一次接口请求,这样虽然网络层面的请求数被优化了,但是数据库层面的查询可一点都不少,数据库查询可能会成为性能瓶颈,还有很大的优化空间。

GraphQL 的优势

检索精确的数据,没有冗余。通常,当数据需求发生变化时,您只需要修改查询,并且不需要太多更改,从而提高前后端的开发效率,可以快速进行产品迭代。

最后的话

 

GraphQL 已经被各种体量的团队所使用,在不同的环境、不同的语言下,用于增强移动应用、网站和 API。如果你已经厌倦了 REST API,现在是时候学习一下 GraphQL 了。关注公众号「Python七号」,学习更多技术干货。

 

责任编辑:武晓燕 来源: Python七号
相关推荐

2021-01-13 11:13:46

ExcelPandas代码

2012-08-01 09:50:09

HotmailOutlook微软

2015-03-16 11:09:28

MongoDBPostgreSQL数据迁移

2021-07-27 05:56:53

CrocFTPSFTP

2019-02-01 10:35:33

PythonGo语言编程语言

2020-09-27 11:15:37

可视化PandasPython

2009-03-30 08:44:22

微软Windows 7操作系统

2018-01-02 08:40:19

云安全云迁移数据泄露

2023-11-28 17:24:45

2023-11-09 09:13:48

GraphQLAPI 架构

2011-01-07 18:05:37

QQ腾讯移动互联网

2024-04-16 12:00:14

API系统

2022-05-06 09:52:17

REST接口API

2021-06-02 22:25:26

2G5G运营商

2014-11-27 14:26:46

苹果iPhone停产

2023-04-10 07:40:36

GraphQLRest通信模式

2023-03-10 15:03:37

Web 应用程序API开发

2024-06-24 00:20:00

API应用程序接口

2023-03-16 18:04:00

APIWeb 应用程序开发

2022-08-02 19:03:19

RestAPI集成
点赞
收藏

51CTO技术栈公众号