Node.js에서 GraphQL 스키마를 정의하는 방법은 무엇인가요?

Q: Node.js에서 GraphQL 스키마를 정의하는 기본적인 방법은 무엇인가요?
A: Node.js에서 GraphQL 스키마를 정의하려면 `graphql` 라이브러리의 `buildSchema` 함수나, `graphql-tools`의 `makeExecutableSchema`, 또는 `Apollo Server`의 `gql` 태그를 사용할 수 있습니다. 보통 스키마는 GraphQL SDL(Schema Definition Language) 형태로 문자열로 작성하고, 타입(type), 쿼리(query), 뮤테이션(mutation)을 포함합니다.

---

Q: `buildSchema`를 사용해 GraphQL 스키마를 정의하는 예시는 어떻게 되나요?
A:
```javascript
const { buildSchema } = require('graphql');

const schema = buildSchema(`
type Query {
hello: String
}
`);
```
위처럼 `buildSchema`에 SDL 문자열을 전달해 간단한 쿼리 타입을 정의할 수 있습니다.

---

Q: Apollo Server에서 스키마를 정의하는 방법은 어떤가요?
A: Apollo Server에서는 `gql` 태그를 활용해 다음과 같이 정의합니다.
```javascript
const { ApolloServer, gql } = require('apollo-server');

const typeDefs = gql`
type Query {
hello: String
}
`;

const resolvers = {
Query: {
hello: () => 'Hello world!',
},
};

const server = new ApolloServer({ typeDefs, resolvers });
```
`typeDefs`에 SDL 문자열을 작성하고, 각각 타입에 맞는 `resolvers`를 구현하여 연결합니다.

---

Q: 스키마 내에서 custom scalar 타입이나 enum 타입은 어떻게 정의하나요?
A: SDL 내에서 직접 다음과 같이 정의합니다.
```graphql
scalar Date

enum Role {
ADMIN
USER
GUEST
}

type User {
id: ID!
name: String!
birthdate: Date
role: Role!
}
```
커스텀 scalar는 별도의 resolver 구현이 필요하며 enum 타입은 위처럼 선언 후 필드 타입으로 사용 가능합니다.
---

Q: 여러 타입과 쿼리, 뮤테이션을 포함한 복잡한 스키마 예시는 어떻게 작성하나요?
A: 예를 들어:
```graphql
type Query {
user(id: ID!): User
users: [User!]!
}

type Mutation {
createUser(name: String!, email: String!): User
}

type User {
id: ID!
name: String!
email: String!
}
```
이런 형태로 여러 쿼리와 뮤테이션, 타입들을 한 스키마에 정의하여 기능을 확장할 수 있습니다.

---

Q: 스키마를 별도의 파일(.graphql/.gql)로 분리하는 방법이 있나요?
A: 네, 스키마를 문자열로 직접 작성하기보다 `.graphql` 또는 `.gql` 파일에 SDL을 작성 후, `graphql-tools`의 `loadFilesSync`나 `mergeTypeDefs` 등을 이용해 가져올 수 있습니다. 이렇게 하면 관리가 용이해집니다.

---

Q: TypeScript 환경에서 스키마를 타입 안정성 있게 작성하는 방법은?
A: `TypeGraphQL`과 같은 라이브러리를 통해 GraphQL 타입을 TypeScript 클래스로 정의할 수 있습니다.
```typescript
import { ObjectType, Field, ID, Query, Resolver } from 'type-graphql';

@ObjectType()
class User {
@Field(() => ID)
id: string;

@Field()
name: string;
}

@Resolver()
class UserResolver {
@Query(() => User)
user() {
return { id: '1', name: 'John Doe' };
}
}
```
이 방법은 코드 우선(code-first) 방식으로 스키마를 정의합니다.

---

Q: 요약하면, Node.js에서 GraphQL 스키마 정의 시 주로 사용하는 방법은?
A:
1. SDL 기반: `buildSchema` 함수나 Apollo Server `gql` 태그로 SDL 문자열로 스키마 작성
2. 파일 분리: `.graphql` 파일로 작성 후 로드
3. 코드 우선: TypeGraphQL처럼 TypeScript 클래스로 스키마 정의
4. 커스텀 스칼라 및 Enum 등 확장 타입은 SDL에 명시하고 리졸버 통해 구현

이와 같이 프로젝트 요구에 맞게 적합한 방식을 선택해 스키마를 정의합니다.

Node.js에서 GraphQL 스키마를 정의하는 방법은 GraphQL의 기본 개념을 이해하고, 이를 Node.js 환경에서 구현하는 과정을 포함합니다.

GraphQL 스키마는 API의 구조를 정의하며, 클라이언트가 요청할 수 있는 데이터의 형태와 관계를 명시합니다.

아래에서는 GraphQL 스키마를 정의하는 방법에 대해 단계별로 설명하겠습니다.

1. GraphQL 설치 먼저, Node.js 프로젝트를 생성하고 필요한 패키지를 설치해야 합니다.

GraphQL을 사용하기 위해 `graphql`과 `apollo-server` 패키지를 설치합니다.

```bash mkdir graphql-example cd graphql-example npm init -y npm install graphql apollo-server ```

2. GraphQL 스키마 정의 GraphQL 스키마는 `type`, `query`, `mutation`, `subscription` 등으로 구성됩니다.

기본적인 스키마를 정의하는 방법은 다음과 같습니다.

```javascript const { ApolloServer, gql } = require('apollo-server'); // 스키마 정의 const typeDefs = gql` type Book { title: String author: String publishedYear: Int } type Query { books: [Book] book(title: String!): Book } type Mutation { addBook(title: String!, author: String!, publishedYear: Int!): Book } `; ``` 위의 예제에서 `Book` 타입은 책의 제목, 저자, 출판 연도를 포함합니다.

`Query` 타입은 모든 책을 가져오는 `books` 쿼리와 특정 제목의 책을 가져오는 `book` 쿼리를 정의합니다.

`Mutation` 타입은 새로운 책을 추가하는 `addBook` 뮤테이션을 정의합니다.



3. 리졸버 정의 리졸버는 클라이언트의 요청을 처리하는 함수입니다.

각 쿼리와 뮤테이션에 대해 리졸버를 정의해야 합니다.

```javascript const books = []; const resolvers = { Query: { books: () => books, book: (parent, args) => books.find(book => book.title === args.title), }, Mutation: { addBook: (parent, args) => { const newBook = { title: args.title, author: args.author, publishedYear: args.publishedYear }; books.push(newBook); return newBook; }, }, }; ``` 위의 리졸버에서는 `books` 쿼리가 호출되면 `books` 배열을 반환하고, `book` 쿼리는 제목으로 책을 검색하여 반환합니다.

`addBook` 뮤테이션은 새로운 책을 배열에 추가하고 추가된 책을 반환합니다.



4. Apollo Server 설정 이제 Apollo Server를 설정하고 스키마와 리졸버를 연결합니다.

```javascript const server = new ApolloServer({ typeDefs, resolvers }); server.listen().then(({ url }) => { console.log(`🚀 Server ready at ${url}`); }); ``` 위의 코드는 Apollo Server를 생성하고, 정의한 스키마와 리졸버를 사용하여 서버를 시작합니다.

서버가 시작되면 GraphQL Playground에서 API를 테스트할 수 있는 URL이 출력됩니다.



5. 서버 실행 이제 모든 설정이 완료되었습니다.

아래의 명령어로 서버를 실행합니다.

```bash node index.js ``` 서버가 실행되면, 브라우저에서 출력된 URL로 이동하여 GraphQL Playground를 통해 쿼리와 뮤테이션을 테스트할 수 있습니다.



6. 쿼리 및 뮤테이션 테스트 GraphQL Playground에서 다음과 같은 쿼리와 뮤테이션을 테스트할 수 있습니다.

책 추가하기 ```graphql mutation { addBook(title: "The Great Gatsby", author: "F. Scott Fitzgerald", publishedYear: 192

5) { title author } } ``` 모든 책 가져오기 ```graphql query { books { title author publishedYear } } ``` 특정 책 가져오기 ```graphql query { book(title: "The Great Gatsby") { title author publishedYear } } ``` 결론 Node.js에서 GraphQL 스키마를 정의하는 과정은 스키마와 리졸버를 설정하고 Apollo Server를 통해 API를 제공하는 것으로 요약할 수 있습니다.

GraphQL의 유연성과 강력한 타입 시스템을 활용하여 클라이언트가 필요한 데이터를 효율적으로 요청할 수 있도록 설계할 수 있습니다.

이 기본적인 예제를 바탕으로 더 복잡한 스키마와 리졸버를 구현하여 다양한 기능을 추가할 수 있습니다.