GraphQL 是一种新兴的数据查询语言，它可以优化 API 接口的性能、增加灵活性并提高客户端与服务端之间通信的效率。Fastify 是 Node.js 的一个高效率 Web 框架，它提供了对于 GraphQL 的原生支持，使得 Fastify 应用中的 GraphQL 开发非常简单。本文将详细介绍如何在 Fastify 应用中实现 GraphQL。
1. 安装 Fastify 和相关插件
在开始使用 Fastify 开发 GraphQL 之前，我们需要先安装主要的模块：fastify 和 fastify-gql。
npm install fastify fastify-gql
2. 编写 GraphQL Schema
GraphQL Schema 是用于定义我们的数据模型的，它描述了我们提供给客户端的所有数据类型、字段和解析器。本文将使用一个简单的示例来演示如何创建 GraphQL Schema：
-- -------------------- ---- -------
----- - --- - - -----------------------
----- -------- - ----
---- ---- -
----- -------
---- ----
------- -------
-
---- ----- -
------ ------
-
--
-------------- - ---------在上面的示例中，我们定义了 User 类型，它包括 name、age 和 gender 三个字段，并在 Query 类型中定义了一个名为 users 的查询字段。请注意，name 和 age 字段被定义为非空字符串和整数类型，而 gender 字段的类型是字符串。
3. 编写 GraphQL 解析器
GraphQL 解析器是将客户端请求转换成实际数据的一种机制。下面是一个基本的 GraphQL 解析器示例：
-- -------------------- ---- -------
----- - -------------------- - - -------------------------
----- -------- - ----------------------
----- --------- - -
------ -
------ -- -- -
- ----- ------ ---- --- ------- ------ --
- ----- -------- ---- --- ------- -------- -
-
-
--
-------------- - ----------------------
---------
---------
---在上面的示例中，我们通过 makeExecutableSchema 和传入的 typeDefs 和 resolvers 参数创建了一个 GraphQL 解析器。注意到我们在 resolvers 中定义了一个名为 users 的查询字段，它的返回值是将两个不同的用户对象组成的数组。
4. 创建 Fastify 应用
接下来，我们需要创建一个 Fastify 应用程序，并将 GraphQL Middlewares 绑定到其上。以下代码示例演示了如何创建 Fastify 应用程序：
-- -------------------- ---- -------
----- ------- - --------------------
------- ----
---
----- - -------------- - - -----------------------
----- ------ - --------------------
-------------------------------- -
------- -----------
-------- -
-------
--------- ----
-
---
-------------------- ----- -------- -- -
-- ----- ----- ----
------------------- --------- -- -------------
---在上面的示例中，我们将 GraphQL Fastify Middlewares 绑定到 /graphql 路径下，并将前面创建的 GraphQL 解析器作为参数传递。我们还启用了 GraphiQL 界面以便于我们测试和调试 GraphQL 查询。在这个示例中，我们将 Fastify 应用程序绑定到了 3000 端口上。
5. 测试 GraphQL 查询
最后，我们可以通过浏览器或者其他 GraphQL 客户端来测试我们的 GraphQL 查询。如果你在本地运行了上面的代码，并打开了 http://localhost:3000/graphql，你将会看到 GraphiQL 页面。在页面左侧，我们可以编写我们的 GraphQL 查询语句。以下是一个简单的查询示例：
query {
users {
name
age
gender
}
}我们将查询 users 字段，并返回其所有属性。执行查询后，我们将在页面右侧看到我们的查询结果。如果一切正常，你应该将看到一个包含两个用户信息的 JSON 对象。
结论
本文提供了一个非常基础但完整的 Fastify 应用程序中使用 GraphQL 的示例。如果你喜欢这种简单的而直接的代码，或者想构建更复杂的基于 GraphQL 的项目，我们强烈建议你深入阅读 GraphQL 的文档和 Fastify 的插件文档。我们希望本文能够帮助你更好地理解 Fastify 中使用 GraphQL，以及如何在项目中应用它们。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/671c85a89babaf620fb1255d