使用 GraphQL 对数据库进行查询

阅读时长 10 分钟读完

GraphQL 是一种用于 API 的查询语言,它被用于 Web 应用程序中,以便客户端可以按照其需要精确地提取数据。与传统的 RESTful API 相比,GraphQL 具有更好的灵活性、安全性和可管理性。在本文中,我们将深入了解如何使用 GraphQL 对数据库进行查询。

GraphQL 简介

GraphQL 是一种用于 API 的查询语言,它由 Facebook 开发。它使得客户端可以按照其需要精确地获取所需的数据,并且不会得到任何其他不需要的数据。GraphQL 使用类型来确保查询的准确性,并允许多个查询嵌套在一起以提高代码清晰度。

在 GraphQL 中,应用程序的客户端发送一个具有描述请求的数据结构的查询,并收到仅包含他们所需数据的响应。这个查询描述了需要返回的字段及其类型、数据源以及如何关联多个数据源。这就使得 GraphQL 的查询具有更好的可扩展性和可维护性。

GraphQL 如何与数据库交互

GraphQL 本身并不是数据库或后端语言,它只是一种查询语言。因此,您需要在服务器端实现逻辑以向数据库发送查询,并将结果转换为 GraphQL 的响应格式。

在使用 GraphQL 与数据库交互时,您需要两个重要的组件:模型和解析器。

模型

模型是一个简单的 JavaScript 对象,它定义了数据模型的结构、关系和类型。每个对象代表一个表或集合,并描述其字段以及字段类型。在大多数情况下,您的模型将是您应用程序使用的主要数据源,并提供用于读取、创建、更新和删除数据的方法。

下面是一个示例的用户模型,它定义了“User”对象的结构和字段:

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

解析器

解析器是用于验证和执行 GraphQL 查询的代码的核心组件。它读取查询字符串并将其解析为对应的数据源查询。它还负责验证查询是否正确,以及从数据源返回一个正确的响应。

GraphQL 的查询解析过程包括以下步骤:

  1. 从客户端接收查询字符串。
  2. 将查询字符串解析为抽象语法树 (AST)。
  3. 验证查询,以确保它符合模型的结构和类型。
  4. 使用 AST 执行查询。
  5. 将数据库结果映射为 GraphQL 响应类型。
  6. 返回响应。

下面是一个简单的解析器示例:

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

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

在这个示例中,我们定义了查询类型“RootQueryType”,它包含了两个查询:“user”和“post”。每个解析器负责从模型中读取或查询数据,并将其转换为 GraphQL 可识别的类型。

示例

假设我们创建了一个名为“Blog”的博客应用程序,并使用 MongoDB 作为我们的数据源。我们需要为应用程序创建一个 GraphQL API,使得客户端可以查询和获取博客文章和作者的信息。

下面是一个简单的服务器端示例,它使用 Apollo Server 和 Mongoose 进行实现:

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

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

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

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

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

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

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

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

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

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

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

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

在这个例子中,我们分别定义了“User”和“Post”模型,并创建了 GraphQL 的“UserType”和“PostType”。这些类型定义了数据库中数据的结构和关系,并告诉 GraphQL 如何查询并返回它们的数据。

我们还定义了“RootQuery”和“Mutation”类型。这给我们提供了用于查询和变更数据的终端。

最后,我们创建了一个基于 Express 的服务器,并将 Apollo Server 添加到应用中。当客户端请求一个 GraphQL 查询时,我们的服务器将代替客户端与数据库交互,并返回查询结果。

结论

使用 GraphQL 查询数据库可以使应用程序更加灵活、高效和可维护。在本文中,我们了解了如何使用模型和解析器来实现 GraphQL API,并提供了一个示例服务器端实现。

当您为您的应用程序实现 GraphQL 时,请确保考虑您的应用程序的结构和需求,并首先编写良好的模型。然后,使用您的模型创建解析器和查询类型,以支持客户端的查询和变更操作。

希望这篇文章能为您带来帮助,谢谢阅读!

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

纠错
反馈