🎉 Gato GraphQL v0.7 출시 — mutation 및 nested mutation 지원 추가!

Gato GraphQL 버전 0.7이 출시되었습니다. mutation과 nested mutation을 지원합니다! 🎉

새롭게 추가된 기능들을 살펴보겠습니다.

​

1. Mutations! 🚀

GraphQL mutations는 쿼리를 통해 데이터를 수정(즉, 부작용을 실행)할 수 있게 해줍니다.

Mutation은 Gato GraphQL에 아직 없었던 중요한 기능이었습니다. 이제 추가되었으므로, 이 GraphQL 서버는 거의 기능이 완전하다고 할 수 있습니다(subscriptions만 남아 있으며, 추가 방법에 대해 이미 검토 중입니다).

댓글 추가 예시를 살펴보겠습니다. 다만, 먼저 로그인을 위한 다른 mutation을 실행해야 합니다. 댓글을 추가할 수 있도록 하기 위해서입니다. 아래 GraphiQL 클라이언트에서 「Run」 버튼을 눌러, 미리 생성된 테스트 사용자로 mutation 필드 loginUser를 실행해 주세요:

mutation LogUserIn {
  loginUser(
    by: { credentials: { usernameOrEmail: "test", password: "pass" } }
  ) {
    id
    name
  }
}Copy

이제 댓글을 추가해 보겠습니다. 아래 Run 버튼을 눌러, mutation 필드 addCommentToCustomPost를 실행하여 게시물에 댓글을 추가해 주세요(댓글 텍스트도 편집할 수 있습니다):

mutation AddComment {
  addCommentToCustomPost(
    input: { customPostID: 1459, comment: "Adding a comment: bla bla bla" }
  ) {
    id
    content
    date
  }
}Copy

이번 첫 번째 릴리스에서 플러그인에는 다음 mutation이 포함되어 있습니다:

✅ createPost
✅ updatePost
✅ setFeaturedImageforCustomPost
✅ removeFeaturedImageforCustomPost
✅ addCommentToCustomPost
✅ replyComment
✅ loginUser
✅ logoutUser

​

2. Nested Mutations! 🚀🚀

Nested mutations란 GraphQL의 root 타입 이외의 타입에 대해 mutation을 실행할 수 있는 기능입니다.

이 기능은 GraphQL 스펙에 추가가 요청된 바 있으나, 아직 승인되지 않았습니다(앞으로도 승인되지 않을 수도 있습니다). 그래서 Gato GraphQL은 Nested Mutations 모듈을 통해 옵트인 기능으로 지원을 추가하고 있습니다.

플러그인은 다음 두 가지 동작을 지원합니다:

1. 표준 GraphQL 동작(즉, root 타입에 mutation 필드를 추가하는 것), 기본값
2. Nested mutations, 옵트인으로

예를 들어, 위의 쿼리는 다음 쿼리로도 실행할 수 있습니다. 이 쿼리에서는 먼저 Root.post로 게시물을 가져온 다음, Post.addComment로 댓글을 추가합니다:

mutation AddComment {
  post(by: { id: 1459 }) {
    addComment(
      input: {
        comment: "Notice how field `addCommentToCustomPost` under the `Root` type is renamed as `addComment` under the `Post` type? The schema got neater!"
      }
    ) {
      id
      content
      date
    }
  }
}Copy

Mutation은 다른 mutation의 결과에 대해서도 데이터를 수정할 수 있습니다. 아래 쿼리에서는 먼저 Root.post로 게시물을 가져온 후, mutation Post.addComment를 실행하여 생성된 댓글 객체를 얻고, 마지막으로 그 댓글에 대해 mutation Comment.reply를 실행합니다:

mutation AddCommentAndResponse {
  post(by: { id: 1459 }) {
    id
    title
    addComment(input: { comment: "Isn't this awesome?" }) {
      id
      date
      content
      reply(input: { comment: "I think so!" }) {
        id
        date
        content
      }
    }
  }
}Copy

정말 유용합니다! 😍 (동일한 동작을 단일 쿼리에서 실현하는 대안적인 방법은 @export 디렉티브를 사용하는 것입니다… 향후 블로그 게시물에서 두 가지를 비교할 예정입니다).

이번 첫 번째 릴리스에서 플러그인에는 다음 mutation이 포함되어 있습니다:

✅ CustomPost.update
✅ CustomPost.setFeaturedImage
✅ CustomPost.removeFeaturedImage
✅ CustomPost.addComment
✅ Comment.reply

​

표준 또는 nested? 아니면 둘 다?

자사 애플리케이션에서 사용하는 GraphQL API가 있고, 이것이 클라이언트에게도 공개되어 있다고 가정해 보겠습니다. Nested mutations를 활성화하고 싶지만, 비표준 기능이므로 클라이언트에게는 적용하고 싶지 않은 경우도 있을 것입니다.

좋은 소식이 있습니다: 그것이 가능합니다.

Schema Configuration에 「Mutation Scheme」 섹션을 추가했습니다. 이 섹션은 Custom Endpoints와 Persisted Queries의 스키마를 커스터마이징하는 데 사용됩니다:

이를 통해 nested mutations를 모든 곳에서 비활성화하면서, 자사 애플리케이션만 사용하는 특정 custom endpoint에서만 활성화할 수 있습니다. 💪

​

root 타입에서 중복 필드 제거하기

Nested mutations를 사용하면 mutation 필드가 스키마에 두 번 추가될 수 있습니다:

• root 타입 아래에 한 번
• 특정 타입 아래에 한 번

예를 들어, 다음 필드들은 서로의 「중복」으로 볼 수 있습니다:

• Root.updatePost
• Post.update

Gato GraphQL에서는 둘 다 유지하거나, root 타입의 중복 필드를 제거하는 것을 선택할 수 있습니다.

다음 3가지 스키마가 있습니다:

1. 표준 동작:
   쿼리 처리에 QueryRoot 타입을, mutation 처리에 MutationRoot 타입을 사용합니다
2. 중복 mutation 필드를 유지하는 nested mutations:
   단일 Root 타입이 쿼리와 mutation을 처리하며, 이 타입의 중복 mutation 필드는 유지됩니다
3. root 타입에서 중복 mutation 필드를 제거하는 nested mutations:
   위와 동일하지만, Root 타입에서 모든 중복 mutation 필드를 제거합니다

✱ 참고로 1, 이 3가지 스키마는 모두 동일한 엔드포인트를 사용하지만, URL 파라미터 ?mutation_scheme을 standard, nested, lean_nested로 변경하여 전환할 수 있습니다. 이것은 GraphQL 서버가 code-first 접근 방식을 따르기 때문에 가능합니다. 🤟

✱ 참고로 2, 이 옵션들은 Schema configuration(위에 표시됨)의 「Mutation Scheme」 섹션에서 선택할 수 있습니다. 따라서 개별 custom endpoints와 persisted queries에 적용할 동작도 결정할 수 있습니다. 👏

이제 v0.8을 준비할 시간입니다! 🙏