在 GraphQL 项目中，通常需要将多个模块的类型定义（type definitions）合并为一个统一的定义。这个过程可以手动完成，但是会很麻烦，特别是当需要合并的模块非常多的时候。为了方便开发，有一个 npm 包叫做 merge-graphql-schemas 可以自动完成这个过程。在这篇文章中，我们将详细介绍这个 npm 包的使用方法，并附带一些示例代码和指导意义。
安装
首先需要在项目中安装这个 npm 包。可以使用 npm 或者 yarn 安装：
npm install merge-graphql-schemas
或者
yarn add merge-graphql-schemas
使用方法
首先需要将需要合并的所有模块的类型定义文件都存放在一个文件夹中，例如在项目的 src/schema 文件夹中。在这个文件夹中，我们需要创建一个名为 index.js 的文件，并在其中导入需要合并的所有类型定义文件。
例如，我们有两个类型定义文件：User.js 和 Post.js，它们的路径分别是 src/schema/User.js 和 src/schema/Post.js。我们在 src/schema 目录下创建一个 index.js 文件，并在其中写入以下代码：
import { mergeTypes } from 'merge-graphql-schemas';
import path from 'path';
import { loadFilesSync } from '@graphql-tools/load-files';
const typesArray = loadFilesSync(path.join(__dirname, './**/*.js'));
export default mergeTypes(typesArray, { all: true });在这个代码中，我们首先导入了 merge-graphql-schemas 的 mergeTypes 方法，以及用于加载文件的 @graphql-tools/load-files 包中的 loadFilesSync 方法和 path 包。然后，我们使用 loadFilesSync 方法加载了 src/schema 文件夹中的所有 .js 文件，存放在一个数组中，最后使用 mergeTypes 方法将这个数组中的所有类型定义合并为一个。
这个时候，我们的所有类型定义文件都已经合并成为一个文件，可以在其他地方导入使用了。例如，在创建 GraphQLServer 的时候，我们可以这样使用这个合并后的类型定义文件：
import { gql, makeExecutableSchema } from 'apollo-server-express';
import typeDefs from '../schema';
const schema = makeExecutableSchema({
typeDefs: gql(typeDefs),
});这样就完成了合并类型定义文件的过程。
指令
merge-graphql-schemas 还提供了一些指令，可以在类型定义文件中使用，以方便地完成一些常见的操作。
#import
#import 指令可以在一个文件中引入另一个文件的类型定义。例如，我们有一个 User.js 文件，它定义了一个 User 类型，其中包含一个字段 author，它引用了一个 Post.js 文件中定义的 Post 类型。我们可以在 User.js 文件中使用 #import 指令来引入这个类型定义：
#import Post from './Post'
type User {
id: ID!
name: String!
email: String!
author: Post
}在上面的代码中，我们使用 #import 指令将 Post.js 中的类型定义引入到 User.js 中，并在 User 类型中使用了这个引入的类型定义。
#merge
#merge 指令可以用于合并多个类型定义。例如，假设我们有两个 Post.js 文件，分别定义了 Post 和 Comment 两个类型，并且这两个类型都包含了 id 字段。我们可以在 typeDefs.js 文件中使用 #merge 指令将这个重复的字段合并在一起：
-- -------------------- ---- ------- ------------ ------- ---- ---- - --- --- ------ ------- -------- ------- - ------------ ---------- ---- ------- - --- --- ----- ------- -
在上面的代码中，我们使用 #merge 指令将 Post 和 Comment 两个类型定义中的 id 字段合并了起来。如果这两个类型定义中还存在其他重复的字段，也可以使用 #merge 指令将它们合并在一起。
示例代码
在下面的示例代码中，我们演示了如何使用 merge-graphql-schemas 包来合并 GraphQL 模块的类型定义文件。
-- -------------------- ---- -------
-- ------------------
------ ------- -
---- ---- -
--- ---
----- -------
------ -------
------ ------
-
--
-- ------------------
------ ------- -
---- ---- -
--- ---
------ -------
-------- -------
---------- -------
-
--
-- -------------------
------ - ---------- - ---- ------------------------
------ ---- ---- -------
------ - ------------- - ---- ----------------------------
----- ---------- - ---------------------------------- --------------
------ ------- ---------------------- - ---- ---- ---
-- -------------
------ - ------------- --- - ---- ------------------------
------ -------- ---- -----------
----- --------- - -
-- --------- ---- -------
--
----- ------ - --- --------------
--------- --------------
----------
---
----------------------- --- -- -- -
--------------- ------ ----- -- ---------
---学习和指导意义
merge-graphql-schemas 包提供了一个简单且方便的方法来合并 GraphQL 模块的类型定义文件，极大地简化了 GraphQL 项目的开发过程。此外，该包还提供了一些指令，可以帮助我们更轻松地完成一些常见的操作。掌握了这个包的使用方法，可以提高我们的开发效率，让我们更专注于业务逻辑的实现。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5eedb5a2b5cbfe1ea0611464