GraphQL에서 커스텀 타입을 만드는 방법은 무엇인가요?

Q1: GraphQL에서 커스텀 타입이란 무엇인가요?
A1: GraphQL에서 커스텀 타입은 기본 스칼라 타입(String, Int, Boolean 등) 외에 개발자가 직접 정의하는 복합 타입으로, 객체(Object), 열거형(Enum), 인터페이스(Interface), 유니언(Union) 타입 등이 포함됩니다. 이를 통해 API 스키마의 구조를 명확하게 표현할 수 있습니다.

Q2: GraphQL 스키마에서 커스텀 오브젝트 타입을 어떻게 정의하나요?
A2: `type` 키워드를 사용하여 커스텀 오브젝트 타입을 정의합니다. 예를 들어:
```graphql
type User {
id: ID!
name: String!
age: Int
}
```
여기서 `User`는 새롭게 정의된 커스텀 타입이며, `id`, `name`, `age` 필드를 가집니다.

Q3: 필드 타입은 어떤 종류를 사용할 수 있나요?
A3: 필드 타입은 기본 스칼라 타입(String, Int, Float, Boolean, ID)뿐 아니라 앞서 정의한 커스텀 타입도 사용할 수 있습니다. 또한 배열(`[Type]`)과 Non-Null(`Type!`) 타입 수식어도 활용 가능합니다.

Q4: Enum 타입(열거형)은 어떻게 정의하나요?
A4: `enum` 키워드를 사용하여 정의하며, 한정된 값들만 갖는 타입을 표현합니다. 예:
```graphql
enum Role {
ADMIN
USER
GUEST
}
```

Q5: 인터페이스는 어떻게 만들고 왜 사용하나요?
A5: `interface` 키워드를 사용하며, 여러 타입에서 공통으로 구현해야 하는 필드를 정의할 때 씁니다. 예:
```graphql
interface Animal {
id: ID!
name: String!
}
type Dog implements Animal {
id: ID!
name: String! breed: String
}
```

Q6: 유니언 타입은 어떻게 정의하나요?
A6: `union` 키워드로 여러 타입 중 한 가지를 가질 수 있는 타입을 정의합니다. 예:
```graphql
union SearchResult = User | Post | Comment
```

Q7: GraphQL SDL 이외에 자바스크립트나 다른 언어에서 커스텀 타입 정의는 어떻게 하나요?
A7: 예를 들어 Apollo Server에서는 `gql` 태그로 SDL을 작성하거나, `GraphQLObjectType` 클래스를 사용해 타입을 정의합니다. 예:
```js
const UserType = new GraphQLObjectType({
name: 'User',
fields: {
id: { type: GraphQLID },
name: { type: GraphQLString }
}
});
```

Q8: 커스텀 타입 정의 시 주의할 점은 무엇인가요?
A8: 타입 이름은 대문자로 시작하고, 스키마 내에서 고유해야 합니다. 또한 필드 타입과 null 가능성을 명확히 명시해 클라이언트가 타입을 정확히 이해하도록 해야 합니다.

Q9: 커스텀 입력 타입(Input type)은 어떻게 만들고 언제 사용하나요?
A9: `input` 키워드로 입력 전용 타입을 정의하며, 주로 뮤테이션(mutation) 인자로 복잡한 데이터를 받을 때 사용합니다. 예:
```graphql
input UserInput {
name: String!
age: Int
}
```

---

요약: GraphQL에서 커스텀 타입은 `type`, `enum`, `interface`, `union`, `input` 키워드로 정의하며, 이를 통해 API 스키마에 필요한 복잡한 구조를 명확히 표현할 수 있습니다.

GraphQL에서 커스텀 타입을 만드는 것은 API의 유연성과 확장성을 높이는 중요한 과정입니다.

GraphQL 스키마는 데이터의 구조를 정의하며, 커스텀 타입을 통해 특정 요구사항에 맞는 데이터 모델을 만들 수 있습니다.

아래에서는 GraphQL에서 커스텀 타입을 만드는 방법에 대해 자세히 설명하겠습니다.

1. GraphQL 스키마 정의 GraphQL 스키마는 GraphQL API의 구조를 정의하는 언어입니다.

스키마는 타입, 쿼리, 뮤테이션 등을 포함하며, 커스텀 타입을 정의하기 위해서는 먼저 스키마를 설정해야 합니다.

기본적인 스키마 구조 ```graphql type Query { hello: String } ``` 위의 예시는 기본적인 쿼리 타입을 정의한 것입니다.

`hello`라는 필드는 `String` 타입을 반환합니다.



2. 커스텀 타입 정의 커스텀 타입은 `type` 키워드를 사용하여 정의할 수 있습니다.

예를 들어, 사용자 정보를 담는 `User`라는 커스텀 타입을 정의할 수 있습니다.

```graphql type User { id: ID! name: String! email: String! } ``` 위의 예시에서 `User` 타입은 `id`, `name`, `email`이라는 세 개의 필드를 가지고 있습니다.

각 필드는 타입과 함께 정의되며, `!`는 해당 필드가 필수임을 나타냅니다.



3. 쿼리와 뮤테이션에 커스텀 타입 사용하기 커스텀 타입을 정의한 후, 이를 쿼리와 뮤테이션에 사용할 수 있습니다.

예를 들어, 사용자 정보를 가져오는 쿼리와 사용자를 생성하는 뮤테이션을 정의할 수 있습니다.

```graphql type Query { getUser(id: ID!): User } type Mutation { createUser(name: String!, email: String!): User } ``` 위의 예시에서 `getUser` 쿼리는 특정 ID를 가진 사용자를 반환하고, `createUser` 뮤테이션은 새로운 사용자를 생성하여 반환합니다.



4. 입력 타입 정의 입력 타입은 뮤테이션에서 클라이언트가 서버에 데이터를 전송할 때 사용됩니다.

입력 타입은 `input` 키워드를 사용하여 정의합니다.

```graphql input CreateUserInput { name: String! email: String! } ``` 이제 `createUser` 뮤테이션에서 이 입력 타입을 사용할 수 있습니다.

```graphql type Mutation { createUser(input: CreateUserInput!): User } ```

5. 스키마 통합 모든 타입과 쿼리, 뮤테이션을 통합하여 최종 스키마를 정의합니다.

```graphql schema { query: Query mutation: Mutation } ```

6. 서버 구현 GraphQL 스키마를 정의한 후, 이를 실제로 구현해야 합니다.

Node.js와 Apollo Server를 사용하는 예시는 다음과 같습니다.

```javascript const { ApolloServer, gql } = require('apollo-server'); // 스키마 정의 const typeDefs = gql` type User { id: ID! name: String! email: String! } input CreateUserInput { name: String! email: String! } type Query { getUser(id: ID!): User } type Mutation { createUser(input: CreateUserInput!): User } `; // 데이터 저장소 (예시) let users = []; let idCounter = 1; // 리졸버 정의 const resolvers = { Query: { getUser: (_, { id }) => users.find(user => user.id === id), }, Mutation: { createUser: (_, { input }) => { const newUser = { id: idCounter++, ...input }; users.push(newUser); return newUser; }, }, }; // 서버 생성 const server = new ApolloServer({ typeDefs, resolvers }); // 서버 시작 server.listen().then(({ url }) => { console.log(`🚀 Server ready at ${url}`); }); ```

7. 테스트 및 사용 서버가 실행되면 GraphQL Playground 또는 Postman과 같은 도구를 사용하여 쿼리와 뮤테이션을 테스트할 수 있습니다.

예를 들어, 사용자를 생성하는 뮤테이션은 다음과 같이 작성할 수 있습니다.

```graphql mutation { createUser(input: { name: "John Doe", email: "[email protected]" }) { id name email } } ``` 이와 같이 GraphQL에서 커스텀 타입을 정의하고 사용하는 방법을 통해, API의 구조를 유연하게 설계할 수 있습니다.

커스텀 타입을 활용하면 복잡한 데이터 구조를 명확하게 표현하고, 클라이언트와 서버 간의 데이터 통신을 효율적으로 관리할 수 있습니다.