GraphQL 是一种用于 API 的查询语言,它被用于 Web 应用程序中,以便客户端可以按照其需要精确地提取数据。与传统的 RESTful API 相比,GraphQL 具有更好的灵活性、安全性和可管理性。在本文中,我们将深入了解如何使用 GraphQL 对数据库进行查询。
GraphQL 简介
GraphQL 是一种用于 API 的查询语言,它由 Facebook 开发。它使得客户端可以按照其需要精确地获取所需的数据,并且不会得到任何其他不需要的数据。GraphQL 使用类型来确保查询的准确性,并允许多个查询嵌套在一起以提高代码清晰度。
在 GraphQL 中,应用程序的客户端发送一个具有描述请求的数据结构的查询,并收到仅包含他们所需数据的响应。这个查询描述了需要返回的字段及其类型、数据源以及如何关联多个数据源。这就使得 GraphQL 的查询具有更好的可扩展性和可维护性。
GraphQL 如何与数据库交互
GraphQL 本身并不是数据库或后端语言,它只是一种查询语言。因此,您需要在服务器端实现逻辑以向数据库发送查询,并将结果转换为 GraphQL 的响应格式。
在使用 GraphQL 与数据库交互时,您需要两个重要的组件:模型和解析器。
模型
模型是一个简单的 JavaScript 对象,它定义了数据模型的结构、关系和类型。每个对象代表一个表或集合,并描述其字段以及字段类型。在大多数情况下,您的模型将是您应用程序使用的主要数据源,并提供用于读取、创建、更新和删除数据的方法。
下面是一个示例的用户模型,它定义了“User”对象的结构和字段:
-- -------------------- ---- ------- ----- ---- - --- ------------------- ----- ------- ------- -- -- -- --- - ----- --------- -- ----- - ----- ------------- -- ------ - ----- ------------- -- ------ - ----- --- ------------------ --------------- ----- - ------ ----------------- -- ------------- --- ---------- - - -- ---
解析器
解析器是用于验证和执行 GraphQL 查询的代码的核心组件。它读取查询字符串并将其解析为对应的数据源查询。它还负责验证查询是否正确,以及从数据源返回一个正确的响应。
GraphQL 的查询解析过程包括以下步骤:
- 从客户端接收查询字符串。
- 将查询字符串解析为抽象语法树 (AST)。
- 验证查询,以确保它符合模型的结构和类型。
- 使用 AST 执行查询。
- 将数据库结果映射为 GraphQL 响应类型。
- 返回响应。
下面是一个简单的解析器示例:
-- -------------------- ---- ------- ----- --------- - --- ------------------- ----- ---------------- ------- - ----- - ----- --------- ----- - --- - ----- --------- - -- --------------- ----- - ------ --------------- -- ------- --- --------- - -- ----- - ----- --------- ----- - --- - ----- --------- - -- --------------- ----- - ------ --------------- -- ------- --- --------- - - - --- ----- ------ - --- --------------- ------ ---------- ---
在这个示例中,我们定义了查询类型“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