GraphQL vs REST API

REST API의 한계

💡 필요 없는 데이터까지 제공함(Overfetch)
-endpoint 가 필요한 정보를 충분히 제공하지 못함
💡 클라이언트 구조 변경 시 엔드포인트 변경 또는 데이터 수정이 필요
-EST API에서는 자원의 크기와 형태를 서버에서 결정하기 때문에 클라이언트가 직접 데이터의 형태를 결정할 수 없기 때문

GraphQL 장점

📗 하나의 endpoint 요청
-/graphql이라는 하나의 endpoint 로 요청을 받고 그 요청에 따라 query , mutation을 resolver 함수로 전달해서 요청에 응답
-모든 클라이언트 요청은 POST 메소드를 사용
-under & overfetching 우려 없음

📗 강력한 playground
playground라는 GUI를 이용해 resolver 와 schema 를 한 눈에 보고 테스트 가능

📗 클라이언트 구조 변경에도 지장이 없음
필요한 데이터를 결정하고 받는 주체가 클라이언트이기 때문에 서버에 지장이 없음
클라이언트에서는 무슨 데이터가 필요한 지에 대해서만 요구사항을 쿼리로 작성

GraphQL 단점

📗 학습 시간 필요
REST API가 익숙하다면 GraphQL를 학습하는 데 시간 필요

📗 캐싱이 REST보다 훨씬 복잡함
HTTP에선 각 메소드에 따라 캐싱이 구현,
GraphQL에선 POST 메소드만을 이용해 요청을 보내기 때문에
각 메소드에 따른 캐싱 지원 불가
🔅 Apollo 엔진의 캐싱과 영속 쿼리 등으로 보완

📗 고정된 요청과 응답의 경우 불필요
고정된 요청과 응답만 필요할 경우에는 Query 로 인해 요청의 크기가 RESTful API 보다 큼

REST API와 GraphQL

📗 Resource 정의와 데이터 요청
REST API Resource에 대한 형태 정의와 데이터 요청 방법이 연결
GraphQL Resource에 대한 형태 정의와 데이터 요청이 완전히 분리

📗 Resource에 대한 결정
REST API Resource의 크기와 형태를 서버에서 결정
GraphQL Resource에 대한 정보만 정의, 필요한 크기와 형태는 클라이언트 단에서 요청 시 결정

📗 Resource와 작업 유형
REST API URI가 Resource를 나타내고 Method가 작업의 유형
GraphQL GraphQL Schema가 Resource를 나타내고 Query, Mutation 타입이 작업의 유형

📗 Resource와 요청 빈도
REST API 여러 Resource에 접근하고자 할 때 여러 번의 요청이 필요
GraphQL 한번의 요청에서 여러 Resource에 접근 가능

📗 작업 처리
REST API 각 요청은 해당 엔드포인트에 정의된 핸들링 함수를 호출하여 작업을 처리
GraphQL 요청 받은 각 필드에 대한 resolver를 호출하여 작업을 처리