小试GraphQL

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


REST

REST[1]

  • 一个URI代表一种资源

  • 通过HTTP动词对资源进行操作


创建一个仓库[2]为例

小试GraphQL_第1张图片 小试GraphQL_第2张图片

GET[3],

PATCH[4]DELETE[5]类似



GraphQL

  • GraphQL的endpoint只有一个

  • 所有请求都是POST


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

查询当前登录的用户名:

小试GraphQL_第3张图片

查询Go项目当前的star数:

小试GraphQL_第4张图片

GraphQL的endpoint只有一个,即

https://api.github.com/graphql

使用Postman:

小试GraphQL_第5张图片

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

小试GraphQL_第6张图片

二者区别

  • REST一个URI就是一个资源,GraphQL只有一个URI

  • REST返回所有的内容,response体积较大,GraphQL可以只返回需要的数据,返回值体积小

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

小试GraphQL_第7张图片

会有错误提示~

小试GraphQL_第8张图片

GraphQL的优势:

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

           n+1问题[7]

  • nesting(嵌套查询)

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

小试GraphQL_第9张图片

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

graphql-voyager[8]

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

Migrating from REST to GraphQL[9]

小试GraphQL_第11张图片

参考:

为什么GraphQL比REST好用?[10]

参考资料

[1]

REST: https://docs.github.com/en/rest

[2]

创建一个仓库: https://docs.github.com/en/rest/reference/repos#create-a-repository-for-the-authenticated-user

[3]

GET: https://docs.github.com/en/rest/reference/repos#get-a-repository

[4]

PATCH: https://docs.github.com/en/rest/reference/repos#update-a-repository

[5]

DELETE: https://docs.github.com/en/rest/reference/repos#delete-a-repository

[6]

Exploer: https://docs.github.com/en/graphql/overview/explorer

[7]

n+1问题: https://segmentfault.com/a/1190000039421843

[8]

graphql-voyager: https://apis.guru/graphql-voyager/

[9]

Migrating from REST to GraphQL: https://docs.github.com/en/graphql/guides/migrating-from-rest-to-graphql

[10]

为什么GraphQL比REST好用?: https://www.bilibili.com/video/BV1f4411A7qA

本文由 mdnice 多平台发布

你可能感兴趣的:(后端)