GraphQL이란, 특징, 장단점, REST API와 비교

✔️ GraphQL이란?

Graph + Query Language의 줄임말이다. (API를 위한 쿼리 언어)

 

GraphQL은 Facebook에서 처음으로 개발했고, 오픈 소스로 제공된 쿼리 언어이다. 트리 구조로 쿼리 결과를 받기 위해 그래프를 탐색하는 쿼리 언어이다. 

 

✔️ GraphQL의 특징

- HTTP를 통해 API 서버로 요청을 보내고 응답을 받는다. 

- 응답을 받을 때 데이터 결과를 JSON 형식으로 받는다. 

- GraphQL은 서버 개발자가 작성한 각 필드에 대응하는 resolver 함수로 각 필드의 데이터를 조회할 수 있다. 

- GraphQL 라이브러리가 조회 대상 schema가 유효한지 검사한다. 

 

✔️ 그래프에서 트리 추출하는 방법

query {
	책(ISBN이 "9780674430006") {
		책 이름
		저자 {
			이름
		}
	}
}

 

👇 결과👇

{
	책 : {
		책 이름 : "GraphQL은 어렵지 않다",
		저자 : [
			{ 이름 : "김코딩"},
			{ 이름 : "박해커"},
		]
	}
}

 

---

✔️ GraphQL vs REST API

REST API도 있는데 왜 GraphQL이 나온걸까??

=> REST API의 한계가 존재하기 때문이지!

 

1. overfetch = 필요없는 데이터까지 제공함

2. underfetch = 엔드포인트가 필요한 정보를 충분히 제공하지 못함. / 한번에 fetch 해오지 못하기 때문에 각각의 엔드포인트에 요청을 보내야함.

3. 클라이언트 구조 변경 시 엔드포인트 변경 또는 데이터 수정이 필요함.

 

REST API	GraphQL
Resource의 크기와 형태를 서버에서 결정	Resource에 대한 정보만 정의하고, 필요한 크기와 형태는 클라이언트 단에서 요청 시 결정
URI가 Resource를 나타내고 Method가 작업의 유형을 나타낸다.	GraphQL Schema가 Resource를 나타내고 Query, Mutation 타입이 작업의 유형을 나타낸다.
여러 Resource에 접근하고자 할 때 여러 번의 요청이 필요	한번의 요청에서 여러 Resource에 접근 가능
요청은 해당 엔드포인트에 정의된 핸들링 함수를 호출하여 작업을 처리	요청 받은 각 필드에 대한 resolver를 호출하여 작업을 처리

 

---

✔️ GraphQL의 장점

1. 하나의 엔드포인트 endpoint 요청

• /graphql이라는 하나의 endpoint 로 요청을 받고 그 요청에 따라 query , mutation을 resolver 함수로 전달해서 요청에 응답한다. 모든 클라이언트 요청은 POST 메소드를 사용함.

2. overfetch, underfetch 없음

• 하나의 엔드포인트에서 쿼리를 이용해서 원하는 데이터를 정확하게 API에 요청하고 응답받을 수 있다. 

3. playground GUI 사용해서 resolver, schema 테스트 가능 (POSTMAN과 비슷)

4. 클라이언트 구조 변경에도 지장이 없음

• 필요한 데이터를 요청하고 응답받는 주체가 클라이언트이기 때문에 서버에 지장이 없다. 클라이언트에서는 무슨 데이터가 필요한지만 쿼리로 작성하면 끝!

✔️ GraphQL의 단점

1. 캐싱이 REST보다 훨씬 복잡하다. 

=> REST의 경우, HTTP에서는 각 메소드에 따라 캐싱이 구현되어 있지만, GraphQL에서는 POST 메소드만을 이용해서 요청을 보내기 때문에 각 메소드에 따른 캐싱을 지원받을 수 없다. 

=> 이를 보완하기 위해 나온 것이 Apollo 엔진의 캐싱 & 영속 쿼리

 

2. 고정된 요청과 응답만 필요한 경우에는 쿼리로 인해 요청의 크기가 RESTfull API 보다 더 커진다. =>추가공부 필요

 

 

😃 잘못된 개념 전달이 있다면 댓글 부탁드립니다. 저의 성장에 큰 도움이 됩니다🤓