GraphQL 소개

1. GraphQL이란?

• 2012년 페이스북에 의해 개발된 API를 위한 쿼리 언어
• API의 데이터에 대한 이해하기 쉬운 설명을 제공하고 클라이언트가 필요한 것을 "정확하게" 요청할 수 있는 능력을 제공함

1-1. GraphQL 요청과 REST 요청 비교

# GraphQL 요청

{
    assets(<album_id>) {
    id,
    url,
    comments {
        text
    }
}
}

REST 요청

GET /albums/:album_id/assets

1-2. GraphQL 처리 과정

1. 데이터 묘사

type Project {
  name: String
  tagline: String
  contributors: [User]
}

2. 필요한 데이터 선별적으로 클라이언트에 요청

{
    project(name: "GraphQL") {
        tagline
    }
}

3. 서버에서 예측한 데이터 받기

{
  "project": {
    "tagline": "A query language for APIs"
  }
}

2. GraphQL 사용 이유

2-1. 왜 REST가 있는데 GraphQL을 사용하는가?

• GraphQL은 REST에서 부족한 점을 보완하기 위해 탄생함
• GraphQL이 REST에 비해서 우수하다가 아닌 서로의 특징과 장단점이 있기에 상황에 알맞은 것을 사용하는 것이 중요함

2-2. GraphQL 장점

- 병렬 개발 작업 가능

• 주로 개발 과정을 살펴보면 백엔드 개발자가 REST API를 개발하면 프론트엔드 개발자가 해당 API를 호출해서 받아온 데이터를 화면에 보여줌
• 하지만, GraphQL을 이용하면 프론트엔드 개발과 백엔드 개발 전체 프로세스를 병렬로 작업할 수 있음

- Overfetching과 Underfetching을 막아줌

• 사용자의 특정 데이터만 필요한 상황에서 REST API의 엔드포인트가 사용자의 모든 정보를 반환하면 불필요한 데이터까지 포함되어 과다요청이 발생함
• 이는 대역폭을 낭비하고 성능저하를 야기 할 수 있음
• 사용자의 이름과 사용자가 작성한 포스트를 요청해야할 때, REST API의 엔드포인트가 사용자 정보와 포스트 정보를 따로 제공한다면, 2번의 요청을 보내야함
• 이는 추가적인 네트워크 비용과 지연을 초래할 수 있음

- Schema 작성

• schema를 작성함으로써 데이터가 어떻게 이루어져 있는지 계층 구조에 대해 알 수 있음

- 유효한 요청

• Type을 작성하기에 요청과 응답에 Valid한 데이터가 오고 감

2-3. GraphQL 단점

- 학습이 필요함

• 프론트엔드 개발자가 따로 GraphQL을 사용하는 방법을 배워야 함

- Schema와 Type을 정해주어야 함

• 구조를 파악할 수 있고 유효한 데이터를 응답받을 수 있으나 백엔드에 Schema와 Type을 정해주어야 함
• 작은 앱의 경우, 오히려 번거로울 수 있음

- REST API보다 데이터 캐싱이 까다로움

• REST에서는 URL을 사용하여 리소스에 액세스하기에 리소스 URL이 식별자로 있어 리소스 수준에서 캐시할 수 있음
• GraphQL은 동일한 엔터티에서 작동하더라도 쿼리마다 다를 수 있기에 매우 복잡함
• 하지만, GraphQL 위에 구축된 대부분의 라이브러리는 효율적인 캐싱 매커니즘을 제공함