Używanie zagnieżdżonych mutations

Zagnieżdżone mutations umożliwiają wykonywanie mutations na typie innym niż typ główny w GraphQL.

Poniższe query wykonuje standardową mutation, używając pola mutation updatePost z typu głównego:

mutation {
  updatePost(input: {
    id: 5,
    title: "New title"
  }) {
    status
    errors {
      __typename
      ...on ErrorPayload {
        message
      }
    }
    post {
      title
    }
  }
}

Powyższe query można również wykonać za pomocą zagnieżdżonej mutation, gdzie obiekt post jest najpierw pobierany przez pole post, a następnie pole mutation update, należące do typu Post, jest stosowane na obiekcie post:

mutation {
  post(by: {id: 5}) {
    update(input: {
      title: "New title"
    }) {
      status
      post {
        title
      }
    }
  }
}

Mutations mogą być również zagnieżdżane, modyfikując dane na wyniku innej mutation:

mutation {
  createPost(input: {
    title: "First title"
  }) {
    status
    postID
    post {
      update(input: {
        title: "Second title",
        contentAs: { html: "Some content" }
      }) {
        status
        post {
          title
          content
          addComment(input: {
            commentAs: { html: "My first comment" }
          }) {
            status
            commentID
            comment {
              content
              date
            }
          }
        }
      }
    }
  }
}

Uproszczony typ główny

Zagnieżdżone mutations zmieniają typ główny, z QueryRoot i MutationRoot na jeden typ Root obsługujący zarówno queries, jak i mutations:

Zagnieżdżone mutations w dokumentacji schematu

Wizualizacja pól mutation

Użyj klienta Voyager, aby zwizualizować pola mutation.

W przypadku zagnieżdżonych mutations każdy typ w schemacie może zawierać zarówno pola query, jak i pola mutation. Aby je odróżnić, opis pola mutation jest poprzedzany etykietą "[Mutation] ".

Na przykład, oto pola dla typu Root:

Opis typu Root w dokumentacji GraphiQL