GraphQL 强化版:介绍 Schema Stitching 技术

阅读时长 4 分钟读完

GraphQL 是一种用于 API 的查询语言,它可以让客户端精确地指定想要查询的数据和形式,避免过度获取数据的问题。然而,在现实开发中,我们很少只使用单个 GraphQL 服务,通常需要整合多个 GraphQL 服务或与 RESTful API 结合使用。

传统的做法是使用网关或中间件将多个服务连接起来,这样会导致多层嵌套,对维护和扩展都非常不友好。而 GraphQL 官方提供了一个解决方案,就是 Schema Stitching 技术。

什么是 Schema Stitching

Schema Stitching 可以将多个 GraphQL Schema (每个服务都有一个自己的 Schema)合并成一个完整的 Schema,这样客户端就可以像访问单一 Schema 一样访问整个联合 Schema,避免了嵌套的层级关系。Schema Stitching 会根据服务之间的关系合并 Schemas 中的类型、查询和 mutation,使得所有类型在单个 Schema 中都是唯一的。

合并方式

GraphQL 通过 schema stitching 以两种方式合并 schema。第一种方式是使用类型合并,这可以合并两个已知的类型,而不改变它们的行为。第二种方式是使用属性合并。这允许我们将两个独立的 resolvers 合并并公开一个单独的 API。属性合并会更新 resolvers,并且该结果将使用已知的属性并响应查询。

实现过程

首先我们需要导入 mergeSchemasmakeExecutableSchema 方法,来创建一个新的 schema,并将多个 GraphQL Schemas 合并成一个完整的 Schema。

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

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

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

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

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

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

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

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

上述代码可将两个独立的 GraphQL Schemas 合并成一个新的 schema,包含了 UserProduct 两个类型。

我们可以在 schemas 参数中传递更多的 Schemas,以便将它们复合为一个具有单独名称的 Schema。

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

使用

完成合并后,我们就可以像使用单一 Schema 一样使用合并后的 Schema。我们可以向查询发送对所有服务的请求,而无需知道我们实际上查询了哪个服务。例如,我们可以查询用户和产品:

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

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

当使用给定的查询请求查询 Schema 时,Schema Stitching 确认发生在所有服务之间,并将结果按照我们的查询规范编排。

总结

Schema Stitching 技术能够让我们在整合多个 GraphQL 服务时有效避免嵌套的层级关系,从而使维护和扩展变得更加友好。通过以上简单介绍以及示例代码的演示,相信读者能够更好地理解和掌握这一技术,并在实际开发中灵活应用。

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

纠错
反馈