了解 GraphQL Mutation 以及数据如何传递到输出字段

ELI5 的答案没有涉及细节：

每个对象类型的每个字段都有一个“解析器”。解析器是一个具有四个参数的函数：

1. parent：这是“对象的当前状态”，由在它之前运行的解析器提供（这很快就会有意义）
2. args：如果架构中定义了参数，则请求发送的值将在此处传递
3. context：当请求开始时，您定义此对象，它会告诉函数有关请求的元信息（您应该在此处查看当前用户）。每个解析器都使用相同的值。
4. info：这是有关操作状态的信息。它将包括解析器所针对的字段的名称、从该字段一直到根的路径等。

让我们使用一个精简的模式来展示它是如何工作的（请注意，这个模式作为示例很好，但不遵循最佳实践）：

type Mutation {
  createUser(userData: UserInput!): User
}

type Date {
  day: Int!
  month: Int!
  year: Int!
}

type User {
  id: ID!
  name: String!
  birthDate: Date!
  createdDate: Date
}

input UserInput {
  name: String!
  birthDate: String! # Let's assume yyyy/mm/dd
}

现在我们要提出这个请求：

mutation {
  createUser(userData: { name: "David", birthDate: "2020/12/20" }) {
    id
    birthDate {
      day
      month
      year
    }
    name
    createdDate {
      day
      month
      year
    }
  }
}

首先，GraphQL 引擎会查看您的入口点，即Mutation.createUser。它会检查是否存在包含“Mutation”的解析器对象，并检查该对象上是否有“createUser”函​​数。我将使用所有同步代码，这样 await/async/promises 就不会造成混淆。

const resolvers = {
  ... <other code>
  Mutation: {
    createUser(parent, args) {
      const { userData: { name, birthDate } } = args;

      const { id } = someDb.createUser({ name, birthDate });
      
      return {
        id,
        name,
      };
    }
  },
  ... <other code>
}

有一个 Mutation 解析器对象，它有一个名为 的属性createUser，它是一个函数。它调用此函数并获取响应。它还知道该函数的响应类型必须是“User”，因此它添加了一个名为 的属性__typename。这是当前数据：

{
  "createUser": {
    "__typename": "User",
    "id": "some-uuid-went-here",
    "name": "David"
  }
}

太棒了。现在它会检查您在“createUser”返回的对象上请求的字段。您请求

• ID
• 姓名
• 出生日期
• 创建日期

__typename 是 User，因此现在引擎会检查您是否有针对以下每个类型的解析器：

const resolvers = {
  ... <other code>
  User: {
    id(parent) {
      // let's base64 encode these for external use
      return Buffer.from(parent.id).toString('base64');
    },
    birthDate(parent) {
      // `id` here is the id returned from the parent's resolver, not the base64 value
      const { birthDate } = someDb.findUserById(parent.id);
      const dateParts = birthDate.split('/');
      return {
        day: Number(dateParts[2]),
        month: Number(dateParts[1]),
        year: Number(dateParts[0]),
      };
    },
  },
  ... <other code>
}

有一个User解析器对象。

• id: 有一个函数User.id；调用它
• birthDate：有一个函数User.birthDate；调用它
• name：没有函数User.name，因此使用默认解析器。由于您没有为 传递函数User.name，因此它只会返回parent.name。以下是“默认解析器”的一般概念：

const defaultResolver = (parent, args, context, info) => {
  const { fieldName } = info;
  return parent[fieldName];
}

你要求

• createdDate：没有函数User.createdDate，因此它将使用默认解析器。由于parent没有createdDate（您没有从 createUser 返回），因此它返回undefined。GraphQL 引擎现在必须检查是否null允许（将 undefined 视为）createdDate。您的架构没有感叹号，因此现在您的返回数据如下所示：

{
  "createUser": {
    "__typename": "User",
    "id": "c29tZS11dWlkLXdlbnQtaGVyZQ==",
    "name": "David",
    "birthDate": {
      "day": 20,
      "month": 12,
      "year": 2020
    },
    "createdDate": undefined
  }
}

看上去已经完成了，但其实并没有。现在进入下一个级别。您要求输入哪些字段birthDate？

• 天
• 月
• 年

并且 __typename 是Date...。

解析器是否具有Date这些属性的功能？假设没有。因此将使用默认解析器。

现在经过所有解析器之后你的最终 json 是：

{
  "createUser": {
    "__typename": "User",
    "id": "c29tZS11dWlkLXdlbnQtaGVyZQ==",
    "name": "David",
    "birthDate": {
      "day": 20,
      "month": 12,
      "year": 2020
    },
    "createdDate": undefined
  }
}

** 附注：每种类型和每个属性的工作原理大致相同：

• “查询”和“变异”（以及高级的“订阅”）很特殊，因为它们是顶级的，所以它们是图的入口点。
• “Mutation” 还有一个特殊之处，即属性必须从请求的顶部到底部按顺序运行。这仅适用于“Mutation”类型的属性，而不适用于嵌套属性。在我们的示例中，如果您createUser在同一个操作中有两个调用，则它们必须一个接一个地发生，但name、id和birthDate都可以并行运行。