前言
GraphQL 是一种由 Facebook 开发的数据查询和操作语言，它提供了一种更高效、更强大的方式来构建 API。GraphQL 允许客户端明确地指定它需要的数据，而不是像 RESTful API 那样需要通过多个请求来获取数据。Fastify 是一个快速、低开销、轻量级的 Node.js 框架，它支持异步编程和插件系统，可以轻松地构建高效的 Web 应用程序。本文将介绍如何使用 Fastify 框架来开发 GraphQL 接口。
GraphQL 基础知识
GraphQL 查询语言
GraphQL 查询语言是一种类似于 JSON 的结构化语言，用于描述客户端需要的数据。GraphQL 查询通常包含一个或多个字段，每个字段都有一个名称和一个返回类型。例如，以下是一个简单的 GraphQL 查询：
{
user(id: 1) {
name
email
}
}这个查询请求一个名为 user 的字段，该字段接受一个参数 id，并返回 name 和 email 字段。
GraphQL Schema
GraphQL Schema 定义了 API 中可用的类型和字段。它描述了每个类型的字段和返回类型，并定义了如何查询和修改数据。GraphQL Schema 是使用 GraphQL Schema Definition Language (SDL) 编写的。例如，以下是一个简单的 GraphQL Schema：
-- -------------------- ---- ------- ---- ---- - --- --- ----- ------- ------ ------- - ---- ----- - -------- ----- ---- -
这个 Schema 定义了一个 User 类型和一个 Query 类型，其中 Query 类型有一个名为 user 的字段，该字段接受一个参数 id，并返回一个 User 类型的对象。
GraphQL Resolver
GraphQL Resolver 是一个函数，用于解析 GraphQL 查询中的字段。Resolver 接受输入参数和上下文，并返回与该字段关联的数据。Resolver 可以是同步或异步函数。例如，以下是一个简单的 Resolver：
const userResolver = (parent, args, context) => {
const { id } = args;
const user = getUserById(id);
return user;
};这个 Resolver 接受一个参数 args，其中包含一个名为 id 的属性，然后使用 getUserById 函数来获取与该 ID 相关联的用户对象，并将其返回。
Fastify 和 GraphQL
安装 Fastify
要开始使用 Fastify，您需要先安装它。可以使用以下命令在全局范围内安装 Fastify：
npm install -g fastify
或者，您可以在项目中安装 Fastify：
npm install fastify --save
安装 GraphQL
在使用 Fastify 开发 GraphQL API 之前，您需要安装它的依赖项。可以使用以下命令安装 GraphQL：
npm install graphql --save
创建 Fastify Server
在创建 Fastify Server 之前，您需要定义 GraphQL Schema 和 Resolver。以下是一个简单的 GraphQL Schema 和 Resolver：
-- -------------------- ---- ------- ---- ---- - --- --- ----- ------- ------ ------- - ---- ----- - -------- ----- ---- - ----- ------------ - -------- ----- -------- -- - ----- - -- - - ----- ----- ---- - ---------------- ------ ----- --
在这个例子中，getUserById 是一个函数，它接受一个 ID 并返回与该 ID 相关联的用户对象。
现在，您可以使用 Fastify 创建一个 GraphQL API。以下是一个简单的代码示例：
-- -------------------- ---- -------
----- ------- - ---------------------
----- - --------------- --------------- - - ---------------------------
-------------------------------- -
-------
----------
---
--------------------------------- -
------------ -----------
---
-------------------- ----- -- -
-- ----- -
-------------------
----------------
-
------------------- ------- -- ------------------------
---在这个例子中，我们使用 fastify-graphql 插件来注册 GraphQL API 和 GraphiQL 界面。graphqlFastify 函数接受 schema 和 resolvers 作为参数，然后将其注册为 GraphQL API。graphiqlFastify 函数接受一个 endpointURL 参数，该参数指定 GraphQL API 的 URL。
执行 GraphQL 查询
现在，您可以使用 GraphiQL 界面或任何其他工具来执行 GraphQL 查询。以下是一个简单的 GraphQL 查询：
{
user(id: 1) {
name
email
}
}如果一切都设置正确，您应该会看到一个包含用户名称和电子邮件的响应。
结论
在本文中，我们介绍了 GraphQL 的基础知识以及如何使用 Fastify 框架来开发 GraphQL API。我们讨论了 GraphQL 查询语言、GraphQL Schema 和 GraphQL Resolver，并提供了一个简单的代码示例来演示如何使用 Fastify 和 GraphQL。如果您想要了解更多关于 GraphQL 或 Fastify 的信息，请查看官方文档。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6766562376af2b9a20f5f9ef