GraphQL은 강력한 쿼리 언어로, 클라이언트가 정확히 원하는 데이터를 서버에서 가져올 수 있도록 합니다. GraphQL 쿼리 언어는 변수를 사용하여 동적으로 값을 전달할 수 있습니다. 이 문서에서는 GraphQL 쿼리 언어에서 사용되는 변수의 유형에 대해 알아보겠습니다.

1. 변수 정의하기

GraphQL 쿼리 내에서 변수를 사용하려면 먼저 변수를 정의해야 합니다. 변수는 일반적으로 쿼리나 뮤테이션의 매개변수로 사용되며 다음과 같은 형식으로 정의됩니다.

query ($variableName: Type) {
  // 쿼리 또는 뮤테이션 내에서 변수 사용
}

여기서 $variableName은 변수의 이름을 나타내고, Type은 변수가 가져야 하는 데이터 유형을 나타냅니다.

2. 변수 유형

GraphQL에서 변수는 스칼라, 객체, 열거형 등 여러 가지 유형을 가질 수 있습니다.

2.1. 스칼라 변수

가장 간단한 유형의 변수로, 문자열, 숫자, 불리언, 날짜 및 기타 원시 데이터 유형을 포함합니다.

query ($name: String, $age: Int, $isActive: Boolean) {
  // 쿼리 내에서 스칼라 변수 사용
}

2.2. 객체 변수

GraphQL에서는 객체를 변수로 전달할 수 있습니다. 변수 유형은 입력 객체 유형을 정의하여 객체 유형을 나타냅니다.

query ($user: UserInput) {
  // 쿼리 내에서 객체 변수 사용
}

2.3. 열거형 변수

열거형은 변수가 특정한 설정된 상수 값 중 하나여야 함을 나타내는데 사용됩니다.

query ($status: StatusEnum) {
  // 쿼리 내에서 열거형 변수 사용
}

또한, 변수 유형은 리스트, Non-null 등 다양한 형태로 조합될 수 있습니다.

GraphQL 쿼리 언어에서 변수를 사용하고 유형을 정의하는 것은 클라이언트 및 서버 간 데이터 교환에 있어 강력하고 유연한 방법을 제공합니다.

이러한 유형의 변수를 사용하여 GraphQL을 보다 동적이고 유연하게 활용할 수 있습니다.

참고 자료: GraphQL 공식 문서