Rest-api vs Graphql-api?

Parker.Park·2022년 3월 19일

코드캠프

목록 보기

5/34

Rest-api ?

API(APplication Interface)는 애플리케이션이나 디바이스가 서로간에 연결하여 통신할 수 있는 방법을 정의하는 규칙 세트이다.
REST(REpresentational State Transfer) API 는 REST 아키텍처 스타일의 디자인 원칙(조건)을 준수하는 API 이다.

REST? RESTful?

Roy Fielding 박사라는 분이 2000년에 자신의 박사학위 논문에 처음으로 정의한 말로 비교적 높은 수준의 유연성과 자유를 제공하려고 고안한 방법이다.
하나의 애플리케이션이나 서비스가 다른 애플리케이션이나 서비스 내의 리소스를 엑세스할 수 있도록 해주는 메커니즘이다. 비교적 다양한 데이터 포맷을 지원하며, 요구사항 6가지는 다음과 같다.

균일한 인터페이스

요청이 어디에서 오는지와 무관하게, 동일한 리소스에 대한 모든 API 요청은 동일하게 보여야 합니다. REST API는 사용자의 이름이나 이메일 주소 등의 동일한 데이터 조각이 오직 하나의 URI(Uniform Resource Identifier)에 속함을 보장해야 합니다. 리소스가 너무 클 필요는 없지만, 이는 클라이언트가 필요로 하는 모든 정보를 포함해야 합니다.

클라이언트-서버 디커플링

REST API 디자인에서, 클라이언트와 서버 애플리케이션은 서로 간에 완전히 독립적이어야 합니다. 클라이언트 애플리케이션이 알아야 하는 유일한 정보는 요청된 리소스의 URI이며, 이는 다른 방법으로 서버 애플리케이션과 상호작용할 수 없습니다. 이와 유사하게, 서버 애플리케이션은 HTTP를 통해 요청된 데이터에 전달하는 것 말고는 클라이언트 애플리케이션을 수정하지 않아야 합니다.

Stateless.

REST API는 stateless입니다. 이는 각 요청에서 이의 처리에 필요한 모든 정보를 포함해야 함을 의미합니다. 즉, REST API는 서버측 세션을 필요로 하지 않습니다. 서버 애플리케이션은 클라이언트 요청과 관련된 데이터를 저장할 수 없습니다.

캐싱 가능성

가급적이면, 리소스를 클라이언트 또는 서버측에서 캐싱할 수 있어야 합니다. 또한 서버 응답에는 전달된 리소스에 대해 캐싱이 허용되는지 여부에 대한 정보도 포함되어야 합니다. 이의 목적은 서버측의 확장성 증가와 함께 클라이언트측의 성능 향상을 동시에 얻는 것입니다.

계층 구조 아키텍처

REST API에서는 호출과 응답이 서로 다른 계층을 통과합니다. 일반적으로는, 클라이언트와 서버 애플리케이션이 서로 간에 직접 연결된다고 가정하지 마세요. 통신 루프에는 다수의 서로 다른 중개자가 있을 수 있습니다. REST API는 엔드 애플리케이션 또는 중개자와 통신하는지 여부를 클라이언트나 서버가 알 수 없도록 설계되어야 합니다.

코드 온디맨드(옵션)

REST API는 일반적으로 정적 리소스를 전송하지만, 특정한 경우에는 응답에 실행 코드(예: Java 애플릿)를 포함할 수도 있습니다. 이러한 경우에, 코드는 요청 시에만 실행되어야 합니다.

대략적으로 이해는 가지만 역시 어려운 개념들이다. 그대로 놔두면 취약점이 많아 실제로는 여러 인증을 거쳐 보안을 높이고 있다고 한다.

graphQL?

그래프QL(이하 graphql)은 페이스북에서 2012년 개발하여 2015년에 공개한 데이터 질의어이다. graphql은 REST나 부속 웹서비스 아키텍처를 대체 할 수 있다고 한다.
클라이언트는 필요한 데이터의 구조를 지정할 수 있으며, 서버는 정확히 동일한 구조로 데이터를 반환한다. 그래프QL은 사용자가 어떤 데이터가 필요한지 명시할 수 있게 해 주는 강타입 언어이다. 이러한 구조를 통해 불필요한 데이터를 받게 되거나 필요한 데이터를 받지 못하는 문제를 피할 수 있다.
주요 그래프QL 클라이언트로는 아폴로 클라이언트와 Relay 등이 있다.

graphql 구조- 쿼리/뮤테이션(query / mutation)

qeury는 데이터 처리 기능이 CRUD 중 R에 속한다. 기본 문구는 아래와 같다

qeury{
	user{
   	name:""
   }
}

mutation은 데이터 처리기능 중 CUD를 맡는다.

mutaion{
	createboard(name:"Board"){
   	name
   }
}

이런 쿼리문을 사용하기 위해서는 스키마를 정의해야 한다.

resolver(리졸버)

데이터베이스 사용시, 데이터를 가져오기 위해서 sql을 작성 했다. 또한, 데이터베이스에는 데이터베이스 어플리케이션을 사용하여 데이터를 가져오는 구체적인 과정이 구현 되었다. 그러나 gql 에서는 데이터를 가져오는 구체적인 과정을 직접 구현 해야 한다. gql 쿼리문 파싱은 대부분의 gql 라이브러리에서 처리를 하지만, gql에서 데이터를 가져오는 구체적인 과정은 resolver가 담당하고, 이를 직접 구현 해야 한다. 프로그래머는 리졸버를 직접 구현해야하는 부담은 있지만, 이를 통해서 데이터 source의 종류에 상관 없이 구현이 가능 하다고 한다. 예를 들어서, 리졸버를 통해 데이터를 데이터베이스에서 가져 올 수 있고, 일반 파일에서 가져 올 수 있고, 심지어 http, SOAP와 같은 네트워크 프로토콜을 활용해서 원격 데이터를 가져올 수 있다고 한다. 덧붙이면, 이러한 특성을 이용하면 legacy 시스템을 gql 기반으로 바꾸는데 활용 있다고 한다.