Question

请您解释为什么如果变异的输入参数是对象，它应该是输入类型？我认为更简单一点就是重用类型而不提供id。

例如：

type Sample {
  id: String
  name: String
}

input SampleInput {
  name: String
}

type RootMutation {
  addSample(sample: Sample): Sample  # <-- instead of it should be
  addSample(sample: SampleInput): Sample
}

对于小对象来说没问题，但是当你有很多对象在模式中有10多个属性时会成为负担。

Answer 1

杰西的评论是正确的。有关更正式的答案，请参阅GraphQL documentation on input types的摘录：

上面定义的对象类型不适合在这里重复使用，因为对象可以包含表示循环引用的字段或对接口和联合的引用，两者都不合适用作输入参数。出于这个原因，输入对象有一个系统中的单独类型。

更新

自发布之后，我发现循环引用实际上是可以接受的，只要它们是可以接受的（或者它会声明一个无限链）。但是，仍有其他限制（例如接口）似乎需要一个单独的输入类型系统。

Answer 2

根据规格：

GraphQL对象类型（ObjectTypeDefinition）...不适合[用作输入]，因为对象类型可以包含定义参数的字段或包含对接口和联合的引用，都不适合用作输入参数。因此，输入对象在系统中具有单独的类型。

这是“官方原因”，但是有几个实际原因导致您不能将对象类型用作输入对象类型或将对象类型用作输入对象类型：

功能

对象类型和输入对象类型都有字段，但是这些字段具有不同的属性，这些属性反映了模式如何使用这些类型。您的架构可能会为对象类型的字段定义参数和某种解析器功能，但是这些属性在输入上下文中没有意义（即，您不能 resolve 输入对象的字段-它已经具有显式值）。同样，只能为输入对象类型字段提供默认值，而不能为对象类型字段提供默认值。

换句话说，这似乎是重复的：

type Student {
  name: String
  grade: Grade
}

input StudentInput {
  name: String
  grade: Grade
}

但是添加特定于对象类型或输入对象类型的功能可以使它们清楚地表现出不同的行为：

type Student {
  name(preferred: Boolean): String
  grade: Grade
}

input StudentInput {
  name: String
  grade: Grade = F
}

类型系统限制

GraphQL中的

类型分为输出类型和输入类型。

输出类型是可以作为GraphQL服务生成的响应的一部分返回的类型。输入类型是作为字段或指令参数的有效输入的类型。

这两个组（即标量，枚举，列表和非空值）之间存在重叠。但是，诸如联合和接口的抽象类型在输入上下文中没有意义，因此不能用作输入。将对象类型和输入对象类型分开，可以确保在期望输入类型的地方永远不要使用抽象类型。

架构设计

在架构中表示实体时，某些实体可能确实会在其各自的输入和输出类型之间“共享字段”：

type Student {
  firstName: String
  lastName: String
  grade: Grade
}

input StudentInput {
  firstName: String
  lastName: String
  grade: Grade
}

但是，对象类型可以（并且实际上经常可以）对非常复杂的数据结构进行建模：

type Student {
  fullName: String!
  classes: [Class!]!
  address: Address!
  emergencyContact: Contact
  # etc
}

虽然这些结构可以转换为适当的输入（我们创建了一个Student，所以我们也传递了一个表示其地址的对象），但通常它们却不是-即也许我们需要指定学生的按类ID和部分ID（而不是对象）分类。同样，我们可能有想要返回但不想突变的字段，反之亦然（例如password字段）。

此外，即使对于相对简单的实体，我们也经常对对象类型与其“对应”输入对象之间的可空性提出不同的要求。通常，我们想保证在响应中也将返回一个字段，但是我们不想在输入中填写相同的字段。例如，

type Student {
  firstName: String!
  lastName: String!
}

input StudentInput {
  firstName: String
  lastName: String
}

最后，在许多模式中，给定实体的对象类型和输入对象类型之间通常没有一对一的映射。一种常见的模式是将单独的输入对象类型用于不同的操作，以进一步微调架构级别的输入验证：

input CreateUserInput {
  firstName: String!
  lastName: String!
  email: String!
  password: String!
}

input UpdateUserInput {
  email: String
  password: String
}

所有这些示例都说明了一个重点-尽管输入对象类型有时可能会反映对象类型，但由于业务需求，您在生产模式中看到该对象的可能性却很小。

GraphQL中输入类型的重点是什么？

2 个答案:

更新

功能

类型系统限制

架构设计