在现代的 Web 开发中，GraphQL 已经成为了非常流行的 API 查询语言。而 Fastify 则是一个快速、低开销、可扩展的 Node.js Web 框架。本文将介绍如何使用 Fastify 框架来构建 GraphQL API。
什么是 GraphQL？
GraphQL 是一种用于 API 查询的查询语言。相比于传统的 REST API，GraphQL 具有以下优点：
- 更高效的数据获取：GraphQL 可以一次性获取多个资源，避免了 REST API 中的多次请求。
- 更精确的数据获取：GraphQL 允许客户端指定需要的数据，避免了 REST API 中的过度获取。
- 更好的类型检查：GraphQL 可以在编译时检查查询是否合法，避免了 REST API 中的运行时错误。
什么是 Fastify？
Fastify 是一个快速、低开销、可扩展的 Node.js Web 框架。Fastify 的主要特点包括：
- 低开销：Fastify 的核心代码只有 5K 行，相比于 Express 和 Koa 等框架更加轻量级。
- 高性能：Fastify 的路由、请求处理和响应处理都是异步的，可以利用 Node.js 的非阻塞 I/O 特性来提高性能。
- 可扩展：Fastify 允许开发者使用插件来扩展框架的功能，例如添加 Swagger 文档、添加 CORS 支持等等。
如何使用 Fastify 构建 GraphQL API？
下面将介绍如何使用 Fastify 和 GraphQL.js 库来构建 GraphQL API。
安装依赖
首先需要安装以下依赖：
npm install fastify fastify-gql graphql
其中 fastify-gql 是 Fastify 的 GraphQL 插件，graphql 是 GraphQL.js 库。
定义 GraphQL Schema
首先需要定义 GraphQL Schema，即数据模型和查询语句。这里假设我们有一个 User 对象，包含 id 和 name 两个字段。
-- -------------------- ---- -------
----- - ------------------ ---------- -------------- ------------- - - -------------------
----- -------- - --- -------------------
----- -------
------- -- -- --
--- - ----- --------- --
----- - ----- ------------- -
--
---
----- --------- - --- -------------------
----- ----------------
------- -
----- -
----- ---------
----- - --- - ----- --------- - --
--------------- ----- -
-- ----- -- -- ----
-
-
-
---
-------------- - --- ---------------
------ ---------
---这里定义了一个 UserType 对象和一个 RootQuery 对象。UserType 定义了 User 对象的数据结构，包含 id 和 name 两个字段。RootQuery 定义了查询语句，这里只定义了一个 user 查询，可以根据 id 查询用户。
创建 Fastify 应用
接下来需要创建 Fastify 应用，并使用 fastify-gql 插件来注册 GraphQL API。
-- -------------------- ---- ------- ----- ------- - --------------------- ----- --- - ----------------------- ----- ------ - -------------------- --------------------- - ------- --------- ---- --- -------------------- ----- -- - -- ----- ----- ---- ------------------- --------- -- ---------------------------------------------------- ---
这里创建了一个 Fastify 应用，并使用 fastify-gql 插件来注册 GraphQL API。schema 参数指定了之前定义的 GraphQL Schema，graphiql 参数指定是否开启 GraphiQL Web 界面，方便测试和调试。
测试 GraphQL API
启动应用后，可以在浏览器中访问 http://localhost:3000/graphiql，进入 GraphiQL Web 界面。在界面中输入以下查询语句：
{
user(id: "1") {
id
name
}
}这里查询了 id 为 1 的用户，并返回 id 和 name 两个字段。点击 "Run Query" 按钮，即可得到查询结果。
总结
本文介绍了如何使用 Fastify 框架来构建 GraphQL API。首先需要定义 GraphQL Schema，然后创建 Fastify 应用并注册 fastify-gql 插件，最后可以使用 GraphiQL Web 界面来测试和调试 API。Fastify 的高性能和可扩展性，以及 GraphQL 的优秀特性，使得这种组合非常适合构建现代的 Web 应用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/65fa484dd10417a222620dc5