GraphQL 最初于 2012 年在 Facebook 开发，作为针对动力不足的移动设备的更好的数据获取解决方案，GraphQL 于 2015 年开源。作为一种为灵活性而设计的 API 技术，GraphQL 是 API 的开发人员和消费者以及他们背后的组织的强大推动者。GraphQL 实现的所有细节和功能都在
中列出。为了编写一个有效的 GraphQL
，必须理解好
GraphQL 类型系统
。
在本文中，将学习 GraphQL 类型：五种内置标量（
）类型、枚举（
）、列表（
）和非空包装（
）类型、对象（
）类型以及与它们一起工作的抽象接口和联合类型（
）。
标量类型
GraphQL 模式中的所有数据最终都解析为各种标量类型，代表原始值。GraphQL 响应可以看作一棵树，标量类型是树末端的叶子。嵌套响应中可以有多个级别，但最后一个级别将始终解析为标量（或枚举）类型。 GraphQL 带有五种内置标量类型：
、
、
、
和
。
Int
是带符号的
位非小数值，它是不包括小数的带符号（正或负）整数。带符号的
位整数的最大值为
。这是用于数值数据的两个内置标量之一。
Float
是带符号的双精度小数值。它是一个带小数点的有符号（正或负）数，例如
，这是用于数值数据的另一个内置标量。
String
是
字符序列。
类型用于任何文本数据，这也可以包括非常大的数字等数据。大多数自定义标量都是字符串数据类型。
Boolean
包含
和
。
ID
是唯一标识符，始终序列化为字符串，即使
是数字也是如此。
类型通常可以用通用唯一标识符 (UUID) 表示。
自定义标量
除了上述这些内置标量之外，还可以使用
关键字来定义自定义标量。可以使用自定义标量来创建具有额外服务器级别验证的类型，例如
、
或
。下面是一个定义新
类型的示例：
服务器将知道如何使用
GraphQLScalarType
处理与这种新类型的交互。
枚举（Enum）类型
类型，也称为
类型，用于描述了一组可能的值。
例如可以为游戏角色的
和
创建一个枚举，其中包含系统将接受的所有值。
通过定义枚举类型可以保证角色的
只能是
或
，并且永远不会意外地成为其他一些随机字符串，如果使用
类型而不是
，那么就有可能是别的随机字符串。
枚举也可以用作参数中的可接受值。例如，可以制作一个
枚举来表示武器是单手（如短剑）还是双手（如重斧），并使用它来确定是否可以装备一个或两个：
枚举已声明为
和
作为值，
字段上的参数具有默认值
，这意味着如果未传递任何参数，它将回默认为
。
非空类型
可能会注意到内置标量列表中缺少
或
（一种被许多语言视为原始类型的常见类型）。
在 GraphQL 中确实存在，表示缺少一个值。默认情况下，GraphQL 中的所有类型都可以为
，因此
是对任何类型的有效响应。为了使值成为必需值，必须将其转换为带有尾随感叹号的 GraphQL 非空类型。
被定义为类型修饰符，这些类型用于修饰它所引用的类型。例如，
是一个可选的（或可为空的）字符串，而
是必需的（或非空的）字符串。
列表类型
GraphQL 中的
类型是另一种类型修饰符。任何用方括号 (
) 括起来的类型都会成为
类型，这是一个定义列表中每个项目类型的集合，像 JavaScript 中的数组。
例如，定义为
的类型意味着这个集合所有元素的类型为
类型，
将是
类型的集合。
和
可以一起使用，使一个类型既需要又定义为
，例如
。
对象类型
如果 GraphQL 标量类型描述分层 GraphQL 响应末尾的“叶子”，那么对象类型描述中间的
，并且 GraphQL 模式中的几乎所有内容都是一种对象类型。
对象由命名字段（键）列表和每个字段将解析为的值类型组成。对象是用
关键字定义的。至少要定义一个或多个字段，字段不能以两个下划线（
）开头，以免与GraphQL自省系统冲突。
例如创建一个
对象来表示游戏中的一种角色：
在此示例中，声明了
对象类型，定义了 4 个字段：
：非空
类型。
：非空字符串类型。
：
类型。
：非空布尔类型。
在声明上方，可以使用双引号添加注释，如本例：
，这将显示为类型的描述。
go语言参考手册 中文CHM版
Go 是一个开源的编程语言，它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册，需要的可以来下载！ Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发，后来还加入了Ian Lance Taylor, Russ Cox等人，并最终于2009年11月开源，在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的，并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译
下载
在此示例中，每个字段都解析为标量类型，但对象字段也可以解析为其他对象类型。例如，可以创建一个
类型，并且可以设置 GraphQL 模式，其中
上的
字段将解析为一个
对象：
对象也可以嵌套到其他对象的字段中。
根操作类型
有三种特殊对象作为 GraphQL
的入口点：
、
和
。这些被称为根操作类型，并遵循与任何其他对象类型相同的规则。
关键字表示 GraphQL 模式的入口点。根
、
和
类型将位于根模式对象上：
Query 类型在任何 GraphQL 模式上都是必需的，代表一个读取请求，类似于
。以下是返回
类型列表的根查询对象的示例：
代表写入请求，类似于
中的
、
或
。在以下示例中，
有一个带有命名参数（输入）的
字段：
最后，一个
对应于一个事件流，它将与 Web 应用程序中的 Websocket 结合使用。如下所示：
请注意，
入口点通常在某些 GraphQL 实现中被抽象掉。
字段参数
GraphQL 对象的字段本质上是返回值的函数，并且它们可以像任何函数一样接受参数。字段参数由参数名称后跟类型定义，参数可以是任何非对象类型。在此示例中，可以通过
字段（解析为非空
类型）过滤
对象：
这个特定示例对于从数据存储中获取单个项目很有用，但参数也可用于过滤、分页和其他更具体的查询。
接口类型
与
类型一样，抽象接口类型由一系列命名字段及其关联的值类型组成。接口看起来像并遵循与对象相同的所有规则，但用于定义对象实现的子集。
到目前为止，在
中有一个
对象，但可能还想创建一个
、一个
和其他对象，它们将共享大部分相同的字段但还是存在一些差异。在这种情况下，可以使用接口来定义它们共有的字段，并创建作为接口实现的对象。
在下面的示例中，使用
关键字创建
接口，其中包含每种类型的字符将拥有的所有字段：
每个角色类型都有字段
、
、
、
和
。
现在，假设有一个具有这些共享字段的
类型和一个
类型，但是
使用
而
使用
。可以使用
关键字将每个描述为
实现，这意味着它们必须具有创建的接口中的所有字段：
和
都是
接口的有效实现，因为它们具有所需的字段子集。
Union 类型
可以与对象一起使用的另一种抽象类型是
类型。使用
关键字，可以定义一个类型，其中包含所有有效响应的对象列表。
使用上面创建的接口，可以创建一个 Character union，将
定义为
或
：
等号
设置定义，管道符
用作
语句。请注意，
必须由对象或接口组成，标量类型在
上无效。
现在，如果查询
列表，它可以使用
并返回所有
和
类型。
总结
上面学习了定义 GraphQL 类型系统的类型，包括最基本的类型是标量类型由
、
、
、
、
和 GraphQL 实现创建的任何自定义标量类型组成。枚举是有效常量值的列表，当需要对查询响应进行更多控制时，可以使用枚举，而不是简单地将其声明为字符串。列表类型和非空类型被称为类型修饰符
或包装类型
，它们分别可以将其他类型定义为集合类型或必需类型。GraphQL
中的几乎所有内容都是对象类型，包括
、
和
入口点。接口和联合类型是抽象类型，在定义对象时很有用。
【相关推荐：
Go视频教程
、
编程教学
】
GraphQL Schemaschemascalarenumslistnon-nullobjectunionIntFloatStringBooleanIDInt32322,147,483,647Float1.2StringUTF-8StringBooleantruefalseIDIDIDscalarDateTimeUrlDatescalar DateEnumEnumeratorJobSpecies"角色的工作等级"
enum Job {
FIGHTER
WIZARD
}
"性格的种类或血统"
enum Species {
HUMAN
ELF
DWARF
}JobFIGHTERWIZARDStringEnumHandenum Hand { SINGLE
DOUBLE}"战士使用的一种武器"type Weapon {
name: String!
attack: Int
range: Int
hand: Hand
}
type Query {
weapons(hand: Hand = SINGLE): [Weapon]
}HandSINGLEDOUBLEweaponsSINGLESINGLEnullundefinedNullnullnullNon-NullStringString!List[]List[Int]Int[String]StringNon-NullListList[String]!分支type__Fighter"具有直接战斗能力和力量的英雄"
type Fighter {
id: ID!
name: String!
level: Int
active: Boolean!
}FighteridIDnamelevelIntactive具有直接战斗能力和力量的英雄WeaponFighterweaponWeapon"战士使用的一种武器"
type Weapon {
name: String!
attack: Int
range: Int
}
"具有直接战斗能力和力量的英雄"
type Fighter {
id: ID!
name: String!
level: Int
active: Boolean!
weapon: Weapon
}schemaQueryMutationSubcriptionschemaQueryMutationSubcriptionschema {
query: Query
mutation: Mutation
subscription: Subscription
}REST API GETFightertype Query {
fighters: [Fighter]
}MutationsREST APIPOSTPUTDELETEMutationaddFightertype Mutation {
addFighter(input: FighterInput): Fighter
}Subscriptiontype Subscription {
randomBattle(enemy: Enemy): BattleResult
}schemaidIDFightertype Query {
fighter(id: ID!): Fighter
}ObjectschemaFighterWizardHealerinterfaceBaseCharacter"A hero on a quest."interface BaseCharacter {
id: ID!
name: String!
level: Int!
species: Species
job: Job
}idnamelevelspeciesjobFighterWizardFightersWeaponWizardsSpellsimplementsBaseCharactertype 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]
}FighterWizardBaseCharacterunionunioncharacterWizardFighterunion Character = Wizard | Fighter=|ORunionunioncharactersCharacterunionWizardFighterIntFloatStringBooleanIDtype modifierwrapping typeschemaquerymutationsubscription