前言
GraphQL 是一种用于 API 的查询语言，它允许客户端在一个请求中定义所需的数据和结构，大大降低了网络传输的数据量，提高了前端应用的性能。Fastify 是一个快速、低开销、可扩展的 Node.js Web 框架，它的特点是极速的路由和中间件处理，适合用于构建高性能 Web 应用。本文将介绍如何使用 Fastify 框架开发 GraphQL API 的完整实践，包括项目搭建、GraphQL 集成、数据查询、数据修改等内容。
项目搭建
安装 Fastify
首先需要安装 Node.js，安装完成后使用 npm 安装 Fastify：
npm install fastify --save
安装 GraphQL
使用 npm 安装 GraphQL：
npm install graphql --save
安装 Fastify GraphQL
Fastify GraphQL 是一个 Fastify 插件，用于将 GraphQL 集成到 Fastify 中。使用 npm 安装 Fastify GraphQL：
npm install fastify-graphql --save
GraphQL 集成
创建 GraphQL Schema
GraphQL Schema 是定义数据结构和查询方式的核心部分，使用 GraphQL SDL（Schema Definition Language）语言编写，可以参考下面的代码示例：
-- -------------------- ---- ------- ---- ---- - --- --- ----- ------- ---- ---- - ---- ----- - -------- ----- ---- ------ ------ - ---- -------- - ---------------- -------- ---- ------ ---- -------------- ---- ----- -------- ---- ------ ---- -------------- ----- ---- -
上面的代码定义了一个 User 类型，包括 id、name、age 三个字段，还定义了 Query 类型和 Mutation 类型，分别用于查询和修改 User 数据。
创建 Fastify 应用
使用 Fastify 创建一个 HTTP 服务，并将 Fastify GraphQL 插件集成到应用中：
-- -------------------- ---- ------- ----- ------- - -------------------- -------------------------------------------- - ------- ------ -- ---- ------- ------ ------- --------- ---- -- -- -------- ------- -- -------------------- ----- -------- -- - -- ----- ----- --- ------------------- --------- -- ------------ --
测试 GraphQL API
启动 Fastify 应用后，访问 http://localhost:3000/graphql 将会看到 GraphiQL 界面，可以在界面上测试 GraphQL API。
数据查询
定义 Resolver
Resolver 是用于处理 GraphQL 查询的函数，它根据查询的参数返回相应的数据。使用下面的代码示例定义一个 Resolver，用于查询用户数据：
-- -------------------- ---- -------
----- ----- - -
- --- ---- ----- -------- ---- -- --
- --- ---- ----- ------ ---- -- --
- --- ---- ----- ---------- ---- -- --
-
----- --------- - -
------ -
----- --- - -- -- -- ------------ -- ---- --- ----
------ -- -- ------
--
-上面的代码定义了一个 users 数组，用于存储用户数据，然后定义了一个 resolvers 对象，包含了 user 和 users 两个 Resolver。
集成 Resolver
将上面定义的 Resolver 集成到 Fastify GraphQL 中：
fastify.register(require('fastify-graphql'), {
schema: `...`, // 将上面的 GraphQL Schema 代码复制到这里
graphiql: true, // 启用 GraphiQL 界面，方便测试
resolvers, // 将上面定义的 resolvers 对象传入 Fastify GraphQL 插件
})测试查询 API
在 GraphiQL 界面上输入查询语句：
-- -------------------- ---- -------
----- -
-------- ---- -
--
----
---
-
----- -
--
----
---
-
-将会得到以下结果：
-- -------------------- ---- -------
-
------- -
------- -
----- ----
------- --------
------ --
--
-------- -
-
----- ----
------- --------
------ --
--
-
----- ----
------- ------
------ --
--
-
----- ----
------- ----------
------ --
-
-
-
-数据修改
定义 Mutator
Mutator 是用于处理 GraphQL 修改操作的函数，它根据修改的参数进行相应的数据修改。使用下面的代码示例定义一个 Mutator，用于创建、更新、删除用户数据：
-- -------------------- ---- -------
----- --------- - -
------ -
----- --- - -- -- -- ------------ -- ---- --- ----
------ -- -- ------
--
--------- -
----------- --- - ----- --- -- -- -
----- ---- - - --- ------------------- - --- ----- --- -
----------------
------ ----
--
----------- --- - --- ----- --- -- -- -
----- ---- - ------------ -- ---- --- ---
-- ------- ------ ----
--------- - ----
-------- - ---
------ ----
--
----------- --- - -- -- -- -
----- ----- - ----------------- -- ---- --- ---
-- ------ --- --- ------ ----
----- ------ - ------------------- --
------ ----
--
--
-上面的代码定义了三个 Mutator，分别用于创建、更新、删除用户数据。
集成 Mutator
将上面定义的 Mutator 集成到 Fastify GraphQL 中：
fastify.register(require('fastify-graphql'), {
schema: `...`, // 将上面的 GraphQL Schema 代码复制到这里
graphiql: true, // 启用 GraphiQL 界面，方便测试
resolvers, // 将上面定义的 resolvers 对象传入 Fastify GraphQL 插件
})测试修改 API
在 GraphiQL 界面上输入修改语句：
-- -------------------- ---- -------
-------- -
---------------- -------- ---- --- -
--
----
---
-
-------------- ---- ----- ------ ------- ---- --- -
--
----
---
-
-------------- ---- -
--
----
---
-
-将会得到以下结果：
-- -------------------- ---- -------
-
------- -
------------- -
----- ----
------- --------
------ --
--
------------- -
----- ----
------- ------ -------
------ --
--
------------- -
----- ----
------- ------
------ --
-
-
-总结
本文介绍了如何使用 Fastify 框架开发 GraphQL API 的完整实践，包括项目搭建、GraphQL 集成、数据查询、数据修改等内容。通过本文的学习，读者可以了解到如何使用 Fastify 框架和 GraphQL 技术构建高性能的 Web 应用。同时，本文还提供了详细的代码示例和指导意义，希望能够对读者有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/662cbed3d3423812e4a5ca1f