GraphQL 유형 시스템에 대한 심층 분석

사용자 정의 스칼라

"具有直接战斗能力和力量的英雄" type Fighter { id: ID! name: String! level: Int active: Boolean! }

Enum 유형

"战士使用的一种武器" type Weapon { name: String! attack: Int range: Int } "具有直接战斗能力和力量的英雄" type Fighter { id: ID! name: String! level: Int active: Boolean! weapon: Weapon }

schema { query: Query mutation: Mutation subscription: Subscription }

非空类型

可能会注意到内置标量列表中缺少null或undefined（一种被许多语言视为原始类型的常见类型）。Null在 GraphQL 中确实存在，表示缺少一个值。默认情况下，GraphQL 中的所有类型都可以为null，因此null是对任何类型的有效响应。为了使值成为必需值，必须将其转换为带有尾随感叹号的 GraphQL 非空类型。Non-Null被定义为类型修饰符，这些类型用于修饰它所引用的类型。例如，String是一个可选的（或可为空的）字符串，而String!是必需的（或非空的）字符串。

列表类型

GraphQL 中的List类型是另一种类型修饰符。任何用方括号 ([]) 括起来的类型都会成为List类型，这是一个定义列表中每个项目类型的集合，像 JavaScript 中的数组。

例如，定义为[Int]的类型意味着这个集合所有元素的类型为Int类型，[String]将是String类型的集合。Non-Null和List可以一起使用，使一个类型既需要又定义为List，例如[String]!。

对象类型

如果 GraphQL 标量类型描述分层 GraphQL 响应末尾的“叶子”，那么对象类型描述中间的分支，并且 GraphQL 模式中的几乎所有内容都是一种对象类型。

对象由命名字段（键）列表和每个字段将解析为的值类型组成。对象是用type关键字定义的。至少要定义一个或多个字段，字段不能以两个下划线（__）开头，以免与GraphQL自省系统冲突。

例如创建一个Fighter对象来表示游戏中的一种角色：

"具有直接战斗能力和力量的英雄" type Fighter { id: ID! name: String! level: Int active: Boolean! }

在此示例中，声明了Fighter对象类型，定义了 4 个字段：

• id：非空ID类型。
• name：非空字符串类型。
• level：Int类型。
• active：非空布尔类型。

在声明上方，可以使用双引号添加注释，如本例：具有直接战斗能力和力量的英雄，这将显示为类型的描述。

在此示例中，每个字段都解析为标量类型，但对象字段也可以解析为其他对象类型。例如，可以创建一个Weapon类型，并且可以设置 GraphQL 模式，其中Fighter上的weapon字段将解析为一个Weapon对象：

"战士使用的一种武器" type Weapon { name: String! attack: Int range: Int } "具有直接战斗能力和力量的英雄" type Fighter { id: ID! name: String! level: Int active: Boolean! weapon: Weapon }

对象也可以嵌套到其他对象的字段中。

根操作类型

有三种特殊对象作为 GraphQLschema的入口点：Query、Mutation和Subcription。这些被称为根操作类型，并遵循与任何其他对象类型相同的规则。

schema关键字表示 GraphQL 模式的入口点。根Query、Mutation和Subcription类型将位于根模式对象上：

schema { query: Query mutation: Mutation subscription: Subscription }

Query 类型在任何 GraphQL 模式上都是必需的，代表一个读取请求，类似于REST API GET。以下是返回Fighter类型列表的根查询对象的示例：

type Query { fighters: [Fighter] }

Mutations代表写入请求，类似于REST API中的POST、PUT或DELETE。在以下示例中，Mutation有一个带有命名参数（输入）的addFighter字段：

type Mutation { addFighter(input: FighterInput): Fighter }

最后，一个Subscription对应于一个事件流，它将与 Web 应用程序中的 Websocket 结合使用。如下所示：

type Subscription { randomBattle(enemy: Enemy): BattleResult }

请注意，schema入口点通常在某些 GraphQL 实现中被抽象掉。

字段参数

GraphQL 对象的字段本质上是返回值的函数，并且它们可以像任何函数一样接受参数。字段参数由参数名称后跟类型定义，参数可以是任何非对象类型。在此示例中，可以通过id字段（解析为非空ID类型）过滤Fighter对象：

type Query { fighter(id: ID!): Fighter }

这个特定示例对于从数据存储中获取单个项目很有用，但参数也可用于过滤、分页和其他更具体的查询。

接口类型

与Object类型一样，抽象接口类型由一系列命名字段及其关联的值类型组成。接口看起来像并遵循与对象相同的所有规则，但用于定义对象实现的子集。

到目前为止，在schema中有一个Fighter对象，但可能还想创建一个Wizard、一个Healer和其他对象，它们将共享大部分相同的字段但还是存在一些差异。在这种情况下，可以使用接口来定义它们共有的字段，并创建作为接口实现的对象。

在下面的示例中，使用interface关键字创建BaseCharacter接口，其中包含每种类型的字符将拥有的所有字段：

"A hero on a quest."interface BaseCharacter { id: ID! name: String! level: Int! species: Species job: Job }

每个角色类型都有字段id、name、level、species和job。

现在，假设有一个具有这些共享字段的Fighter类型和一个Wizard类型，但是Fighters使用Weapon而Wizards使用Spells。可以使用implements关键字将每个描述为BaseCharacter实现，这意味着它们必须具有创建的接口中的所有字段：

type Fighter implements BaseCharacter { id: ID! name: String! level: Int! species: Species job: Job! weapon: Weapon } type Wizard implements BaseCharacter { id: ID! name: String! level: Int! species: Species job: Job! spells: [Spell] }

Fighter和Wizard都是BaseCharacter接口的有效实现，因为它们具有所需的字段子集。

Union 类型

可以与对象一起使用的另一种抽象类型是union类型。使用union关键字，可以定义一个类型，其中包含所有有效响应的对象列表。

使用上面创建的接口，可以创建一个 Character union，将character定义为Wizard或Fighter：

union Character = Wizard | Fighter

等号=设置定义，管道符|用作OR语句。请注意，union必须由对象或接口组成，标量类型在union上无效。

现在，如果查询characters列表，它可以使用Characterunion并返回所有Wizard和Fighter类型。

总结

上面学习了定义 GraphQL 类型系统的类型，包括最基本的类型是标量类型由Int、Float、String、Boolean、ID和 GraphQL 实现创建的任何自定义标量类型组成。枚举是有效常量值的列表，当需要对查询响应进行更多控制时，可以使用枚举，而不是简单地将其声明为字符串。列表类型和非空类型被称为类型修饰符type modifier或包装类型wrapping type，它们分别可以将其他类型定义为集合类型或必需类型。GraphQLschema中的几乎所有内容都是对象类型，包括query、mutation和subscription入口点。接口和联合类型是抽象类型，在定义对象时很有用。

【相关推荐：Go视频教程、编程教学】

위 내용은 GraphQL 유형 시스템에 대한 심층 분석의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!