Graph QL(3) - typeDefs와 resolvers

📌시작하며

유튜브 강의를 듣고 백엔드에서 만들어 둔 내용을 read하는 간단한 앱을 만들어봤는데, 백엔드 설정부분에서 이해가 부족한 부분을 채우고자 한다.😎

✅typeDefs

typeDef(Type Definition)는 GraphQL스키마 구조를 정의한다. 각 필드는 지정된 유형의 데이터를 반환하는데, 필드의 반환 유형은 scalar, object, enum, union, interface가 가능하다.

➡️Scalar types

GraphQL의 기본 스칼라 유형은 다음과 같다.

타입	설명
Int	32비트 정수 숫자
Float	소수점이 있는 숫자
String	문자열 (문자들의 모음)
Boolean	true 또는 false (참 또는 거짓)
ID	객체를 다시 가져오거나 캐시의 키로 사용하는 고유 식별자. 문자열로 저장되지만 사람이 읽기 위해 사용되지는 않음.

➡️Object types

체 타입은 각기 다른 타입의 필드들을 모아 놓은 것으로 두 개의 객체 타입은 서로를 필드로 포함할 수 있다.

type Book {
  title: String
  author: Author
}

type Author {
  name: String
  books: [Book]
}

• Book 타입: 책의 제목과 저자 정보를 가짐.
• Author 타입: 저자의 이름과 저자가 쓴 책들의 리스트를 가짐.

즉, 위와 같이 type이 정의되었다면, 이러한 데이터 형태를 가질 수 있다.

{
  "title": "해리포터",
  "author": {
    "name": "JK 롤링",
    "books": [
      {
        "title": "해리포터와 죽음의 성물"
      },
      {
        "title": "해리포터와 비밀의 방"
      }
    ]
  }
}

➡️The Query type

Query 타입은 클라이언트가 서버에 요청할 수 있는 읽기 작업의 진입점을 정의한다. 즉, REST API로 생각해보면, READ에 해당하는 작업을 할 때 사용하는 것으로, 읽기 작업에 필요한 내용(타입)을 모두 작성해주면 된다.

아래의 코드를 살펴보자. Query 타입에는 books와 authors 필드가 있고, 각각 Book과 Author 객체의 배열을 반환한다.

const { gql } = require("apollo-server")

const typeDefs = gql`
  type Query {
    books: [Book]
    authors: [Author]
  }

  type Book {
    title: String
    author: Author
  }

  type Author {
    name: String
    books: [Book]
  }
`

➡️The Mutation type

Mutation 타입은 구조와 목적 면에서 Query 타입과 비슷하다. Query 타입이 읽기 작업(READ)의 진입점을 정의한다면, Mutation 타입은 쓰기 작업(CREATE, DELETE, UPDATE)의 진입점을 정의한다.

type Book {
  title: String
  author: Author
}
type Author {
  name: String
  books: [Book]
}

type Mutation {
  addBook(title: String, author: Author): Book
}

여기서 addBook은 새로운 책을 추가하는데 사용되는 변이(mutator)를 정의한다. 이때 이 mutator는 두 개의 인자 title과 author를 받아 Book 객체를 반환한다.

여기서 Book은 위에서 정의한 type Book을 가리키며 Author 또한 type Author 타입을 가리키게 된다.

✅resolvers

GraphQL 스키마는 데이터의 구조와 타입을 정의하지만 실제 데이터를 가져오거나 계산하는 작업은 Resolver가 담당한다. 즉, Resolver가 없으면 아폴로 서버는 어떻게 데이터를 불러와야 하는지 알 수 없고 클라이언트 요청에 대한 응답을 생성할 수 없다.

아래 예제를 다시 살펴보자. 여기서 typeDefs를 통해 스키마를 정의할 때 데이터를 어떻게 요청하고 가져올지 결정했다.

const { gql } = require("apollo-server")

const typeDefs = gql`
  type Query {
    books: [Book]
    authors: [Author]
  }

  type Book {
    title: String
    author: Author
  }

  type Author {
    name: String
    books: [Book]
  }
`

그리고 실제로 데이터를 제공하는 역할은 resolvers가 하게 되는 것이다!

const resolvers = {
  Query: {
    books: () => books,
    movies: () => movies,
  },
}

➡️mutation typeDefs와 resolvers

추가로 mutation을 이용해 데이터를 업데이트 해보자! 먼저 아래와 같이 type Book과 type Mutation을 정의해줬다. 이때 type Mutation은 type Book 객체를 반환한다.

const typeDefs = gql`
  type Book {
    id: Int
    title: String
    author: String
  }

  type Mutation {
    addBook(id: Int, title: String, author: String): Book
  }
`

이렇게 만든 Mutation안의 addBook이라는 mutator에 어떻게 데이터를 주고 업데이트 할지에 관해 resolvers를 작성한다.

let nextBookId = 3

const resolvers = {
  Mutation: {
    addBook: (_, { title, author }) => {
      const newBook = { id: nextBookId++, title, author }
      books.push(newBook)
      return newBook
    },
  },
}

🗂️참고 사이트

• https://www.apollographql.com/docs/apollo-server/schema/schema/
• https://www.apollographql.com/docs/apollo-server/data/resolvers