在前端开发中，构建 API 是一个非常重要的任务。随着现代 Web 应用程序的复杂性不断增加，API 设计和实现变得越来越重要。GraphQL 是一种用于构建 API 的新兴技术，它能够提供更好的开发体验和更好的性能。在本文中，我们将介绍如何使用 GraphQL 和 Express.js 构建 Node API。
什么是 GraphQL？
GraphQL 是一种用于构建 API 的查询语言和运行时。它由 Facebook 开发，旨在解决 RESTful API 的一些问题。GraphQL 允许客户端指定需要的数据，而不是由服务器决定。这种查询语言的灵活性使得客户端能够更好地控制数据，从而提供更好的性能和更好的开发体验。
什么是 Express.js？
Express.js 是一个流行的 Node.js Web 框架，用于构建 Web 应用程序和 API。它提供了一个简单易用的 API，支持路由、中间件和模板引擎等功能。
如何使用 GraphQL 和 Express.js 构建 Node API？
下面是使用 GraphQL 和 Express.js 构建 Node API 的详细步骤。
步骤一：安装依赖
我们需要安装以下依赖：
- express：用于构建 Web 应用程序和 API。
- express-graphql：用于将 GraphQL 集成到 Express.js 应用程序中。
- graphql：GraphQL 的实现。
- graphql-tools：用于构建 GraphQL schema。
可以使用以下命令安装这些依赖：
npm install express express-graphql graphql graphql-tools
步骤二：创建 GraphQL schema
GraphQL schema 是一个描述 API 的结构的对象。它定义了可用的类型、查询和变更等。我们需要创建一个 schema.js 文件，该文件将包含我们的 GraphQL schema。
-- -------------------- ---- -------
----- - -------------------- - - -------------------------
----- -------- - -
---- ----- -
------ ------
-
--
----- --------- - -
------ -
------ -- -- ------ -------
-
--
----- ------ - ----------------------
---------
---------
---
-------------- - -------在上面的代码中，我们定义了一个查询类型 Query，它包含一个名为 hello 的字段，该字段返回字符串 'Hello World!'。我们还定义了一个 resolvers 对象，它包含一个名为 hello 的函数，该函数返回字符串 'Hello World!'。最后，我们使用 makeExecutableSchema 函数将 typeDefs 和 resolvers 对象组合成一个 GraphQL schema。
步骤三：创建 Express.js 应用程序
我们需要创建一个 Express.js 应用程序，并将 GraphQL 集成到该应用程序中。我们需要创建一个 server.js 文件，该文件将包含我们的 Express.js 应用程序。
-- -------------------- ---- ------- ----- ------- - ------------------- ----- ----------- - --------------------------- ----- ------ - -------------------- ----- --- - ---------- ------------------- ------------- ------- --------- ---- ---- ---------------- -- -- - ------------------- ------- -- ---- ------- ---
在上面的代码中，我们创建了一个 Express.js 应用程序，并将 GraphQL 集成到该应用程序中。我们使用 graphqlHTTP 中间件将 GraphQL schema 传递给 Express.js 应用程序。我们还启用了 graphiql，这是一个交互式的 GraphQL IDE，用于测试我们的 API。最后，我们启动了 Express.js 应用程序并将其绑定到端口 4000。
步骤四：测试 API
现在我们已经完成了 GraphQL 和 Express.js 的配置，可以测试我们的 API 了。我们可以使用浏览器或任何 HTTP 客户端来测试 API。在浏览器中，我们可以访问以下 URL：
http://localhost:4000/graphql
这将打开 graphiql，我们可以在其中测试我们的 API。我们可以在左侧面板中编写查询，然后单击运行按钮来执行查询。例如，我们可以编写以下查询：
{
hello
}这将返回以下结果：
{
"data": {
"hello": "Hello World!"
}
}这表明我们的 API 正确工作。
总结
在本文中，我们介绍了如何使用 GraphQL 和 Express.js 构建 Node API。我们学习了 GraphQL 和 Express.js 的基础知识，然后演示了如何创建 GraphQL schema 和 Express.js 应用程序。最后，我们测试了我们的 API，并确认它可以正确工作。GraphQL 和 Express.js 是非常强大的工具，可以帮助我们构建高性能、高质量的 API。如果您正在寻找一种新的 API 架构方法，那么 GraphQL 和 Express.js 绝对值得一试。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6601451ad10417a222c6f440