GraphQL의 변수(variable) 사용법은 무엇인가요?

Q1: GraphQL에서 변수(variable)를 사용하는 이유는 무엇인가요?
A1: 변수는 쿼리 또는 뮤테이션에 동적인 값을 전달할 때 사용됩니다. 하드코딩된 값 대신 변수를 사용하면 재사용성과 가독성이 높아지고, 클라이언트-서버 간의 데이터 전달이 효율적이며 보안에도 도움이 됩니다.

---

Q2: GraphQL 쿼리에서 변수를 선언하는 문법은 어떻게 되나요?
A2: 쿼리 이름 바로 뒤 괄호 안에 변수명과 타입을 선언합니다. 예를 들어:
```graphql
query GetUser($id: ID!) {
user(id: $id) {
name
email
}
}
```
여기서 `$id`가 변수명이고, `ID!`는 타입(여기서는 non-null ID 타입)입니다.

---

Q3: 변수를 실제 쿼리에 어떻게 전달하나요?
A3: 쿼리 텍스트와 별도로 JSON 형태로 변수 값을 전달합니다. 예:
```json
{
"id": "12345"
}
```
이 변수 값은 `$id`에 바인딩되어 쿼리 실행에 사용됩니다.

---

Q4: 변수를 사용할 때 타입 지정은 어떻게 하나요?
A4: 변수 선언 시 GraphQL 스칼라 타입 또는 커스텀 타입을 명시해야 합니다. 예: `$name: String!`, `$age: Int`, `$active: Boolean!` 등. 느낌표(!)는 필수값(non-null)을 의미합니다.

---

Q5: 변수로 입력 객체(Input Object)를 전달할 수 있나요?
A5: 네, 가능합니다. 예를 들어:
```graphql
mutation CreateUser($input: CreateUserInput!) {
createUser(input: $input) {
id
name }
}
```
여기서 `CreateUserInput`은 사전에 정의된 입력 객체 타입입니다. 변수 `input`에 JSON 객체를 전달해 필드를 일괄 지정할 수 있습니다.

---

Q6: 변수를 쿼리 내 여러 곳에서 재사용할 수 있나요?
A6: 네, 쿼리 내 여러 인수(argument) 위치에서 동일 변수를 사용할 수 있습니다. 단, 변수 타입이 각 위치의 인수 타입과 호환되어야 합니다.

---

Q7: 변수명을 지을 때 규칙이나 권장사항이 있나요?
A7: 변수명은 `$`로 시작하고, 알파벳과 숫자, 밑줄(_)을 포함할 수 있습니다. 일반적으로 의미 있는 이름을 사용해 가독성을 높입니다. 예: `$userId`, `$postLimit` 등.

---

Q8: 변수를 사용하지 않고 쿼리에 값 직접 넣는 방법과 비교할 때 장단점은?
A8:
- 변수 사용 장점: 쿼리 캐싱 최적화, 보안 강화(직접 값 노출 최소화), 코드 재사용성 향상
- 값 직접 삽입 장점: 간단한 단건 테스트 등에 편리
장기적으로는 변수 사용하는 방식이 표준이고 권장됩니다.

---

Q9: GraphQL 클라이언트 라이브러리에서는 변수를 어떻게 전달하나요?
A9: 예를 들어 Apollo Client에서는 다음과 같이 사용합니다:
```javascript
client.query({
query: GET_USER,
variables: { id: "12345" }
})
```
클라이언트에서 별도로 변수 객체를 넘기는 방식을 채택합니다.

---

Q10: 변수가 쿼리에 선언되어 있는데 변수를 빼먹으면 어떻게 되나요?
A10: 변수값을 필수로 받는(non-null) 경우 서버가 오류를 반환합니다. 옵셔널이면 null 값이 될 수도 있으나, 쿼리 실행 결과에 영향을 줄 수 있습니다.

---

요약하자면, GraphQL 변수는 쿼리/뮤테이션을 동적으로 만들고 클라이언트와 서버 간 데이터 전달을 효율화하기 위한 핵심 기능이며, 쿼리 선언부에 타입과 함께 변수명을 명시하고, 쿼리 실행 시 별도의 JSON 객체로 변수 값을 전달하는 방식으로 사용합니다.

GraphQL에서 변수(variable)는 쿼리나 뮤테이션을 작성할 때 동적인 값을 전달하기 위해 사용됩니다.

변수를 사용하면 쿼리를 재사용할 수 있고, 클라이언트에서 서버로 전송되는 요청의 가독성을 높일 수 있습니다.

아래에서는 GraphQL에서 변수를 사용하는 방법에 대해 자세히 설명하겠습니다.

1. 변수 선언 GraphQL 쿼리에서 변수를 사용하려면 먼저 변수를 선언해야 합니다.

변수를 선언하는 방법은 쿼리의 시작 부분에 `$` 기호를 사용하여 변수의 이름과 타입을 정의하는 것입니다.

예를 들어, 사용자 ID를 받아오는 쿼리를 작성할 때는 다음과 같이 변수를 선언할 수 있습니다.

```graphql query GetUser($userId: ID!) { user(id: $userId) { id name email } } ``` 위의 예제에서 `$userId`는 `ID` 타입의 변수를 나타내며, `!`는 이 변수가 필수임을 의미합니다.



2. 변수 사용 변수를 선언한 후, 쿼리 내에서 해당 변수를 사용할 수 있습니다.

위의 예제에서 `user` 필드의 `id` 인자로 `$userId` 변수를 사용하고 있습니다.

이렇게 하면 쿼리를 실행할 때 실제 값을 변수에 전달할 수 있습니다.



3. 변수 값 전달 변수를 사용하여 쿼리를 실행할 때는, 쿼리와 함께 변수의 값을 JSON 형식으로 전달해야 합니다.

예를 들어, 위에서 정의한 `GetUser` 쿼리를 실행할 때는 다음과 같이 변수 값을 전달할 수 있습니다.

```json { "query": "query GetUser($userId: ID!) { user(id: $userId) { id name email } }", "variables": { "userId": "12345" } } ``` 여기서 `variables` 객체에 `userId`의 값을 `"12345"`로 설정하여 쿼리를 실행합니다.



4. 여러 변수 사용 여러 개의 변수를 사용할 수도 있습니다.

이 경우, 변수를 선언할 때 쉼표로 구분하여 여러 변수를 정의할 수 있습니다.

예를 들어, 사용자 정보를 업데이트하는 뮤테이션을 작성할 때는 다음과 같이 여러 변수를 선언할 수 있습니다.

```graphql mutation UpdateUser($userId: ID!, $name: String, $email: String) { updateUser(id: $userId, name: $name, email: $email) { id name email } } ``` 이 뮤테이션을 실행할 때는 다음과 같이 변수 값을 전달할 수 있습니다.

```json { "query": "mutation UpdateUser($userId: ID!, $name: String, $email: String) { updateUser(id: $userId, name: $name, email: $email) { id name email } }", "variables": { "userId": "12345", "name": "John Doe", "email": "[email protected]" } } ```

5. 변수의 타입 GraphQL에서는 다양한 타입의 변수를 지원합니다.

기본적으로 지원되는 타입은 다음과 같습니다: - `Int`: 정수 - `Float`: 부동 소수점 숫자 - `String`: 문자열 - `Boolean`: 불리언 값 - `ID`: 고유 식별자 또한, 사용자 정의 타입이나 리스트 타입도 사용할 수 있습니다.

예를 들어, 리스트 타입의 변수를 선언할 때는 대괄호 `[]`를 사용합니다.

```graphql query GetUsers($userIds: [ID!]!) { users(ids: $userIds) { id name } } ```

6. 기본값 설정 변수를 선언할 때 기본값을 설정할 수도 있습니다.

기본값을 설정하면 클라이언트에서 변수를 전달하지 않았을 때 기본값이 사용됩니다.

```graphql query GetUser($userId: ID! = "defaultId") { user(id: $userId) { id name } } ``` 위의 예제에서 `userId` 변수가 전달되지 않으면 `"defaultId"`가 사용됩니다.

결론 GraphQL에서 변수를 사용하는 것은 쿼리와 뮤테이션의 유연성을 높이고, 클라이언트와 서버 간의 데이터 전송을 효율적으로 관리하는 데 매우 유용합니다.

변수를 통해 쿼리를 동적으로 만들고, 재사용성을 높이며, 가독성을 향상시킬 수 있습니다.

변수를 적절히 활용하면 GraphQL API를 보다 효과적으로 사용할 수 있습니다.