在GraphQL中输入类型的意义是什么？

Question

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
}

Answer 1

根据规范：

GraphQL对象类型（ObjectTypeDefinition）...不适合[作为输入]重用，因为对象类型可以包含定义参数的字段，也可以包含对接口和联合的引用，而这两个字段都不适合用作输入参数。由于这个原因，输入对象在系统中有一个单独的类型。

这是“官方原因”，但有几个实际原因说明为什么不能将对象类型用作输入对象类型或将对象类型用作输入对象类型：

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
}

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
}

虽然这些结构可以转换成适当的输入（我们创建了一个学生，因此我们也传递了一个表示他们地址的对象），但它们通常不是这样的--也就是说，也许我们需要通过类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
}