简介
RESTful API 和 GraphQL 都是前端开发中常用的 API 架构，它们都可以通过 HTTP 协议来传递数据，但是它们有着不同的设计思想和实现方式。本文将会对它们进行一些比较，分析它们的优缺点并给出适用场景。
RESTful API
RESTful API 是一种基于 HTTP/HTTPS 的 Web API 架构风格，它是一种符合 REST（Representational State Transfer）原则的 API 设计，REST 原则中的资源概念很好地体现了 RESTful API 的设计思想，它强调使用统一接口用于访问所有种类的资源。在 RESTful API 中，资源用 URI 表示，资源的状态信息由客户端和服务端之间的交互确定。
RESTful API 主要的 HTTP 方法有 GET、POST、PUT、DELETE、HEAD、OPTIONS、PATCH 等，分别表示资源的查询、创建、更新、删除、获取头部信息、获取资源允许的 HTTP 方法、局部更新资源。RESTful API 返回的数据结构一般是 JSON 或 XML。
GraphQL
GraphQL 是一种由 Facebook 进行开发的 API 查询规范和运行时环境，它提供了一种更高效、强大和灵活的方法来读取和修改数据。GraphQL 的核心理念是：由客户端来定义获取的数据，而不是服务端。
GraphQL 的数据查询语言类似于 JSON 格式，查询请求使用 POST 方法，请求中包含 GraphQL 的查询语句和变量，服务端会根据查询语句返回所需的数据。GraphQL 的数据响应格式与查询语句相关，客户端可以在查询语句中定义需要哪些字段和数据。GraphQL 的数据是按需获取的，客户端可以有效控制请求数据的大小和复杂度。
优点和缺点
GraphQL和RESTful API从很多方面来看都有各自的优缺点：
| GraphQL | RESTful API | |
|---|---|---|
| 优点 | 1. 可以减少请求次数；2. 客户端可以精确控制所需的数据；3. 查询请求能够做到精细化日志；4. 客户端不直接受服务端数据格式的限制 | 1. 操作方式符合 HTTP 协议的习惯，容易上手；2. 资源链接在请求中体现，便于维护和扩展；3. 通过 HTTP 缓存机制来提高性能 |
| 缺点 | 1. 服务端需要额外的实现和支持；2. 编写复杂的查询请求非常困难；3. 缓存机制难以实现；4. 客户端多次查询API易导致服务器压力增加等 | 1. 返回数据结构和 API 的不稳定性，会使客户端在需要转换 API 格式的过程中出现问题；2. 会存在不同服务端域名异构问题；3. 服务器对不同类型非 RESTful API 的支持程度参差不齐 |
适用场景
- 适用 RESTful API 的场景：
适用于接口相对简单，资源结构相对简单的场景。RESTful API 的设计重点就是资源，简单的业务系统可以通过 API 轻松进行管理。
- 适用 GraphQL 的场景：
适用于接口复杂，资源结构多样的场景。GraphQL 可以方便开发人员精准地掌控数据的获取和传递，适用于复杂业务系统中使用。
示例代码
以 Node.js 为例，实现 RESTful API 和 GraphQL 的示例代码：
-- -------------------- ---- -------
-- ------- ---
----------------- ------------- ---- -
------------- ------------- ------ -
----------------
---
---
------------------ ------------- ---- -
--- ---- - --- ---------------
----------------------- ----- -
---------------
---
---
------------------------- ------------- ---- -
--------------------------- ------------------- --------- ----- ------ ------------- ----- -
---------------
---
---
---------------------------- ------------- ---- -
----------------- ------------------- ------------- -
---------- -------- ------------- -------- ---
---
---
-- -------
--- -------- - --- -------------------
----- -------
------- -
--- - ----- --------- --
----- - ----- ------------- --
---- - ----- ---------- --
------- - ----- ------------- -
-
---
--- ------ - --- ---------------
------ --- -------------------
----- --------
------- -
------ -
----- --- ----------------------
-------- ---------------- ----- -------- ----- -
------ --------------
-
-
-
---
--------- --- -------------------
----- -----------
------- -
-------- -
----- ---------
----- -
----- - ----- --- ----------------------------- --
---- - ----- --- -------------------------- --
------- - ----- --- ----------------------------- -
--
-------- ---------------- ----- -------- ----- -
--- ---- - --- -----------
------ ------------
-
-
-
--
---
------------------- -------------
------- -------
---------- ---
--------- ----
----结论
RESTful API 和 GraphQL 都具有优缺点，在实际项目开发中需要根据具体需求和资源情况选择适合的 API框架。使用 RESTful API 可以管理简单的资源和数据，而使用 GraphQL 可以快速扩展和复杂查询数据。在服务端实现时也需要根据具体情况和技术选型进行抉择。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6716dd3aad1e889fe21e6635