GraphQL 是一种查询语言和运行时环境，用于构建 API。与传统的 RESTful API 相比，GraphQL 允许客户端精确地指定需要获取或更改的数据，从而减少了多个请求和处理过程，提高了性能和可扩展性。Fastify 是一个高度优化、低开销的 Web 框架，提供了快速、简单而又灵活的方式来构建 Node.js Web 应用程序。本文将介绍如何使用 Fastify 框架构建 GraphQL 服务器，详细讲解其中的细节和问题，并提供示例代码。
环境和准备工作
在开始之前，需要确保已经安装了以下环境和工具：
- Node.js（版本 10 或更高）
- npm 或 yarn 包管理器
- 一个文本编辑器，例如 Visual Studio Code
接下来，我们需要安装一些必须的依赖项：
--- ------- ------- ------- -----------
在上述命令中，我们安装了三个包：graphql、fastify 和 fastify-gql。其中，graphql 包是 GraphQL 的 JavaScript 实现，fastify 包是 fastify 框架的核心库，fastify-gql 包是 fastify 框架中集成了 GraphQL 的插件。
构建一个简单的 GraphQL 服务器
首先，我们需要创建一个 GraphQL schema，用于定义数据类型和查询、变量和操作等内容。在本文中，我们将使用以下简单的 schema：
---- ----- - ------ ------ -
该 schema 只定义了一个查询（Query）操作，该操作返回一个字符串类型的 hello 值。接下来，我们将使用这个 schema 构建一个 GraphQL 服务器。
在使用 fastify-gql 插件之前，我们需要先初始化一个 fastify 应用程序：
----- ------- - -------------------- -------------------- --- -- - -- ----- ----- --- ------------------- ------- -- ----------------------- --
在上述代码中，我们初始化了一个 fastify 实例，并在端口 3000 上启动了服务器。现在，我们需要向 fastify 实例中添加 fastify-gql 插件：
----- ------- - -------------------- ----- ------- - ---------------------- ----- ------ - ------------------- ------------------------- - ------- --------- ---- -- -------------------- --- -- - -- ----- ----- --- ------------------- ------- -- ----------------------- --
在上述代码中，我们使用 require('fastify-gql') 导入 fastify-gql 模块，并通过 fastify.register() 方法将其作为 fastify 插件注册。我们还将第二个参数指定为一个对象，该对象包含两个属性：schema 和 graphiql。其中，schema 属性指定 GraphQL schema（即上述定义的 schema 变量），graphiql 属性指定是否包含 GraphiQL IDE。GraphiQL 是用于在浏览器中交互式调试 GraphQL API 的 Web 应用程序。如果将 graphiql 属性设置为 true，则可以通过浏览器访问 http://localhost:3000/graphql 来打开 GraphiQL。
现在我们已经构建了一个简单的 GraphQL 服务器。我们可以通过以下查询来测试它：
----- - ----- -
该查询应该返回以下结果：
-
------- -
-------- ----
-
-因为我们还没有实现查询操作的函数，所以返回值为 null。
实现查询操作的函数
现在，我们需要实现查询操作的函数，以便查询可以返回一个字符串。我们需要修改 schema 和 fastify 应用程序，并添加一个简单的函数来处理查询。这是最终的代码：
---- ----- -
------ ------
-
----- ------ - -
------ ------
---- ----- -
------ ------
-
-
----- --------- - -
------ -
------ -------- ----- -------- -- -
------ ------- -------
-
-
-
----- ------- - --------------------
----- ------- - ----------------------
------------------------- -
-------
----------
--------- ----
--
-------------------- --- -- -
-- ----- ----- ---
------------------- ------- -- -----------------------
--在上述代码中，我们将 schema 变量替换为了一个字符串模板，该模板包含一个新的类型定义方式，用于协助 fastify-gql 插件识别查询操作。我们还添加了一个 resolvers 变量，该变量是一个对象，其中包含对查询操作的处理函数。在我们的示例中，只有一个查询（hello），其返回值为一个字符串常量。
现在，我们再次运行查询，并应该看到以下结果：
-
------- -
-------- ------- -------
-
-结论
使用 Fastify 框架构建 GraphQL 服务器是一种高效、简便而又灵活的方法。我们可以使用 fastify-gql 插件轻松地将 GraphQL 集成到 Fastify 应用程序中，并利用 Fastify 的高性能和低开销优势来提高应用程序的性能和可扩展性。本文提供了一个简单的示例，并详细讲解了每个步骤中的细节和问题。希望本文能为读者提供深入的学习和指导意义，以便他们能够更好地使用 Fastify 框架和 GraphQL 技术。
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/6717253ead1e889fe2202777