GraphQL 是一种新兴的 API 设计语言，它旨在提高客户端与 API 的通信效率，优化数据获取的方式。在前端领域日益广泛的应用，使用 GraphQL 可以降低前后端开发者的交流成本，提高开发效率。在本文中，我们将介绍如何使用 Koa2 搭建 GraphQL 服务。
了解 Koa2
Koa 是一个由 Express 原班人马打造的 Node.js Web 框架，目标是成为一个更小、更富有表现力、更健壮的 Web 框架。Koa2 是对于 Koa 的升级，采用了 async/await 形式的中间件，能够更好地帮助我们处理异步操作。Koa2 能够轻易地集成其他中间件，使得其变得更加强大。
准备工作
在开始之前，我们需要安装 koa2，koa-router 和 koa-bodyparser，分别用于创建 Koa2 应用、路由管理和 POST 请求解析。在命令行中执行以下命令进行安装：
npm install koa2 koa-router koa-bodyparser
此外，我们还需要安装 graphql 和 koa-graphql，前者用于编写和解析 GraphQL 查询，后者用于应用到 Koa2 中。在命令行中执行以下命令进行安装：
npm install graphql koa-graphql
创建 GraphQL Schema
GraphQL Schema 是定义 GraphQL 查询与实际数据交互的方式，包含了所有可供查询的类型和字段。我们需要在 schemas 目录下创建 user.js 文件，用于定义一个 User 类型和一个查询 user 的方法：
-- -------------------- ---- -------
----- -
------------------
-----------
--------------
-------------
- - -------------------
----- -------- - --- -------------------
----- -------
------- -
--- - ----- ---------- --
----- - ----- ------------- --
---- - ----- ---------- -
-
---
----- --------- - --- -------------------
----- --------
------- -
----- -
----- ---------
----- - --- - ----- ---------- - --
-------- --- - -- -- -- - ---- -
-
-
---
-------------- - --- ---------------
------ ---------
---上述代码定义了一个 User 类型和一个查询 user 的方法，方法接收一个 id 参数，并返回查询到的用户对象。这里的 resolve 是一个函数，在执行查询时会被调用，用于获取并返回数据。
搭建 Koa2 服务
在 app.js 文件中，我们需要创建 Koa2 应用，并将 /graphql 路径映射到 GraphQL 查询方法上：
-- -------------------- ---- ------- ----- --- - --------------- ----- ------ - ---------------------- ----- ---------- - -------------------------- ----- ---------- - ----------------------- ----- ------ - -------------------------- ----- --- - --- ------ ----- ------ - --- --------- ---------------------- ------------- ------------ ------- ------- ---------- ----- --------- ---- ---- ------------------------- --------------------------------- -----------------
此处的 graphqlKoa 函数用于将 GraphQL Schema 应用到 Koa2 中，并设置 graphiql: true 属性来启用 GraphiQL 工具，方便我们调试和测试 GraphQL API。
测试 GraphQL API
在浏览器中输入 http://localhost:3000/graphql，将会自动跳转到 GraphiQL 的界面。在左侧的编辑器中输入查询语句：
{
user(id: 1) {
id
name
age
}
}点击右侧的运行按钮，即可得到查询结果：
-- -------------------- ---- -------
-
------- -
------- -
----- --
------- --------
------ --
-
-
-至此，我们完成了一个基本的 GraphQL API 的搭建与测试。
总结
在本文中，我们介绍了如何使用 Koa2 搭建 GraphQL 服务，并通过一个简单的示例程序演示了 GraphQL API 的查询语法和查询结果的返回。相信读者在阅读完本文后，对于 GraphQL 的应用及 Koa2 的基本使用有了更深的理解和认识。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/664829bcd3423812e46b5a16