利用 GraphQL 优化 RESTful API 的性能
随着互联网技术的不断发展，RESTful API 已经成为前后端交互的标准。RESTful API 可以通过标准 HTTP 接口实现跨语言、跨平台的通信。但是，RESTful API 的一些问题也日益凸显，例如 API 数据冗余，无法按需获取数据等。这时候，GraphQL 可以派上用场。
什么是 GraphQL？
GraphQL 是一个由 Facebook 开发的数据查询和操作语言，用于 API 的设计和实现。GraphQL 可以精确地获取所需数据，避免 API 数据冗余的问题。
与 RESTful API 不同，GraphQL 通过一个单一端点来查询和获取数据，而不是通过多个端点。这个单一端点被称为“schema”。当前端需要获取数据时，它会向 GraphQL 发出查询请求，并传入参数，GraphQL 可以解析参数，并返回与参数匹配的精确数据。这种机制使得前端可以像自己想要的那样获取数据，而不是被 API 返回的数据所限制。
GraphQL 优化 RESTful API 的性能
- 精确获取数据
RESTful API 通常返回一个完整的资源对象，包括所有的属性和关联对象。这种机制过于灵活，导致数据冗余和带宽浪费。 GraphQL 的查询是精确的，前端可以精确地获取自己需要的数据，避免了冗余数据和带宽浪费。
以下是 RESTful API 和 GraphQL 查询的对比：
RESTful API：
GET /api/courses/1
返回：
-- -------------------- ---- -------
-
----- --
-------- ---- -------------
-------------- ------ --- ----------- --------
----------- -
-
----- --
------- -------
--
-
----- --
------- -----
-
-
-GraphQL 查询：
-- -------------------- ---- -------
----- -------------- ---- -
---------- ---- -
-----
-----------
-------- -
--
----
-
-
-返回：
-- -------------------- ---- -------
-
------- -
--------- -
-------- ---- -------------
-------------- ------ --- ----------- --------
----------- -
-
----- --
------- -------
--
-
----- --
------- -----
-
-
-
-
-由于 RESTful API 返回完整的资源对象，而 GraphQL 可以精确查询，因此 GraphQL 可以避免冗余数据和带宽浪费。
- 多重查询
RESTful API 的多重查询需要多个 HTTP 请求和响应。这使得 RESTful API 很难查询和获取多个数据集。如果查询过于复杂，返回数据的大小会很大，这会导致性能问题。 GraphQL 可以通过单个查询获取多个数据集，并返回所需的数据。这使得前端可以更轻松地查询和获取多个数据集。以下是 GraphQL 的查询示例：
-- -------------------- ---- -------
----- ----------------------- ---- -
---------- ---- -
-----
-----------
-------- -
--
----
-
-
-
----- ----------------------- ---- -
---------- ---- -
-----
-----------
-------- -
--
----
-
-
-这两个查询都是针对相同的课程，一个查询中包含了学生数据，另一个查询中包含了教师数据。前端可以使用这种方式避免多个请求和响应，查询和获取多个数据集。
- 类型检查
RESTful API 可以返回任何数据类型，包括值和对象，这使得前端很难处理数据。GraphQL 可以对返回数据进行类型检查，前端可以确定接收到的数据类型，这使得前端更容易对数据进行处理。
例如，在 RESTful API 中，一个 POST 请求可能返回一个 JSON 对象，而其他请求可能返回一个字符串或其他类型的数据。与之不同，GraphQL 能够对返回的数据进行类型检查。以下是一个 GraphQL 查询的示例：
query Student($id: ID!) {
student(id: $id) {
id
name
age
}
}GraphQL 将在返回后，会返回一个包含 id、name 和 age 属性的对象。这与 RESTful API 不同，RESTful API 可以返回任何数据类型。
示例代码
以下是一个基于 GraphQL 的 Node.js 服务器的示例代码：
index.js：
-- -------------------- ---- -------
----- ------- - -------------------
----- ----------- - ---------------------------
----- - ----------- - - -------------------
-- -- ------
----- ------ - -------------
---- ------ -
--- ---
------ -------
------------ -------
--------- ---------
-
---- ------- -
--- ---
----- -------
---- ----
-------- ---------
-
---- ----- -
---------- ----- ------
----------- ----- -------
-
---
-- ----
----- ------- - -
-
--- ----
------ ---- -------------
------------ ------ --- ----------- -------
--
-
--- ----
------ ----- ---------
------------ ------ ---- ------- -------
-
--
----- -------- - -
-
--- ----
----- --------
---- ---
-------- -----
--
-
--- ----
----- ------
---- ---
-------- ----- ----
-
--
-- ------
----- ---- - -
------- -- -- -- -- ------------------- -- --------- --- ----
-------- -- -- -- -- --------------------- -- ---------- --- ---
--
----- --- - ----------
------------------- -------------
------- -------
---------- -----
--------- ----
----
---------------- -- -- -
-------------------- - ------- --- ------ -- --------------------------------
---在上面的示例中，我们通过 buildSchema 方法创建了一个 GraphQL schema，然后通过 express-graphql 中间件将 GraphQL API 集成到 Express 中。schema 中定义了 Course、Student 和 Query 对象，分别对应课程、学生和查询。我们在模拟数据中模拟了两个课程和两个学生。在实现查询逻辑 root 中，我们通过 find 方法根据 ID 查询相应的课程或学生。
结论
相比于 RESTful API，GraphQL 更加灵活和精确，可以避免带宽浪费和冗余数据。同时，GraphQL 也可以避免多个请求和响应，用于查询和获取多个数据集。GraphQL 还可以对返回数据进行类型检查，使得前端更容易处理数据。如今，GraphQL 正在得到越来越多的支持和使用，它可以优化 RESTful API 的性能，提高前后端的交互效率。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6739aaf74567f25775997246