RPC-RESTGraphQL三种API设计方式的简介和比较

RPC

RPC=remote procedure call，执行远程服务器上的一个 function，举例：
服务端定义了三个函数：

客户端发起请求

RPC 在一些大公司中依然被使用。
RPC 的优点有：

• 设计简洁，便于理解
• 轻量的 payload
• 很高的性能表现

缺点有：

• 前后端代码高耦合
• 代码可读性不好，相关代码不容易被定位
• 会导致有大量被定义的函数，难以管理

REST

REST = Representational state transfer，直接翻译就是『表现层状态转移』
优点：

• 前后端高度解耦
• 便于理解，即使没有看文档，也能大概知道接口是用来做什么的；
• 接口的功能有单一性，便于扩展和复用；
• 利用了 HTTP 原本的特性

缺点：

• 有时 payload 会变的特别大
• 同一个页面可能要调用很多个 API，来获取不同的东西，在网络差的情况下会降低体验

举例：

GraphQL

GraphQL = Graph query language
吸取了 RPC 和 REST 的一些共同优点；以查询为基本单元，方便获取到想要的数据，举例：
接口定义

接口调用

优点：

• 低网络速度下表现优异
• 声明式地数据获取
• 根据 UI 需求获取合适的数据，避免不必要的数据传输

缺点：

• 定义起来相对复杂
• 缓存问题，需要一个更加健全的机制中来确保字段级别的缓存
• 版本持续更新中，还不太成熟

综合对比与总结

API 设计也不会有银弹。
设计 API 时，决定使用哪种形式，得先考虑所设计的 API 将会被谁使用：

• 如果是关注于对象和资源的项目，需要对接各种不同的端和使用者，需要便于使用和阅读文档，那么适合使用 REST
• 如果是面向行为动作，或者内部的一些微服务，对响应要求高，那么可以考虑 RPC
• 如果是需要给 UI 提供数据，或者需要对弱网络环境下优化而减少请求，那么可以考虑 GraphQL

参考来源

https://www.youtube.com/watch…