GraphQL 디렉티브는 GraphQL 스키마, 쿼리, 뮤테이션 및 서브스크립션에 메타데이터를 제공하는 기능입니다.

GraphQL 스키마의 필드에 일부 메타데이터를 추가하거나, 쿼리의 실행을 제어하거나, 스키마에 대한 동적으로 생성된 내용을 처리하는 데 사용됩니다.

@directive 지시자

디렉티브는 일반적으로 @ 기호로 시작되며, 필드, 타입 또는 인자에 적용됩니다.

예를 들어, 다음과 같이 @include와 @skip 디렉티브를 사용할 수 있습니다.

query {
  user(name: "John") {
    email
    bio @include(if: $showBio) # $showBio 변수에 따라 bio 필드를 포함 또는 제외
  }
}

사용법

디렉티브의 사용법은 다음과 같습니다.

1. 존재 여부에 따라 필드 포함 또는 제외 디렉티브는 @include(if: Boolean)와 @skip(if: Boolean)로 필드의 존재 여부를 결정합니다.

2. 입력값에 따른 필드 수정 @deprecated, @external, @key, @connection, @client 등 디렉티브를 사용하여 필드에 입력값을 수정하거나, 연결 및 클라이언트 관련 작업을 수행할 수 있습니다.

3. 캐싱 및 성능 향상을 위한 디렉티브 사용 특정 필드에 캐싱을 적용하거나 사용자 지정 로직을 삽입하여 성능을 향상시킬 수 있습니다.

결론

GraphQL 디렉티브는 쿼리와 뮤테이션의 실행을 제어하거나, 스키마에 메타데이터를 추가하거나, 캐싱 및 성능 향상을 위한 사용자 지정 로직을 삽입하는 등 다양한 용도로 사용할 수 있습니다.

디렉티브를 사용함으로써 GraphQL을 더 유연하고 강력하게 활용할 수 있습니다.

참고 자료:

• GraphQL 공식 문서