RESTful API 是现代 Web 应用开发中最常用的 API 设计模式之一，但是它也存在一些缺点，例如需要多次请求才能获取完整的数据、无法限制返回的字段和数据类型等。GraphQL 则是一种新的 API 设计模式，它能够解决 RESTful API 的这些缺点，并且提供了更好的查询和数据获取方式。
本文将介绍如何使用 GraphQL 搭建完整的 RESTful API，包括 GraphQL 的基本概念、如何定义 GraphQL Schema、如何使用 GraphQL 查询和修改数据等。
什么是 GraphQL
GraphQL 是一种由 Facebook 开发的查询语言和运行时环境，它允许客户端定义自己需要的数据结构，从而避免了 RESTful API 中需要多次请求才能获取完整数据的问题。GraphQL 还提供了强大的类型系统和查询语言，可以让客户端更精确地控制返回的数据。
GraphQL 的基本概念包括：
- Schema：定义了可查询的类型和字段。
- Query：用于查询数据。
- Mutation：用于修改数据。
- Resolver：用于处理查询和修改请求，并返回数据。
定义 GraphQL Schema
GraphQL 的核心是 Schema，它定义了可查询的类型和字段。一个简单的 GraphQL Schema 如下所示：
-- -------------------- ---- ------- ---- ---- - --- --- ----- ------- ------ ------- - ---- ----- - -------- ----- ---- ------ ------ - ---- -------- - ---------------- -------- ------ --------- ---- -------------- ---- ----- ------- ------ -------- ---- -------------- ----- ------- -
上面的 Schema 定义了 User 类型，它包含了 id、name 和 email 三个字段。Query 类型包含了两个查询：user 和 users，分别用于查询单个用户和所有用户。Mutation 类型包含了三个修改操作：createUser、updateUser 和 deleteUser，分别用于创建、更新和删除用户。
使用 GraphQL 查询数据
使用 GraphQL 查询数据非常简单，只需要发送一个 POST 请求到 GraphQL 服务器，并在请求体中包含查询语句即可。例如，下面的查询语句用于查询所有用户的 id 和 name：
{
users {
id
name
}
}服务器会返回一个 JSON 对象，其中包含了所有用户的 id 和 name：
-- -------------------- ---- -------
-
------- -
-------- -
-
----- ----
------- -------
--
-
----- ----
------- -----
--
-
----- ----
------- ---------
-
-
-
-使用 GraphQL 修改数据
使用 GraphQL 修改数据也非常简单，只需要发送一个 POST 请求到 GraphQL 服务器，并在请求体中包含修改语句即可。例如，下面的修改语句用于创建一个新用户：
mutation {
createUser(name: "David", email: "david@example.com") {
id
name
email
}
}服务器会返回一个 JSON 对象，其中包含了新创建的用户的 id、name 和 email：
-- -------------------- ---- -------
-
------- -
------------- -
----- ----
------- --------
-------- -------------------
-
-
-总结
本文介绍了如何使用 GraphQL 搭建完整的 RESTful API，包括 GraphQL 的基本概念、如何定义 GraphQL Schema、如何使用 GraphQL 查询和修改数据等。使用 GraphQL 可以避免 RESTful API 中需要多次请求才能获取完整数据的问题，并提供了更好的查询和数据获取方式。如果你正在开发前端应用，不妨考虑使用 GraphQL 来设计你的 API。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/65f141392b3ccec22fa018e7