之前做的需求,基本都是REST风格,以github提供的api为例,比较二者差异。试用GraphQL,找寻其独到之处


<h3 align="center"> <font color="orange">
REST
</font></h3>

REST

  • 一个URI代表一种资源
  • 通过HTTP动词对资源进行操作


创建一个仓库为例

GET,

PATCH
DELETE类似



<h3 align="center">
<font color="orange">GraphQL</font>
</h3>

  • GraphQL的endpoint只有一个
  • 所有请求都是POST


可以在 Exploer左边写查询,右边显示结果。

查询当前登录的用户名:

查询Go项目当前的star数:


GraphQL的endpoint只有一个,即

https://api.github.com/graphql

使用Postman:


使用querymutation来区分是查询还是修改


<h3 align="center"> <font color="orange">
二者区别
</font></h3>

  • REST一个URI就是一个资源,GraphQL只有一个URI
  • REST返回所有的内容,response体积较大,GraphQL可以只返回需要的数据,返回值体积小

GraphQL是一种语言,有自己的语法和类型系统

会有错误提示~


GraphQL的优势:

  • 取你所需要的数据,不多也不少

           n+1问题

  • nesting(嵌套查询)

            比如想取一个pr的commits、comment、reviews,用REST需要请求四次,然后还需要对返回值进行组装;而用GraphQL则只需要一次请求,拿到的就是需要的数据

资源孤岛 (REST) vs Graph(GraphQL)

graphql-voyager

  • 强类型(每一个GraphQL的请求发到服务端之后,服务端都会进行校验,不通过会报错)

Migrating from REST to GraphQL


参考:

为什么GraphQL比REST好用?

本文由mdnice多平台发布


好文收藏
38 声望6 粉丝

好文收集