之前做的需求,基本都是REST风格,以github提供的api为例,比较二者差异。试用GraphQL,找寻其独到之处
<h3 align="center"> <font color="orange">
REST
</font></h3>
- 一个URI代表一种资源
- 通过HTTP动词对资源进行操作
以创建一个仓库为例
GET,
<h3 align="center">
<font color="orange">GraphQL</font>
</h3>
- GraphQL的endpoint只有一个
- 所有请求都是POST
可以在 Exploer左边写查询,右边显示结果。
查询当前登录的用户名:
查询Go项目当前的star数:
GraphQL的endpoint只有一个,即
https://api.github.com/graphql
使用Postman:
使用query和mutation来区分是查询还是修改
<h3 align="center"> <font color="orange">
二者区别
</font></h3>
- REST一个URI就是一个资源,GraphQL只有一个URI
- REST返回所有的内容,response体积较大,GraphQL可以只返回需要的数据,返回值体积小
GraphQL是一种语言,有自己的语法和类型系统
会有错误提示~
GraphQL的优势:
- 取你所需要的数据,不多也不少
- nesting(嵌套查询)
比如想取一个pr的commits、comment、reviews,用REST需要请求四次,然后还需要对返回值进行组装;而用GraphQL则只需要一次请求,拿到的就是需要的数据
资源孤岛 (REST) vs Graph(GraphQL)
- 强类型(每一个GraphQL的请求发到服务端之后,服务端都会进行校验,不通过会报错)
Migrating from REST to GraphQL
参考:
本文由mdnice多平台发布
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。