随着前端技术的快速发展，现代 Web 应用程序的复杂性也在不断增加。传统的 RESTful API 已经不能满足复杂业务需求，而 GraphQL API 作为一种新兴的技术，可帮助我们构建更强大、灵活、高效的 Web API。
Node.js 是一个非常流行的 JavaScript 运行时环境，它可以很好地与 GraphQL 集成，便于我们快速构建 GraphQL API。本文将为大家介绍如何在 Node.js 中构建 GraphQL API，希望能够给大家带来帮助。
GraphQL 简介
GraphQL 是一种由 Facebook 开发的数据查询语言和运行时环境。与传统的 RESTful API 不同，GraphQL API 可以让客户端精确地获取需要的数据，避免了 Over-Fetching 和 Under-Fetching 的问题。GraphQL API 还具有可组合性和可扩展性的优势，可以帮助我们更好地构建现代 Web 应用程序。
GraphQL API 由三个核心组件组成：
Schema： 定义了查询和变异的类型及其关系。它是一个由类型和字段组成的模型，它描述了哪些数据可以被查询，以及如何查询。
Resolver： 用于将 GraphQL 操作映射到对应的数据源。Resolver 将查询结果从服务器返回给客户端。
Query、Mutation 和 Subscription： 这些是用于执行操作的操作类型。它们允许客户端查询、修改和订阅数据。
在构建 GraphQL API 时，我们需要使用一些库和工具。常用的有以下几种：
GraphQL.js：一个纯 JavaScript 实现的 GraphQL 运行时库。
Express：一个流行的 Node.js Web 框架，用于构建 Web 应用和 API。
Apollo Server：一个用于构建 GraphQL API 的库，它提供了完整的 GraphQL 服务器，包括基于 Express、Koa 和 Hapi 的高级集成。
接下来让我们来看一下具体的操作步骤。
步骤一：安装所需库和工具
我们需要在本地安装 GraphQL.js、Express 和 Apollo Server。在命令行中输入以下命令即可：
npm install graphql express apollo-server-express
步骤二：定义 Schema
在构建 GraphQL API 时，第一步是定义 Schema。Schema 定义了我们的数据源中可用的类型和字段。
下面是一个简单的例子，定义了一个查询类型（Query），包含一个名为 hello 的字段。这个字段将返回一条字符串消息。
const { gql } = require('apollo-server-express');
const typeDefs = gql`
type Query {
hello: String
}
`;步骤三：实现 Resolver
Resolver 是一个把 GraphQL 操作映射到实际数据源的函数。在这个例子中，我们实现了一个 hello Resolver，它将返回字符串 Hello world!。
const resolvers = {
Query: {
hello: () => 'Hello world!',
},
};步骤四：创建 Apollo Server
我们需要创建一个 Apollo Server 实例，它会自动将我们的 Schema 和 Resolver 组装起来并生成一个完整的 GraphQL API。在这个例子中，我们使用 Express 框架创建了一个 HTTP 服务器，并将 Apollo Server 挂载在 /graphql 路由上。
-- -------------------- ---- ------- ----- ------- - ------------------- ----- - ------------ - - --------------------------------- ----- ------ - --- -------------- --------- --------- --- ----- --- - ---------- ------------------------ ---- ----- ---------- --- ------------ ----- ---- -- -- -- ------------------- ----- -- -------------------------------------------- --
完成上述步骤后，我们就可以访问 http://localhost:4000/graphql，使用 GraphQL Playground 进行查询了。
总结
本文介绍了如何在 Node.js 中构建 GraphQL API。我们使用了 GraphQL.js、Express 和 Apollo Server 等库和工具，分别定义了 Schema 和 Resolver，并创建了一个 Apollo Server 实例。希望本文可以为大家提供帮助，让大家可以更好地构建现代 Web 应用程序。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64edae37f6b2d6eab37d685d