如何在 Express.js 中处理 GraphQL 请求?

阅读时长 8 分钟读完

GraphQL 是一种用于 API 的查询语言,它提供了一种更高效、更强大的方式来获取数据。在前端开发中,我们经常使用 GraphQL 来获取数据,但是在后端开发中,如何处理 GraphQL 请求呢?本文将介绍如何在 Express.js 中处理 GraphQL 请求。

什么是 GraphQL?

GraphQL 是一种由 Facebook 开发的查询语言,它提供了一种更高效、更强大的方式来获取数据。与传统的 RESTful API 不同,GraphQL 允许客户端按照自己的需要来获取数据,而不是服务端返回固定的数据结构。GraphQL 的查询语言非常灵活,可以根据需要来获取不同的数据。GraphQL 还提供了强大的类型系统,可以帮助开发者更好地理解数据结构。

Express.js 是一个流行的 Node.js Web 框架,它提供了丰富的功能和插件,包括处理 GraphQL 请求的功能。下面我们将介绍如何在 Express.js 中处理 GraphQL 请求。

安装依赖

首先,我们需要安装一些依赖:

其中,express 是 Express.js 框架,express-graphql 是处理 GraphQL 请求的插件,graphql 是 GraphQL 的核心库。

创建 Express.js 应用程序

接下来,我们需要创建一个 Express.js 应用程序:

-- -------------------- ---- -------
----- ------- - -------------------
----- - ----------- - - ---------------------------
----- - ----------- - - -------------------

----- ------ - -------------
  ---- ----- -
    ------ ------
  -
---

----- ---- - -
  ------ -- -- ------- -------
--

----- --- - ----------

------------------- -------------
  ------- -------
  ---------- -----
  --------- ----
----

---------------- -- -- -
  ------------------- ------- -- ---- -------
---

在这个例子中,我们创建了一个简单的 GraphQL 查询,查询返回一个字符串 "Hello, world!"。我们将这个查询作为根查询,然后使用 express-graphql 插件来处理 GraphQL 请求。我们将 GraphQL 端点设置为 /graphql,并启用 graphiql,这样我们就可以在浏览器中使用 GraphQL Playground 来测试 GraphQL 查询。

处理 GraphQL 查询

现在我们已经创建了一个 GraphQL 端点,接下来我们需要处理 GraphQL 查询。我们可以通过编写 resolvers 来处理查询。Resolver 是一个函数,它接收查询参数,并返回查询结果。下面是一个简单的 resolver:

在这个例子中,我们创建了一个 user resolver,它接收一个参数 id,并返回一个包含用户信息的对象。在实际应用中,我们可以通过数据库查询来获取用户信息。

处理 GraphQL 变异

除了查询,GraphQL 还支持变异。变异是一种用于修改数据的操作,类似于 RESTful API 中的 POST、PUT、DELETE 等操作。我们可以通过编写 mutation 来处理变异。Mutation 是一个函数,它接收变异参数,并返回变异结果。下面是一个简单的 mutation:

-- -------------------- ---- -------
----- ------ - -------------
  ---- ----- -
    ------ ------
  -

  ---- -------- -
    -------------- ---- ----- ------- ---- ----- ----
  -

  ---- ---- -
    --- ---
    ----- -------
    ---- ----
  -
---

----- ----- - -
  - --- ---- ----- ----- ----- ---- -- --
  - --- ---- ----- ----- ----- ---- -- -
--

----- ---- - -
  ------ -- -- ------- --------
  ----------- -- --- ----- --- -- -- -
    ----- ---- - --------------- -- ------- --- ----
    -- ------- -
      ----- --- ----------- ---- -- ----- --- --------
    -
    -- ------ -
      --------- - -----
    -
    -- ----- -
      -------- - ----
    -
    ------ -----
  -
--

在这个例子中,我们创建了一个 updateUser mutation,它接收三个参数 id、name 和 age,并将用户信息更新到 users 数组中。如果用户不存在,则抛出错误。在实际应用中,我们可以通过数据库更新操作来更新用户信息。

处理 GraphQL 中间件

除了查询和变异,GraphQL 还支持中间件。中间件是一种用于处理请求的函数,类似于 Express.js 中的中间件。我们可以通过编写中间件来处理 GraphQL 请求。下面是一个简单的中间件:

-- -------------------- ---- -------
----- ----------------- - --------- ----- ----- -------- ----- -- -
  ------------------- --------------------------- --------------------- - ------------------------- - ------
  ----------------------- --------------------------
  ----- ----- - -----------
  ----- ------ - ----------
  ----- --- - -----------
  -------------------- ----------------------------
  ------------------ ----- - -----------
  ------ -------
--

----- ---- - -
  ------ -- -- ------- --------
  ----- -- -- -- -- -
    -- -- -- ------
    ------ - --- ----- ----- ----- ---- -- --
  -
--

----- ------ - -------------
  ---- ----- -
    ------ ------
    -------- ----- ----
  -

  ---- ---- -
    --- ---
    ----- -------
    ---- ----
  -
---

----- --- - ----------

------------------- -------------
  ------- -------
  ---------- -----
  --------- -----
  ----------- -- --------- ---------- -------------- ------- ------- -- -- -
    ------ -
      ------------ ---------- - ------------------
    --
  --
  -------- -- -- -
    ------ -
      ---------- -----------
    --
  --
  ----------- -------------------
----

---------------- -- -- -
  ------------------- ------- -- ---- -------
---

在这个例子中,我们创建了一个 loggingMiddleware 中间件,它用于记录 GraphQL 请求的信息。我们将中间件添加到 graphqlHTTP 中间件中,并启用 extensions 选项来返回中间件信息。在实际应用中,我们可以编写更复杂的中间件来处理请求。

结论

在本文中,我们介绍了如何在 Express.js 中处理 GraphQL 请求。我们首先安装了必要的依赖,然后创建了一个 Express.js 应用程序,并编写了 resolvers 和 mutations 来处理 GraphQL 查询和变异。最后,我们还介绍了如何编写中间件来处理 GraphQL 请求。通过本文的学习,读者可以掌握在 Express.js 中处理 GraphQL 请求的方法,并应用到实际项目中。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/675adea84b9d41201abca545

纠错
反馈