GraphQL 是一种用于构建 API 的查询语言和运行时环境。它由 Facebook 开发并于 2015 年开源。相比于传统的 RESTful API，GraphQL 更加灵活，可以根据客户端的需求来获取数据。在前端开发中，GraphQL 已经成为一种非常流行的技术，但它同样适用于后端 API 的构建。本文将介绍如何使用 GraphQL 构建一个后端 API。
什么是 GraphQL？
GraphQL 是一种查询语言，用于 API 的设计和开发。它定义了一种类型系统，客户端可以根据自己的需求指定查询参数，后端会返回符合条件的数据。GraphQL 的查询语言非常灵活，客户端可以根据需要指定需要查询的字段和数据类型。相比于传统的 RESTful API，GraphQL 可以减少请求次数和传输数据的大小，提高应用的性能和效率。
如何使用 GraphQL 构建后端 API？
使用 GraphQL 构建后端 API 的过程可以分为以下几个步骤：
1. 定义数据模型
首先需要定义数据模型，包括数据类型和关系。GraphQL 使用类型系统来定义数据模型，可以使用 SDL（Schema Definition Language）或者编程语言来定义。
以一个简单的博客系统为例，假设有两个数据类型：文章和作者。
---- ------ - --- --- ----- ------- ------ ------- ------ -------- - ---- ---- - --- --- ------ ------- -------- ------- ------- ------- -
在这个数据模型中，每个作者可以有多篇文章，每篇文章只属于一个作者。
2. 定义查询和变更
定义好数据模型后，需要定义查询和变更来获取和修改数据。查询和变更都是由客户端发起的，后端需要根据客户端的请求来返回数据或者修改数据。
定义查询和变更可以使用 SDL 或者编程语言来定义。
---- ----- - -------- ----- ---- ---------- ----- ------ - ---- -------- - ----------------- -------- -------- -------- --------- ----- ---- -------------- ---- ------ ------- -------- -------- ---- -------------- ----- ------- -
在这个例子中，定义了两个查询：获取文章和获取作者。定义了三个变更：创建文章、更新文章和删除文章。
3. 实现查询和变更
定义好查询和变更后，需要实现这些查询和变更。可以使用任何编程语言来实现 GraphQL 的查询和变更，只需要实现相应的解析器即可。
以 JavaScript 为例，可以使用 GraphQL.js 来实现查询和变更。
----- - -------- ----------- - - -------------------
----- ------ - -------------
---- ------ -
--- ---
----- -------
------ -------
------ --------
-
---- ---- -
--- ---
------ -------
-------- -------
------- -------
-
---- ----- -
-------- ----- ----
---------- ----- ------
-
---- -------- -
----------------- -------- -------- -------- --------- ----- ----
-------------- ---- ------ ------- -------- -------- ----
-------------- ----- -------
-
---
----- ------- - -
- --- ---- ----- -------- ------ ------------------- --
- --- ---- ----- ------ ------ ----------------- --
--
----- ----- - -
- --- ---- ------ ------ ------- -------- ----- -- -- ----- ------ --------- --- --
- --- ---- ------ ---------- -------- ------ ------- -- -- --------- --------- --- --
--
----- ---- - -
----- -- -- -- -- --------------- -- ------- --- ----
------- -- -- -- -- ------------------- -- --------- --- ----
----------- -- ------ -------- -------- -- -- -
----- -- - ------------------- - ---
----- ---- - - --- ------ -------- -------- --
-----------------
------ -----
--
----------- -- --- ------ ------- -- -- -
----- ---- - --------------- -- ------- --- ----
-- ------- ---------- - ------
-- --------- ------------ - --------
------ -----
--
----------- -- -- -- -- -
----- ----- - -------------------- -- ------- --- ----
-- ------ --- --- ------ ------
------------------- ---
------ -----
--
--
----- ----- - -
----- -
-------- ---- -
-----
-------
------ -
----
-----
-
-
-
--
--------------- ------ ----------------- -- -
--------------------
---在这个例子中，实现了查询和变更的解析器。查询和变更的解析器都是一个函数，根据传入的参数返回相应的数据。可以使用任何数据库来存储数据，这里使用了一个简单的数组来模拟。
4. 使用 GraphQL Playground 测试 API
使用 GraphQL Playground 来测试 API，可以非常方便地查看查询和变更的结果。GraphQL Playground 是一个交互式的 GraphQL IDE，可以用来测试和调试 GraphQL API。
安装 GraphQL Playground 可以使用 npm 安装：
--- ------- ------ -------------------------------------
使用 GraphQL Playground 可以直接在浏览器中访问：
----- ------- - ------------------- ----- - ----------- - - --------------------------- ----- - -------------------- - - ------------------------- ----- - ------------ - - -------------------------- ----- - ------------ - - --------------------------------- ----- - --------------- - - ------------------------------ ----- - ------ - - -------------------------- ----- --------- - ----------------------- ----- ----------- - ------------------------- ----- -------- - --------------------------------- ----- ------ - ---------------------- --------- ---------- --- ----- ------ - --- -------------- ------- ----------------------- --------------------- -------------- ----- ----------- ----- --- ----- --- - ---------- ------------------- ------------- ------- --------- ----- ---- ------------------------ --- --- ---------------- -- -- - -------------------- --- ------ ------- -- -------------------------------- ---
在浏览器中访问 http://localhost:4000/graphql，就可以使用 GraphQL Playground 来测试 API。
总结
本文介绍了如何使用 GraphQL 构建后端 API，包括定义数据模型、定义查询和变更、实现查询和变更以及使用 GraphQL Playground 测试 API。GraphQL 的灵活性可以提高应用的性能和效率，但同时也需要更多的开发工作。如果你正在构建一个需要高度灵活性和可扩展性的 API，GraphQL 可能是一个不错的选择。
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/657d815cd2f5e1655d85a37e