9 定义GraphQL架构之定义子类型与枚举

在上一篇文章中，我们讨论了如何创建变更类型以处理数据修改。现在，我们将继续深入探讨GraphQL架构的定义，重点是如何定义子类型（Object Types）和枚举（Enums）。

理解子类型

在GraphQL中，子类型用于描述数据的结构和内容。例如，假设我们要构建一个图书馆管理系统，我们可能有一个 Book 类型，用于描述书籍的信息。以下是一个简单的 Book 类型定义：

type Book {
  id: ID!
  title: String!
  author: Author!
  publishedYear: Int
}

在这个示例中：

• id 是一个唯一标识符，使用 ID 类型。
• title 是书籍的标题，使用 String 类型。
• author 是书籍的作者，引用了另一个类型 Author。
• publishedYear 是书籍的出版年份，使用 Int 类型，可以是可选的。

我们可以先定义一个 Author 类型：

type Author {
  id: ID!
  name: String!
  birthYear: Int
}

引用子类型

在定义子类型时，我们需要确保可以灵活地引用其他类型。在上述 Book 类型中，我们引用了 Author 类型。这种做法使我们可以轻松地获取书籍和作者之间的关系。

定义枚举

枚举类型在GraphQL中用于定义一组固定的常量值。例如，如果我们要定义书籍的状态，可以使用枚举类型：

enum BookStatus {
  AVAILABLE
  CHECKED_OUT
  RESERVED
}

这里，我们定义了 BookStatus 枚举，它可以有三种状态：AVAILABLE、CHECKED_OUT 和 RESERVED。

结合子类型与枚举

接下来，我们将 BookStatus 枚举集成到 Book 类型中，作为一个属性：

type Book {
  id: ID!
  title: String!
  author: Author!
  publishedYear: Int
  status: BookStatus!
}

在这个例子中，status 属性使用了我们定义的 BookStatus 枚举。这使得在查询书籍时，我们可以明确知道每本书的状态。

完整的GraphQL架构示例

将子类型和枚举结合在一起，你的GraphQL架构可能看起来像这样：

type Author {
  id: ID!
  name: String!
  birthYear: Int
}

enum BookStatus {
  AVAILABLE
  CHECKED_OUT
  RESERVED
}

type Book {
  id: ID!
  title: String!
  author: Author!
  publishedYear: Int
  status: BookStatus!
}

小结

本篇文章介绍了如何在GraphQL架构中定义子类型和枚举。通过子类型，我们能够清晰地描述数据结构，而枚举则帮助我们管理固定的状态值。在下一篇文章中，我们将讨论查询与变更操作，如何执行基本的查询操作，通过实际案例来展示这一过程。

希望本篇内容对你理解GraphQL架构的定义有帮助！在接下来的篇章中，我们将进一步探索GraphQL的强大功能。