[Spring] RESTful API

🤷‍♂️ REST?   REST API?   RESTful API?

REST 란 웹(HTTP)의 장점을 최대한 활용할 수 있는 아키텍쳐입니다.

 

REST API(REpresentational State Transfer)는 REST 아키텍쳐 스타일을 따르는 API로, 웹상에서 사용되는 여러 리소스를 HTTP URI(Resourse)로 표현하고, 해당 리소스에 대한 행위를 HTTP Method( GET, POST, PUT, PATCH, DELETE )로 정의하여 특정한 형태(자원의 형태)로 전달하는 방식을 말합니다. 

 

RESTful API란 REST API 설계 가이드를 따라 API를 만들어 웹서비스를 제공하면 해당 웹 서비스는 RESTful하다고 말하며 RESTful 한 API를 RESTful API라고 합니다.

---

REST의 구성

REST는 다음과 같은 구성으로 이루어져 있습니다.

• URI : 자원 (Resource)
• HTTP Method : 행위 (Verb) 
  • POST : 생성 (Create)
  • GET : 조회 (Read)
  • PUT : 수정 (Update)
  • DELETE : 삭제 (Delete)
  • HEAD : header 정보 조회
• Representations : 표현

---

REST API의 특징

REST API는 아래와 같은 특징을 가집니다. 

 

• Uniform interface(인터페이스 일관성) : 유니폼 인터페이스는 URI로 지정한 리소스에 대한 조작을 통일되고 균일한 인터페이스를 제공합니다. 아키텍처를 단순하게 분리하여 독립적으로 만들 수 있습니다. 
  • Self-descriptiveness (자체 표현 구조) : JSON형태의 메시지를 통해 내용을 직관적으로 이해할 수 있습니다. 즉, REST API 메시지 구조만을 보고도 쉽게 이해할 수 있는 자체 표현 구조로 되어 있습니다. 
  • identification of resources (자원 식별) : URI를 통한 자원 식별을 말합니다. 자원을 나타낼 때에는 동사가 아닌 명사를 사용해야 합니다. 또한, 표현하고자 하는 자원이 복수형일땐 명시가 필요합니다. ex. http://localhost:8080/movies/...
  • manipulation of resources through representation : representation 전송을 통해서 리소스를 조작해야 합니다. ( 리소스를 만들거나 삭제하거나 할때 리소스에 HTTP 메시지에 그 표현을 담아서 전달해야 합니다. ) ex.content-type, HTTP method
  • HATEOAS : hypermedia as the engine of application state ( 애플리케이션 상태에 대한 엔진으로서 하이퍼미디어 ) : 어플리케이션은 사용자가 어떤 행위를 하느냐에 따라 상태가 바뀌게 됩니다.
• Stateless (무상태성) : 상태정보를 따로 저장하거나 관리하지 않는 특징을 가집니다. 즉, 세션 및 쿠키같은 정보를 저장하지 않기 때문에 API 서버는 들어오는 요청을 처리만 하면 됩니다. 따라서 서비스의 자유도가 높아지고 서버가 불필요한 내용들을 관리하지 않음으로써 비용이 줄어들게 됩니다. 단, 클라이언트의 모든 요청은 서버가 요청을 알아들을 수 있게끔 모든 정보를 담고 있어야 합니다. 
• Cacheable (캐싱) : HTTP라는 기존 웹표준을 그대로 사용하기에, 웹에서 사용하는 기존 인프라를 사용 할 수 있고 결국 HTTP가 가진 캐싱 기능을 사용 할 수 있습니다. 
• Server / Client 구조 : 클라이언트와 서버의 관심사가 명확히 분리되어 있어야 합니다. 서버는 클라이언트가 원하는 데이터를 제공하는 역할, 클라이언트는 서버가 보내준 데이터를 이용하여 사용자가 원하는 화면을 보여주는 역할을 담당합니다. 
• 계층형 구조 : REST 서버는 다중 계층으로 구성될 수 있으며 보안, 로드 밸런싱, 암호화 계층을 추가해 구조상의 유연성을 둘 수 있고 프록시, 게이트웨이 같은 네트워크 기반의 중간매체를 사용할 수 있게 합니다.
• Code-On-Demand : 서버가 네트워크를 통해 클라이언트에 프로그램을 전달하면 그 프로그램이 클라이언트에서 실행될 수 있어야 합니다. (필수는 아닌 option)

---

 

참고한 사이트

• https://dingue.tistory.com/11