之前做的需求,基本都是REST风格,以github提供的api为例,比较二者差异。试用GraphQL,找寻其独到之处
REST
-
一个URI代表一种资源
-
通过HTTP动词对资源进行操作
以创建一个仓库为例
GET,
GraphQL
-
GraphQL的endpoint只有一个
-
所有请求都是POST
可以在 Exploer左边写查询,右边显示结果。
查询当前登录的用户名:
查询Go项目当前的star数:
GraphQL的endpoint只有一个,即
https://api.github.com/graphql
使用Postman:
使用query 和mutation来区分是查询还是修改
二者区别
-
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
参考: