GraphQL 是一种由 Facebook 开发的 API 查询语言和运行时，它可以让客户端精确地描述需要的数据，并且可以减少网络请求的数量。Koa.js 是一个基于 Node.js 的 Web 应用框架，它提供了一个简单而强大的中间件机制，可以让我们轻松地扩展和修改应用程序的功能。在本文中，我们将介绍如何在 Koa.js 中使用 GraphQL。
安装依赖
首先，我们需要安装必要的依赖。我们将使用 apollo-server-koa 包来创建 GraphQL 服务器和 graphql 包来定义和解析 GraphQL 模式。运行以下命令来安装这些包：
npm install apollo-server-koa graphql
创建 GraphQL 服务器
接下来，我们需要创建一个 GraphQL 服务器。我们将使用 apollo-server-koa 包中的 ApolloServer 类来创建服务器。在 app.js 文件中添加以下代码：
-- -------------------- ---- -------
----- --- - ---------------
----- - ------------- --- - - -----------------------------
----- --- - --- ------
----- -------- - ----
---- ----- -
------ ------
-
--
----- --------- - -
------ -
------ -- -- ------ -------
-
--
----- ------ - --- -------------- --------- --------- ---
------------------------ --- ---
---------------- -- -- -
------------------- ----- -- ------------------------
---在这里，我们定义了一个 Query 类型，它包含一个名为 hello 的字段，该字段返回一个字符串 "Hello world!"。我们还定义了一个名为 resolvers 的对象，它包含一个名为 hello 的函数，该函数返回字符串 "Hello world!"。最后，我们使用 ApolloServer 类创建一个服务器，并将其应用到 app 实例上。
查询 GraphQL 服务器
现在我们已经创建了一个 GraphQL 服务器，我们可以使用 GraphiQL 工具来查询它。GraphiQL 是一个交互式的 GraphQL IDE，它可以让我们在浏览器中构建和测试 GraphQL 查询。
要使用 GraphiQL，我们需要访问 http://localhost:3000/graphql。在 GraphiQL 中，我们可以编写和运行查询。例如，我们可以编写以下查询：
query {
hello
}这将返回以下结果：
{
"data": {
"hello": "Hello world!"
}
}添加更多类型和字段
现在我们已经创建了一个简单的 GraphQL 服务器，让我们添加一些更多的类型和字段。首先，我们将添加一个 User 类型，它包含一个 id 字段和一个 name 字段。我们还将添加一个名为 users 的查询，该查询返回一个 User 类型的数组。在 app.js 文件中添加以下代码：
-- -------------------- ---- -------
----- -------- - ----
---- ---- -
--- ---
----- -------
-
---- ----- -
------ ------
------ ------
-
--
----- ----- - -
- --- -- ----- ------- --
- --- -- ----- ----- --
- --- -- ----- --------- -
--
----- --------- - -
------ -
------ -- -- ------ --------
------ -- -- -----
-
--在这里，我们定义了一个 User 类型，它包含一个 id 字段和一个 name 字段。我们还定义了一个名为 users 的查询，该查询返回一个 User 类型的数组。我们还定义了一个名为 users 的数组，其中包含三个用户对象。最后，我们将 users 数组作为 users 查询的返回值。
现在我们可以使用 GraphiQL 工具来查询 users 查询。例如，我们可以编写以下查询：
query {
users {
id
name
}
}这将返回以下结果：
-- -------------------- ---- -------
-
------- -
-------- -
- ----- ---- ------- ------- --
- ----- ---- ------- ----- --
- ----- ---- ------- --------- -
-
-
-使用参数
接下来，让我们添加一个带有参数的查询。我们将添加一个名为 user 的查询，该查询接受一个名为 id 的参数，并返回具有相应 id 的用户对象。在 app.js 文件中添加以下代码：
-- -------------------- ---- -------
----- -------- - ----
---- ---- -
--- ---
----- -------
-
---- ----- -
------ ------
------ ------
-------- ----- ----
-
--
----- ----- - -
- --- -- ----- ------- --
- --- -- ----- ----- --
- --- -- ----- --------- -
--
----- --------- - -
------ -
------ -- -- ------ --------
------ -- -- ------
----- --- - -- -- -- --------------- -- ------- -- ---
-
--在这里，我们定义了一个名为 user 的查询，它接受一个名为 id 的参数，并返回具有相应 id 的用户对象。我们还更新了 resolvers 对象，以便将 id 参数传递给 user 查询。
现在我们可以使用 GraphiQL 工具来查询 user 查询。例如，我们可以编写以下查询：
query {
user(id: 2) {
id
name
}
}这将返回以下结果：
{
"data": {
"user": {
"id": "2",
"name": "Bob"
}
}
}结论
在本文中，我们介绍了如何在 Koa.js 中使用 GraphQL。我们创建了一个简单的 GraphQL 服务器，并添加了一些类型和字段。我们还介绍了如何使用 GraphiQL 工具来查询服务器，并展示了如何使用参数来查询特定的数据。GraphQL 是一个强大的工具，可以帮助我们更好地组织和管理应用程序的数据。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6762d229856ee0c1d40bc352