Fastify 是一个高效的 Web 框架，它提供了一些强大的功能，如路由、中间件、错误处理等。而 GraphQL 是一种用于 API 的查询语言，它可以让客户端精确地指定需要的数据，从而减少不必要的数据传输和处理，提高了 API 的效率。
在本文中，我们将介绍如何在 Fastify 框架中使用 GraphQL，包括安装和配置 GraphQL，定义 GraphQL Schema，编写 GraphQL Resolver，以及使用 GraphQL Playground 进行测试和调试。
安装和配置 GraphQL
要在 Fastify 中使用 GraphQL，我们需要安装 fastify-gql 插件。可以使用 npm 命令进行安装：
npm install fastify-gql
安装完成后，在 Fastify 应用程序中注册插件即可：
const fastify = require('fastify')()
fastify.register(require('fastify-gql'), {
schema: schema,
graphiql: true
})其中，schema 是一个包含 GraphQL Schema 的对象，它定义了所有可用的查询和变异。graphiql 参数用于启用 GraphQL Playground，这是一个用于测试和调试 GraphQL API 的工具。
定义 GraphQL Schema
在 Fastify 中定义 GraphQL Schema 与在其他框架中定义类似。我们需要定义所有可用的查询和变异，以及它们的类型和参数。例如，下面是一个简单的 GraphQL Schema，它定义了一个 hello 查询和一个 add 变异：
-- -------------------- ---- -------
----- - ----------- - - ------------------
----- ------ - -------------
---- ----- -
------ ------
-
---- -------- -
------ ----- -- ------ ---
-
--在这个 Schema 中，hello 查询返回一个字符串，add 变异接受两个整数参数，并返回它们的和。
编写 GraphQL Resolver
在 Fastify 中，我们可以使用 gql 装饰器来定义 GraphQL Resolver。Resolver 是一个函数，它接受 GraphQL 查询或变异，并返回它们所请求的数据。
例如，下面是一个 Resolver，它实现了 hello 查询：
-- -------------------- ---- -------
----- - --- - - ----------------------
----- --------- - -
------ -
------ ----
---- ----- -
------ ------
-
--------- -
------ ------ -------
-
-
-
-在这个 Resolver 中，我们使用 gql 装饰器来定义 hello 查询的类型和实现。resolve 函数返回一个字符串，这个字符串将作为 hello 查询的结果。
类似地，我们可以定义 add 变异的 Resolver：
-- -------------------- ---- -------
----- --------- - -
--------- -
---- ----
---- -------- -
------ ----- -- ------ ---
-
------------- -
----- - -- - - - ----
------ - - -
-
-
-
-在这个 Resolver 中，我们使用 gql 装饰器来定义 add 变异的类型和实现。resolve 函数接受一个包含参数的对象，并返回它们的和。
使用 GraphQL Playground 进行测试和调试
一旦我们定义了 GraphQL Schema 和 Resolver，我们就可以使用 GraphQL Playground 来测试和调试我们的 API。GraphQL Playground 是一个 Web 应用程序，它提供了一个交互式的 GraphQL 编辑器和一个调试器，可以帮助我们快速地测试和调试 GraphQL API。
要使用 GraphQL Playground，我们需要在浏览器中打开 http://localhost:3000/graphql，然后在左侧的编辑器中编写 GraphQL 查询或变异。例如，下面是一个查询 hello 的示例：
query {
hello
}这个查询将返回一个字符串 Hello World!，这是我们在 Resolver 中定义的返回值。
类似地，我们也可以测试 add 变异：
mutation {
add(a: 1, b: 2)
}这个变异将返回数字 3，这是我们在 Resolver 中定义的返回值。
总结
在本文中，我们介绍了如何在 Fastify 框架中使用 GraphQL，包括安装和配置 GraphQL，定义 GraphQL Schema，编写 GraphQL Resolver，以及使用 GraphQL Playground 进行测试和调试。GraphQL 是一个强大的 API 查询语言，它可以帮助我们提高 API 的效率和可维护性。如果您正在使用 Fastify 构建 Web 应用程序，并且需要一个高效和灵活的 API，那么 GraphQL 是一个不错的选择。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/655c78ead2f5e1655d69c133