随着前端应用程序的复杂性不断增加，GraphQL 作为一种现代的数据查询语言和运行时环境，越来越受到开发者的青睐。虽然 RESTful API 已经在 Web 开发中得到广泛的应用，但 GraphQL 作为一种更强大、更灵活和更高效的 API 手段，也开始逐渐流行。那么，RESTful API 如何支持 GraphQL 呢？
1. 什么是 RESTful API？
RESTful API 代表了 Representational State Transfer，是一种基于 HTTP 的 Web API 设计风格。它默认使用 HTTP 动词如 GET、POST、PUT 和 DELETE，可以用来访问和操作 Web 资源，比如用于 Web 服务的数据查询、文件上传等等。
2. 什么是 GraphQL？
GraphQL 是一种由 Facebook 开发的查询语言和运行时环境，用于服务端与客户端之间的数据交互。GraphQL 可以让客户端指定它们所需要的数据，从而避免了不必要的网络带宽消耗，也使数据在服务端和客户端之间的传输更加高效。
GraphQL 的关键特性包括：
- 客户端可以精确指定所需的数据，而不是传输整个 JSON 或 XML 文档。
- 客户端只需要对每个类型查询所需的字段。
- GraphQL 可以轻松地操作类型嵌套和数据集合。
- GraphQL 具有类型系统，可以在编译时检测语法错误，确保传输的数据格式正确。
3. 如何支持 GraphQL？
要把一个现有的 RESTful API 转化成 GraphQL API，有几种方法：
（1）手动编写 GraphQL resolvers
手动编写 GraphQL resolvers 的方式比较简单，但是对于大型的 RESTful API，会比较繁琐。在这种方式下，开发人员需要手动添加每个查询、突变以及每个类型的 resolvers。此外，还需要处理类型转换以及适当的错误处理等等。
下面是一个使用 graphql-yoga 和 node-fetch 来手动编写 resolver 的例子：
-- -------------------- ---- -------
----- - ------------- - - -----------------------
----- ----- - ---------------------
----- --------- - -
------ -
---
- ----
- ------ --- ------
- ------ --- ----
--
----- ------------- ----- -
----- -------- - ----- ---------------------------------------------------
----- ----- - ----- ---------------
------ -----
--
---
- --------
- ------ --- ------
- ------ --- ----
--
----- ------------ ----- -
----- -------- - ----- --------------------------------------------------------------
----- ---- - ----- ---------------
------ ----
-
-
-
----- ------ - --- ---------------
--------- -------------------
---------
--
--------------- -- ------------------- ------- -- ------------------------（2）使用 Apollo Data Source
使用 Apollo Data Source 的方式，可以通过以代码的方式自动生成 RESTful API 的 GraphQL 对象类型和字段。Apollo Server 支持两种类型的 data sources：REST Data Source 和 GraphQL Data Source。
下面是一个使用 Apollo Data Source 的例子：
-- -------------------- ---- -------
----- - ------------- --- - - ------------------------
----- - -------------- - - ---------------------------------
----- -------- - ----
---- ---- -
------- ---
--- ---
------ ------
----- ------
-
---- ----- -
------ ------
-------- ------ ----
-
-
----- -------- ------- -------------- -
------------- -
-------
------------ - --------------------------------------
-
----- ---------- -
------ ------------------
-
----- --------------- -
------ ------------------------
-
-
----- ------ - --- --------------
---------
------------ -- -- -
------ -
--------- --- ----------
-
--
---------- -
------ -
------ -------- ----- - ----------- -- -- -
------ -------------------------------
--
----- -------- - -- -- - ----------- -- -- -
------ ------------------------------------
-
-
-
--
----------------------- --- -- -- -
--------------- ------ ----- -- --------
--（3）使用 Schema Stitching
使用 Schema Stitching 也是一种比较好的方法，可以将不同的 RESTful API 服务整合到一个 GraphQL Schema 中。Schema Stitching 可以让我们创建一个基于现有 GraphQL Schema 的 API，它可以利用分布式的服务来组合成一个单一的 GraphQL Schema，达到集中管理和较高的更新频率。
下面是一个使用 GraphQL Mesh 的例子：
-- -------------------- ---- -------
----- - ------------- - - -----------------------
----- - ------------- - - --------------------------------
----- - ----------- ---------------- - - ------------------------------
----- - -------------------------- - - --------------------------------
----- ----- - ---------------------
----- -------- -------------------------- -
------ ----------------------------
------- ----- ------------------------------------------------------------------------
-------- -----
--
-
----- -------- ----------------- -
------ ----------------------------
------- ----- ---------------------------------------------------------
-------- -----
--
-
----- -------- ------------- -
----- --------------------- - ----- --------------------------
----- ------------ - ----- -----------------
----- ------------ - ---------------
----------- -
- ------- --------------------- --
- ------- ------------ -
-
--
----- ------ - --- ---------------
------- ------------
------- -------------
----------- --
---
-------- --- -- --
------
--
--
--------------- -- ------------------- ------- -- ------------------------
-
-------------4. 结论
本文介绍了几种将 RESTful API 转换为 GraphQL 的方法，手动编写 GraphQL resolvers、使用 Apollo Data Source 和使用 Schema Stitching。通过这些方法，我们可以更高效、灵活的开发和维护我们的应用程序。当然，根据实际需要，我们需要选择更适合自己的方法来使用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/66f3f744f40ec5a964e64730