GraphQL 的 Mutation 操作详解-FunTeaLearn Online Web Tutorials

GraphQL 是一种用于构建 API 的查询语言，它具有强大的类型系统和灵活的查询语法。在 GraphQL 中，Mutation 是一种用于修改数据的操作，它与查询操作类似，但是它允许我们执行更改操作。

在本文中，我们将深入了解 GraphQL 的 Mutation 操作，并学习如何使用它来修改数据。我们还将介绍 Mutation 的一些最佳实践和常见问题。

什么是 Mutation？

Mutation 是一种用于修改数据的操作。它与查询操作类似，但是它允许我们执行更改操作。Mutation 可以用来添加、更新或删除数据。

在 GraphQL 中，Mutation 类型定义了所有可用的 Mutation 操作。每个 Mutation 操作都必须定义一个输入类型和一个返回类型。输入类型包含操作所需的参数，返回类型包含操作的结果。

下面是一个简单的 Mutation 操作示例：

mutation {
  createUser(name: "John Doe", email: "john.doe@example.com") {
    id
    name
    email
  }
}

该操作将创建一个新的用户，并返回该用户的 ID、姓名和电子邮件地址。

Mutation 的语法

Mutation 的语法与查询操作类似，但是它们使用不同的关键字。Mutation 关键字用于指定操作类型，后跟操作名称和操作参数。

下面是一个示例 Mutation 操作：

mutation AddUser($name: String!, $email: String!) {
  createUser(name: $name, email: $email) {
    id
    name
    email
  }
}

在上面的示例中，我们定义了一个名为 "AddUser" 的 Mutation 操作，该操作接受两个参数：name 和 email。我们使用 $name 和 $email 语法来定义这些参数，并在操作中使用它们。

Mutation 的最佳实践

以下是一些使用 Mutation 操作的最佳实践：

1. 使用单一入口

与传统的 REST API 不同，GraphQL API 通常只有一个入口点。这意味着我们可以使用单一的 Mutation 操作来处理所有数据修改请求。这样做可以让我们更好地控制数据的访问和修改。

2. 使用输入类型

每个 Mutation 操作都必须定义一个输入类型，该类型包含操作所需的参数。使用输入类型可以使代码更具可读性和可维护性，因为它可以减少重复的参数声明。

3. 使用错误处理

Mutation 操作可能会失败，因此我们应该使用错误处理来处理这些情况。在 GraphQL 中，我们可以使用 errors 字段来获取有关错误的信息。

4. 使用事务

Mutation 操作可能会修改多个数据行，因此我们应该使用事务来确保数据的一致性。在 GraphQL 中，我们可以使用事务来确保 Mutation 操作的原子性。

示例代码

下面是一个使用 Node.js 和 GraphQL 的示例代码，用于演示如何使用 Mutation 操作来添加新用户：

-- -------------------- ---- -------
----- - ------------- --- - - -------------------------
----- - --- ------ - - ----------------

----- ----- - -
  - --- --------- ----- ----- ----- ------ ---------------------- --
  - --- --------- ----- ----- ----- ------ ---------------------- --
--

----- -------- - ----
  ---- ---- -
    --- ---
    ----- -------
    ------ -------
  -

  ----- ------------ -
    ----- -------
    ------ -------
  -

  ---- -------- -
    ----------------- --------------- -----
  -

  ---- ----- -
    ------ --------
  -
--

----- --------- - -
  ------ -
    ------ -- -- ------
  --

  --------- -
    ----------- -------- - ----- -- -- -
      ----- ---- - - --- --------- -------- --
      -----------------
      ------ -----
    --
  --
--

----- ------ - --- -------------- --------- --------- ---

----------------------- --- -- -- -
  ------------------- ----- -- ---------
---

在上面的代码中，我们定义了一个 User 类型、一个 NewUserInput 输入类型和一个 createUser Mutation 操作。在 resolvers 中，我们实现了 createUser 操作，该操作接受一个 NewUserInput 输入类型并返回一个 User 类型。

我们还实现了一个 users 查询操作，用于获取所有用户。

Source: FunTeaLearn,Please indicate the source for reprints https://funteas.com/post/67d47150a941bf713486a2fe

GraphQL 的 Mutation 操作详解