GraphQL 是一种用于构建 API 的查询语言，它允许客户端指定需要返回的数据结构，而不是像 RESTful API 那样返回整个资源。GraphQL 还具备强大的类型系统，这使得我们可以更好地定义和理解 API 的数据模型。
在 GraphQL 中，Union 类型是一种特殊的类型，它允许我们将多个类型组合在一起，以便在查询中返回多个不同类型的对象。在本文中，我们将探讨如何使用 Union 类型在 GraphQL 中处理多个数据类型。
什么是 GraphQL Union 类型？
在 GraphQL 中，Union 类型是一种用于组合多个类型的特殊类型。它类似于 TypeScript 中的联合类型，可以将多个不同的类型组合在一起，以便在查询中返回多个不同类型的对象。
Union 类型的定义方式如下：
union MyUnion = Type1 | Type2 | Type3
其中，MyUnion 是 Union 类型的名称，Type1、Type2、Type3 是需要组合的类型。
如何使用 GraphQL Union 类型？
使用 GraphQL Union 类型非常简单，我们只需要在查询中使用 Union 类型即可。假设我们有两个类型 Book 和 Movie，它们都有一个共同的字段 title，我们可以将它们组合成一个 Union 类型 SearchResult，如下所示：
-- -------------------- ---- ------- ----- ------------ - ---- - ----- ---- ---- - ------ ------- ------- ------- - ---- ----- - ------ ------- --------- ------- - ---- ----- - ------------- --------- ---------------- -
在上面的例子中，我们定义了一个 SearchResult Union 类型，它包含了 Book 和 Movie 两个类型。然后我们定义了一个查询 search，它接收一个参数 query，并返回一个 SearchResult 数组。
当我们执行查询 search 时，GraphQL 会返回一个包含 Book 和 Movie 两种类型的数组，其中每个元素都是 SearchResult 类型的对象。我们可以通过 __typename 字段来判断每个对象的具体类型，例如：
-- -------------------- ---- -------
----- -
------------- ------ -------- -
----------
-----
--- -- ---- -
------
-
--- -- ----- -
--------
-
-
-在上面的查询中，我们使用了 __typename 字段来获取每个对象的具体类型，然后根据类型的不同来获取不同的字段。在本例中，我们使用了 ... on 语法来指定每个类型的字段，这使得我们可以在同一个查询中获取不同类型的数据。
Union 类型的优缺点
Union 类型在 GraphQL 中非常有用，它允许我们将多个不同类型的对象组合在一起，以便在查询中返回多个不同类型的数据。使用 Union 类型还可以帮助我们简化查询，减少重复代码。
然而，Union 类型也有一些缺点。首先，Union 类型不能包含相同的字段，这意味着我们必须为每个类型定义独立的字段。其次，Union 类型可能会导致查询复杂性增加，因为我们需要在查询中使用 __typename 字段来获取每个对象的具体类型。
示例代码
下面是一个使用 Union 类型的示例代码，它将 Book 和 Movie 两种类型组合成了 SearchResult Union 类型。在查询中，我们使用了 __typename 字段来获取每个对象的具体类型，并根据类型的不同来获取不同类型的字段。
-- -------------------- ---- -------
---- ---- -
------ -------
------- -------
-
---- ----- -
------ -------
--------- -------
-
----- ------------ - ---- - -----
---- ----- -
------------- --------- ----------------
-
----- -
------------- ------ -------- -
----------
-----
--- -- ---- -
------
-
--- -- ----- -
--------
-
-
-总结
在 GraphQL 中使用 Union 类型可以帮助我们处理多个数据类型，使得我们可以在查询中返回多个不同类型的对象。Union 类型虽然有一些缺点，但它仍然是一个非常有用的特性，可以帮助我们更好地定义和理解 API 的数据模型。希望本文能够对你在 GraphQL 中使用 Union 类型有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6512795895b1f8cacdaf1a80