GraphQL 是一种用于构建 API 的查询语言。与 REST API 不同，GraphQL 基于数据模型的概念，允许客户端以自己的方式定义数据和关系，从而更加灵活地获取所需的数据。
在 GraphQL 中，数据模型是指每一个可查询的对象及其属性，这些对象和属性可以通过 GraphQL 定义模式进行描述。GraphQl 支持基于类型的架构，这意味着您可以使用自定义类型来定义您的数据模型。
定义 GraphQL 数据模型的方式
有三种定义 GraphQL 数据模型的方式，分别是通过 SDL（Schema Definition Language），GraphQL.js 和代码优先。
通过 SDL（Schema Definition Language）定义
SDL 是一种用于描述 GraphQL API 的标准语言。它是一种声明性语言，用于描述数据模型。下面是一个使用 SDL 定义 GraphQL 数据模型的示例代码：
-- -------------------- ---- ------- ---- ---- - --- --- ----- ------- ------ ------- - ---- ----- - -------- ----- ---- - ------ - ------ ----- -展开代码
在上面的代码中，我们定义了一个名为 User 的类型，它具有 id，name 和 email 三个属性，都是必填项。我们也定义了一个 Query 类型作为查询入口，并定义了一个 user 查询，以 id 参数返回一个 User 类型的对象。最后我们将 Query 类型加到了 schema 中。
使用 GraphQL.js 定义
GraphQL.js 是一个适用于 JavaScript 的 GraphQL 实现，我们也可以使用代码编写 GraphQL 的 schema。下面是一个使用 GraphQL.js 定义 GraphQL 数据模型的示例代码：
-- -------------------- ---- ------- -- -- ---------- -- ----- - ------------------ -------------- ---------- --------------- ------------- - - ------------------- -- -- ---- -- ----- -------- - --- ------------------- ----- ------- ------- - --- - ----- --- ------------------------- -- ----- - ----- --- ----------------------------- -- ------ - ----- --- ----------------------------- -- -- --- -- -- ----- -- ----- --------- - --- ------------------- ----- -------- ------- - ----- - ----- --------- ----- - --- - ----- --- ------------------------- - -- -------- ------ - -- -- -------- ----- -- - -- -- -- --------- -- -- -- --- -- -- ------ ----- ------ - --- --------------- ------ ---------- ---展开代码
在上面的代码中，我们使用 GraphQLObjectType 定义了 User 和 Query 两个类型，其中 User 类型的属性使用了 GraphQLID、GraphQLString 和 GraphQLNonNull 等 GraphQL 提供的类型。然后我们将 Query 类型加到了 schema 中。
代码优先
代码优先是指先编写类型定义，然后通过一些工具生成 schema 对象。这种方式在大型项目中尤为适用，可以提供更加清晰的分层结构。下面是一个使用代码优先方式定义 GraphQL 数据模型的示例代码：
-- -------------------- ---- ------- ----- - -------------------- - - ------------------------- -- ---- ----- -------- - - ---- ---- - --- --- ----- ------- ------ ------- - ---- ----- - -------- ----- ---- - -- -- -- --------- ----- --------- - - ------ - ----- ------ - -- -- -------- ----- -- - -- -- -- --------- -- -- - -- -- ------ -- ----- ------ - ---------------------- --------- ---------- ---展开代码
在上面的代码中，我们使用了 makeExecutableSchema 函数生成了 schema 对象。在这个函数中，参数 typeDefs 是我们定义的类型，并且使用了 GraphQL 的语法，参数 resolvers 是我们定义的实现内容。最后，我们将生成的 schema 对象赋值给 schema 变量。
结语
本文介绍了 GraphQL 的数据模型及其定义方式，包括通过 SDL、GraphQL.js 和代码优先的方法。这些方法都是基于类型的架构，为我们提供了更加灵活和可定制的方式定义数据和关系。作为前端开发者，我们需要深入学习 GraphQL，运用好这个工具，提高我们的开发效率和代码质量。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67c92639e46428fe9e03735c
