İç İçe Mutation Kullanımı

İç içe mutation'lar, GraphQL'de kök türden farklı bir tür üzerinde mutation gerçekleştirmeyi mümkün kılar.

Aşağıdaki query, kök türdeki updatePost mutation alanını kullanarak standart bir mutation çalıştırır:

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

Yukarıdaki query, iç içe bir mutation aracılığıyla da çalıştırılabilir; burada post nesnesi önce post alanı üzerinden sorgulanır, ardından Post türüne ait update mutation alanı post nesnesi üzerine uygulanır:

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

Mutation'lar ayrıca iç içe yerleştirilebilir; başka bir mutation'ın sonucu üzerindeki veriler değiştirilebilir:

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
            }
          }
        }
      }
    }
  }
}

Basitleştirilmiş kök tür

İç içe mutation'lar, kök türü QueryRoot ve MutationRoot'tan, hem queries hem de mutation'ları yöneten tek bir Root türüne dönüştürür:

Şema belgelerinde iç içe mutation'lar

Mutation alanlarını görselleştirme

Mutation alanlarının hangileri olduğunu görselleştirmek için Voyager istemcisini kullanın.

İç içe mutation'lar sayesinde, şemadaki her tür hem query hem de mutation alanları içerebilir. Bunları birbirinden ayırt etmek için mutation alanının açıklamasının başına "[Mutation] " etiketi eklenir.

Örneğin, Root türü için alanlar şunlardır:

GraphiQL belgelerinde Root türü için açıklama