GraphQL是一种先进的查询语言，用于API的构建和查询数据，已经成为现代Web API的首选方案之一。而GraphQL的一个重要特点是能够将多个API（或者说服务）组合成一个API，从而实现任意查询的目的。而GraphQL-Stitcher能够帮助我们更加容易地完成这个目标。
GraphQL-Stitcher是什么？
GraphQL-Stitcher是一个用于组合不同GraphQL服务（或者说Schema）的工具，它支持本地Schema和远程Schema的组合，以及不同API之间的关联。它可以让你通过一种简单的方式，将不同的服务组合成一个单独的GraphQL服务，并且支持Query、Mutation和Subscription等操作。
GraphQL-Stitcher的原理
使用GraphQL-Stitcher，我们可以通过schema的方式来定义GraphQL服务的结构，其原理如下：
- 定义一个本地Schema，也就是你想要暴露给客户端的GraphQL服务。
- 扩展本地Schema，通过定义远程Schema来合并两个不同的GraphQL服务。
- 通过Resolver来描述在需要执行的Query或者Mutation时应该怎么做，比如另外一个API需要被调用，或者新的数据源需要被访问。
- 通过Stitcher将不同的Schema合并成一个。
GraphQL-Stitcher的基本使用方法
以下是GraphQL-Stitcher的基本使用流程：
- 安装npm包：
npm install graphql-stitcher --save - 创建本地Schema，为其定义Types、Fields、Query等，例如：
-- -------------------- ---- -------
----- - -------------------- - - ------------------------
----- - ------------- - - --------------------------------
----- - -------------- ------------------ ------------- - - ------------------
----- ------- - --- ---------------
------ --- -------------------
----- --------
------- -
------ -
----- --------------
--------- -
------ -------
-
-
-
--
--- 定义合并的Schema，定义Schema中的Extensions，然后将本地Schema和远程Schema合并，例如：
-- -------------------- ---- -------
----- - ---------------- - - ------------------------------
----- - -------- - - ---------------------------
----- - ------------ - - -------------------------------
----- -------- - --- ---------- ---- -------------------------- --
----- ------- - ----- --------------------------
----- -------------- - --------------
----------- -
-
------- -------
--
-
------- -------
-
--
--- 定义Resolver，例如：
-- -------------------- ---- -------
----- - ---------------- - - ----------------------------------
----- -------- - -
------ -
----- --------- ------ -------- ----- -- -
------ ------------------
------- --------
---------- --------
---------- ---------
----- - ----- ---------- --
--------
----
--
-
-
-- 通过Stitcher将所有的Schema合并成最终的Schema，例如：
-- -------------------- ---- -------
----- - ------------- - - --------------------------------
----- ----------- - ---------------
----------- -
-
------- --------
------ -
------ -
-
-
--
-
------- --------
------ -
------ -
------- -
------- -
-------- -------------------
-
-
-
-
-
-
--- 最后将Schema传递给GraphQL Server进行查询。
GraphQL-Stitcher的实例操作
接下来，我们举个例子来说明如何使用GraphQL-Stitcher。假设我们有两个远程的GraphQL服务A和B，现在我们想要将他们组合，以便我们能够在客户端上查询到他们中的所有数据。具体的操作步骤如下：
-- -------------------- ---- -------
------ - ------------- - ---- -------------------
----- ------- - --- -- ------------
----- ------- - --- -- ------------
----- -------------- - ---------------
----------- -
- ------- ------- --
- ------- ------- -
--
---
-- --------------------------------这样我们就完成了远程服务A和B的合并。注意，如果两个服务中有相同的字段，那么最后只会保留一个。
总结
本篇文章介绍了GraphQL-Stitcher的基本原理、使用方法和一个实例操作，可以说从零开始让你了解GraphQL-Stitcher的一些基础概念，我们可以借助它轻松地将多个GraphQL服务组合成一个，方便客户端进行查询。在实际的开发中，我们可以根据自己的需求，进一步深入了解GraphQL-Stitcher的高级用法。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600672683660cf7123b365fb