irajs-graphql 是一个基于 Node.js 平台的 GraphQL 服务端实现。它提供了一个简单而强大的方式来定义和发布你的 GraphQL API，同时也提供了一些有用的工具和插件来帮助你更好地管理你的 API。
在本文中，我将介绍如何使用 irajs-graphql 包来创建和管理 GraphQL API，并提供一些示例代码和使用技巧。
安装 irajs-graphql
要开始使用 irajs-graphql，你需要在本地机器上安装 Node.js（建议使用最新的 LTS 版本）。然后，你可以使用 npm 命令来安装 irajs-graphql 包：
npm install irajs-graphql
安装完成后，你可以在你的项目中使用它。
创建一个简单的 GraphQL API
现在，我们将使用 irajs-graphql 包来创建一个简单的 GraphQL API。在你的项目目录下创建一个名为 server.js 的文件，并编写以下代码：
-- -------------------- ---- -------
----- ----- - -------------------------
-----------------
------- -
---- ----- -
------ ------
-
--
---------- -
------ -
------ -- -- ------ -------
-
-
--------------- -- -- -
-------------------- --- ------- -- ------------------------
---在这个示例中，我们定义了一个名为 Query 的 GraphQL 类型，并为它提供了一个名为 hello 的简单字段。我们还为 hello 字段提供了一个简单的解析函数，它返回了字符串 'Hello world!'。
然后，我们使用 irajs.createApi() 函数创建了一个 GraphQL API，并将其绑定到 4000 端口。最后，我们在控制台上输出了一个简单的消息，以便了解我们的 API 正在运行。
现在，你可以在浏览器或客户端中使用你的 GraphQL API 了。在浏览器中打开 http://localhost:4000/graphql，你将看到一个 GraphQL Playground 界面。在左侧的面板中输入以下查询：
query {
hello
}然后点击运行按钮，你将在右侧的面板中看到一个字符串 'Hello world!'。
添加更复杂的字段和类型
现在，让我们给我们的 API 添加一些更复杂的字段和类型。我们将在 books 和 authors 两个类型之间建立一个简单的关系。在 server.js 文件中添加以下代码：
-- -------------------- ---- -------
----- ----- - -------------------------
----- ---- - -
------ -
-
--- ----
------ -------- --- -----------
--------- ---
--
-
--- ----
------ --------- ---------
--------- ---
--
-
--- ----
------ -------- ----------- ---- ---------
--------- ---
-
--
-------- -
-
--- ----
----- ----- ----
--
-
--- ----
----- ----- ------
-
-
--
----- -------- - -
---- ---- -
--- ---
------ -------
------- -------
-
---- ------ -
--- ---
----- -------
------ -------
-
---- ----- -
------ -------
-------- ---------
-
--
----- --------- - -
------ -
------ -- -- -----------
-------- -- -- ------------
--
----- -
------- -------- -- ------------------------ -- --------- --- ----------------
--
------- -
------ -------- -- ---------------------- -- ------------- --- ----------
-
--
-----------------
------- ---------
---------- ---------
--------------- -- -- -
-------------------- --- ------- -- ------------------------
---在这个示例中，我们定义了两个类型：Book 和 Author。我们还定义了一个名为 books 和 authors 的查询字段，它们将返回一个包含所有图书和作者的数组。
我们还为 Book 类型定义了一个名为 author 的字段，并提供了一个简单的解析函数，以便在检索图书时返回相应的作者信息。我们还为 Author 类型定义了一个名为 books 的字段，它将返回一个包含该作者所写的所有图书的数组。
最后，我们在 createApi() 函数中传入了 typeDefs 和 resolvers 变量，这使得我们可以在控制台中测试我们的新 API。
使用 middleware 和插件
irajs-graphql 提供了许多有用的中间件和插件，可以帮助你更好地管理你的 GraphQL API。让我们来看看一些最有用的。
使用 GraphiQL 中间件
GraphiQL 是一个出色的工具，可用于与 GraphQL API 交互和调试。如果你希望将 GraphiQL 与你的 irajs-graphql API 集成，你可以使用 irajs-graphql 自带的 graphiql-middleware。
在 server.js 文件中添加以下代码：
-- -------------------- ---- ------- ----- ----- - ------------------------- ----- ------------------ - --------------------------------------------- -- --- ----------------- ------- --------- ---------- --------- -- ------------------------- --------- ---------- --- ------------- -- -- - -------------------- --- ------- -- ------------------------ ---
在这个示例中，我们使用 irajs.createApi() 函数创建了一个GraphQL API，然后使用 use() 方法添加了 graphiqlMiddleware 中间件。我们还指定了 endpoint 选项，它告诉 GraphiQL 在哪个端点上使用我们的 GraphQL API。
现在，你可以在浏览器中访问 http://localhost:4000/graphiql，并以相同的方式调用 GraphiQL。
使用 DataLoader
DataLoader 是一个出色的 JavaScript 库，可用于批量加载和缓存数据库中的数据，以便减轻数据库的负载。如果你希望在 GraphQL API 中使用 DataLoader，你可以使用 irajs-graphql-dataloader 插件。
在 server.js 文件中添加以下代码：
-- -------------------- ---- -------
----- ----- - -------------------------
----- ---------- - ----------------------
----- ---------------- - ------------------------------------
----- ------------ - --- -------------- -- -
----- ------- - -------------------------- -- -------------------------
------ ---------- -- ------------------- -- --------- --- -----
---
-- ---
-----------------
------- ---------
---------- ---------
--
-----------------------
-------- -
------- ------------
-
---
------------- -- -- -
-------------------- --- ------- -- ------------------------
---在这个示例中，我们创建了一个名为 authorLoader 的 DataLoader 实例，并为它提供了一个简单的函数，用于根据 id 批量加载作者数据。我们还在 createApi() 函数中使用了 dataloaderPlugin 插件，并指定了用于加载作者数据的 authorLoader 实例。
现在，在 Book 类型中的 author 字段解析函数中，你可以使用 authorLoader.load(parent.authorId) 异步加载作者数据。这将大大减轻 API 对数据库的负载。
结论
irajs-graphql 是一个强大而简单的 GraphQL 服务端实现。在本文中，我们详细介绍了如何在你的项目中使用它来创建和管理 GraphQL API。我们还介绍了一些中间件和插件，以帮助你更好地管理你的 API。
如果你是一个前端开发者，或者对 GraphQL 和 Node.js 有兴趣，我强烈建议你尝试使用 irajs-graphql 包。它将使你更容易高效地创建和管理 GraphQL API，并帮助你更好地管理你的代码。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600572e481e8991b448e9140