GraphQL 是一种用于 API 的查询语言和运行时环境。它被广泛用于前端开发中，作为一种替代 RESTful API 的解决方案。GraphQL 具有很多优点，比如数据获取的精确性、可扩展性、类型系统和自文档化等特点。在本文中，我们将深入剖析 GraphQL 的基础知识，包括查询、变量、指令、片段和类型系统等。
查询
GraphQL 查询语言是一种声明式的语言，用于描述数据的形状和结构。它类似于 JSON，但具有更强的类型系统和更灵活的查询语义。查询由字段和嵌套字段组成，每个字段都有一个名称和一个返回类型。例如：
-- -------------------- ---- -------
-
-------- -- -
----
-----
----- -
-----
-------
-
-
-这个查询将返回一个名为 user 的对象，该对象具有 name 和 email 字段，以及一个名为 posts 的对象数组，该数组包含每个帖子的 title 和 content 字段。注意，这个查询还包含一个参数 id，用于指定要查询的用户 ID。
变量
GraphQL 支持变量，可以将查询参数化。变量由 $ 符号和名称组成，例如 $id。变量可以在查询中使用，并在执行查询时通过变量映射进行指定。例如：
query GetUser($id: Int!) {
user(id: $id) {
name
email
}
}这个查询定义了一个名为 GetUser 的查询，它接受一个名为 id 的整数类型变量，并返回一个名为 user 的对象，该对象具有 name 和 email 字段。注意，变量的类型可以在变量名称后面指定，并用 ! 表示必填。
指令
GraphQL 支持指令，用于在查询中添加条件逻辑和控制查询行为。指令由 @ 符号和名称组成，例如 @include 和 @skip。指令可以用于字段或片段，并在执行时修改查询行为。例如：
-- -------------------- ---- -------
-
-------- -- -
----
-----
------------ --- -
-----
-------
-------- ------------ -------------- -
------
----
-
-
-
-这个查询包含一个名为 comments 的字段，并使用 @include 指令控制是否包含评论。如果变量 $withComments 为 true，则评论将包含在查询结果中。
片段
GraphQL 支持片段，用于将查询的部分抽象为可重用的组件。片段由 fragment 关键字和名称组成，例如 fragment UserFields。片段可以包含一个或多个字段，并可以在查询中重复使用。例如：
-- -------------------- ---- -------
-------- ---------- -- ---- -
----
-----
-
----- ------------ ----- -
-------- ---- -
-------------
------------ --- -
-----
-------
-------- -
----------------
-
-
-
-
-------- ------------- -- ------- -
------
----
-这个查询定义了两个片段 UserFields 和 CommentFields，并在查询中重复使用。注意，片段可以包含嵌套的片段，从而创建复杂的查询组合。
类型系统
GraphQL 具有强大的类型系统，用于描述数据的结构和关系。类型由 type 关键字和名称组成，例如 type User。类型可以包含字段和方法，并可以相互嵌套。例如：
-- -------------------- ---- ------- ---- ---- - --- --- ----- ------- ------ ------- ------------ ---- ------ -------- -------- - ---- ---- - --- --- ------ ------- -------- ------- ------- ----- --------------- ---- ------ -------- ----------- - ---- ------- - --- --- ------- ----- ----- ------- -
这个类型系统定义了三个类型 User、Post 和 Comment，并描述了它们之间的关系。例如，User 类型具有 id、name、email 和 posts 字段，其中 posts 字段接受 first 和 after 参数，并返回一个 Post 对象数组。
结论
本文深入剖析了 GraphQL 的基础知识，包括查询、变量、指令、片段和类型系统等。GraphQL 具有很多优点，可以提高数据获取的精确性、可扩展性和可维护性。在使用 GraphQL 时，我们应该熟悉其基础知识，并根据实际需求进行灵活应用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6724bb8a2e7021665e152482