GraplQL (1) 개념

🦥 1. Graph QL 개념

1.1 GraphQL 이란?

• GraphQL 은 API를 위한 질의어이자 존재하는 데이터에 대해 쿼리를 수행하는 언어
• API 에 있는 데이터를 완벽하고 이해가능한 상태로 제공
• Client 가 GraphQL 형식으로 요청하면 필요하고 필요하지 않은 데이터를 정확하게 요청할 수 있다

1.2 GraphQL 장단점

장점

• 필요하고 얻고자 하는 데이터만 정확하게 요청 가능
  • GraphQL 쿼리로 API 에 요청을 보내면 정확하게 원하는 데이터만 받을 수 있음
  • 어떤 데이터를 리턴받을 지 명시하기 때문에 예측가능한 결과만 리턴
• 서버가 아닌 클라이언트가 가지고 올 데이터를 통제하기 때문에 빠르고 안정적임
• REST API 는 여러 URI 를 통해 데이터를 로딩하지만 GraphQL 은 단일 요청으로 데이터를 가지고 올 수 있음

단점

• 파일 업로드 구현 방법이 정해져 있지 않아서 직접 구현해야 한다
• 고정된 요청과 응답이 필요할 때 query로 인해 요청의 크기가 REST API 방식보다 크다

1.3 SQL query 와 GraphQL

• SQL Query는 서버로부터 데이터를 효율적으로 가져오기 위한 질의어
• GraphQL 은 클라이언트가 데이터를 서버로 부터 효율적으로 가져오기 위한 질의어

🦥 2. REST API 와 GraphQL

2.1 REST API

• GraphQL 과 마찬가지로 데이터를 교환하기 위한 인터페이스
• 자원을 이름으로 구분하여 관리하는 것
• URI를 통해 자원을 명시하고 HTTP Method 를 통해 자원에 대한 처리 방법을 명시

2.2 REST API 와 GraphQL 의 엔드 포인트 비교

💡 경기 정보들을 조회하는 페이지에서 보여줘야 할 데이터

1. Teams : 여러개의 팀 정보

2. Players : 팀의 선수들 정보

3. Matches : 여러개 팀의 경기 정보

클라이언트에서 REST API 방식으로 호출할 경우

• Team 정보를 가져오기 위해 GET /team/{teamID} 호출
• 해당 Team 의 Matche 정보를 가져오기 위해 GET /match/list/{teamId} 호출

클라이언트에서 GraphQL 방식으로 호출할 경우

query {
	team(teamId: 1) {
		teamname
		teamcoach
		teamcolor
    	}
	matches(teamId: 1) {
		matchdate
		matchteam
	}
}