[Spring] REST, REST API, RESTful ?

REST

HTTP URI(Uniform Resource Identifier)를 통해 자원(Resource)을 명시하고, HTTP Method(POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미한다.
 
REST는 월드 와이드 웹(www)과 같은 분산 하이퍼 미디어 시스템을 위한 소프트웨어 개발 아키텍처의 한 형식이다.
 

REST 구성 요소 

1. 자원(Resource) : HTTP URI - 자원의 위치를 나타내는 일종의 식별자
2. 자원에 대한 행위(Verb) : HTTP Method - GET, POST, PUT, DELETE 등이 존재
3. 자원에 대한 행위의 내용 (Representations) : HTTP Message Pay Load - HTTP header, body, 응답 상태 코드 등으로 구성

 

REST의 특징

1. Server-Client(서버-클라이언트) 구조

• 자원이 있는 쪽이 Server, 자원을 요청하는 쪽이 Client가 된다.
• 서버는 API를 제공하고 비즈니스 로직 처리 및 저장을 책임진다. 

2. Stateless(무상태)

• HTTP 프로토콜은 기본적으로 무상태이며, REST 역시 HTTP를 기본으로 하기 때문에 무상태이다.
  
  • 무상태란 클래이언트의 상태(State)를 서버에 저장하지 않는다는 뜻이다.
  • 일반적으로 웹은 클라이언트와 서버 간의 통신을 위해 서버가 클라이언트의 이전 요청을 기억하고 있는다. - stateful (상태성)
  • 그러나 무상태의 특성으로 서버는 클라이언트의 요청을 완전히 별개의 것으로 인식하고 처리한다.
  • 즉 이전의 요청이 다음 요청에 연관되지 않는다!
  • 이를 통해 서버의 처리 방식에 일관성을 부여하고 부담이 줄어들게 된다.
• Client의 context(상태 정보나 세션 정보)를 Server에 저장하지 않는다.
  • 즉, 세션과 쿠키와 같은 context 정보를 신경쓰지 않아도 되므로 구현이 단순해진다.
• Server는 각각의 요청을 완전히 별개의 것으로 인식하고 처리한다.
  • 각 API 서버는 Client의 요청만을 단순 처리한다.
  • 즉, 이전 요청이 다음 요청의 처리에 연관되어서는 안된다.
  • 물론 이전 요청이 DB를 수정하여 DB에 의해 바뀌는 것은 허용한다.
  • Server의 처리 방식에 일관성을 부여하고 부담이 줄어들며, 서비스의 자유도가 높아진다.
• 즉 상태 정보를 서버에 저장하지 않고, 클라이언트 측에서 모든 필요한 정보를 담고 있는 요청을 보내면서 서버와 통신하는 방식

3. Cacheable(캐시 처리 가능)

• HTTP가 가진 가장 강력한 특징 중 하나인 캐싱 기능을 적용할 수 있다.
• 대량의 요청을 효율적으로 처리하기 위한 캐시를 사용할 수 있다.
• 캐시 사용을 통해 응답 시간이 빨라지고 성능, 서버의 자원 이용률을 향상할 수 있다.

4. Layered System(계층화)

• Client는 REST API 서버만 호출한다. 
• REST Server는 다중 계층으로 구성될 수 있다.
  • API Server는 순수 비즈니스 로직을 수행하고 그 앞단에 보안, 로드 밸런싱, 암호화, 사용자 인증 등을 추가하여 구조상의 유연성을 줄 수 있다.

5. Code-On-Demand 

• Server로부터 스크립트를 받아서 Client에서 실행한다.
• 반드시 충족할 필요는 없다.

6. Uniform Interface(인터페이스 일관성)

• URI로 지정한 Resource에 대한 조작을 통일되고 한정적인 인터페이스로 수행한다.
• HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용이 가능하다.
  • 특정 언어나 기술에 종속되지 않는다.

REST의 장단점

장점
1. 언어와 플랫폼에 독립적이다.
2. REST API 메시지가 의도하는 바를 명확하게 나타내 의도를 쉽게 파악할 수 있다.
3. HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용이 가능하다.
4. HTTP 프로토콜의 인프라를 그대로 사용하므로 REST API 사용을 위한 별도의 인프라를 구출할 필요가 없다.
5. 서버와 클라이언트의 역할을 명확하게 분리한다.
 
단점
1. HTTP 프로토콜만 사용 가능하다. (HTTP Method 형태가 제한적)
2. 표준이 존재하지 않는다.
 

REST API

API(Application Programming Interface)
: 데이터와 기능의 집합을 제공하여 컴퓨터 프로그램간 상호작용을 촉진하며, 서로 정보를 교환가능 하도록 하는 것
 
REST API
: REST 기반으로 서비스 API를 구현한 것, REST는 HTTP 표준을 기반으로 구현하므로, HTTP를 지원하는 프로그램 언어로 클라이언트, 서버를 구현할 수 있다.
 
주로 쓰이는 5가지

• POST : 데이터를 새로 저장할 때 사용된다.
• GET : 기존 데이터를 받아올 때 사용된다.
• PUT : 기존 데이터를 완전히 다른 데이터로 변경할 때 사용한다.
• PATCH : 기존 데이터에서 일부분을 수정할 때 사용된다.
• DELETE : 기존 데이터를 삭제할 때 사용된다.

 

RESTful?

• RESTful은 일반적으로 REST라는 아키텍처를 구현하는 웹 서비스를 나타내기 위해 사용되는 용어이다.
  • ‘REST API’를 제공하는 웹 서비스를 ‘RESTful’하다고 할 수 있다.
• REST API의 설계 규칙을 올바르게 지킨 시스템을 RESTful하다고 한다.
  • ESTful은 일반적으로 REST라는 아키텍처를 구현하는 웹 서비스를 나타내기 위해 사용되는 용어이다.
  • ‘REST API’를 제공하는 웹(HTTP) 서비스를 ‘RESTful’하다고 할 수 있다.
• RESTful의 목적은 이해하기 쉽고 사용하기 쉬운 REST API를 만드는 것 이다.