🐯 심바의 RESTful

[10분 테코톡] 🐯 심바의 RESTful 를 듣고 정리함.

REST란

분산 하이퍼미디어 시스템을 위한 소프트웨어 아키텍쳐 - MDN

네트워크 리소스를 정의하고 처리하는 방법을 설명하는 일련의 원칙을 기반으로 하는 아키텍처 스타일

네트워크 리소스, 예를들어 클라이언트와 서버가 데이터를 주고 받는 방식에 대해 정리한 원칙이 있고 그 원칙을 기반으로 한 아키텍쳐 스타일을 REST라고 한다.

로이필딩

REST에 대한 원칙은 로이필딩이라는 대학원생의 박사학위 논문으로 처음 등장했다. 로이필딩은 HTTP의 주요 저자 중 한 사람으로 HTTP가 제대로 사용되지 못하는 점을 안타까워하며 HTTP의 장점을 최대한 활용할 수 있는 아키텍쳐로써 REST를 발표했다고 한다.

그러므로 REST원칙은 HTTP를 잘 활용하기 위한 원칙이라고도 할 수 있다.

일반적인 REST API의 구조와 특징

이 REST에 대한 원칙을 준수했을 때 우리는 그 시스템이 RESTful하다 라고 한다.

REST는 앞서 살펴 보았듯이, 특정 기술이 아니라 아키텍처 스타일이다. 일반적으로 웹 개발을 하면서 이 REST 아키텍쳐 스타일을 참고해서 설계한 API를 많이 찾아볼 수 있다. 그리고 이러한 API들도 범용적으로 REST API,

RESTful하게 설계된 REST-style API라고도 한다.

REST는 Representational State Transfer이라는 뜻으로 직역하자면, 표현적인 상태 전달이다. 여기에 덧붙여서 의역해 보자면 자원(리소스)의 표현에 의한 상태(정보) 전달이라는 뜻을 가진다.

여기서 자원의 표현은 REST의 가장 큰 특징이다.

자원의 표현

URI 만 보고서도 어느정도 정보에 대해 유추할 수 있다.

이처럼 리소스를 URI에 표현해서 주고받을 정보에 대해 어느정도 예측이 가능한 것이다.

REST API 에서 URI는 어떤 구조를 가지는지 살펴보자.

테이블 전체에 해당하는부분은 Collection ,행 하나, 혹은 객체를 Document라고 한다. 콜렉션은 일반적으로 객체의 집합이기 때문에 복수 명사를 사용한다. 다큐먼트는 이 집합(콜렉션)중 객체를 구분할 수 있는 값,위에서는 title이지만 일반적으로는 Pk id를 많이 사용한다.

즉 URI는 컬렉션과 다큐먼트의 조합으로 이루어져 있다.

URI에는 동사를 사용하지 않는다. 이러한 동사는 제네릭하지 않기 때문이다. 동사를 쓰고자 함은 곧 자원에 대한 행위에 대해 표현하고자 하는 목적일 것이다.

REST API에서는 자원에 대한 행위에 대한 표현을 위해 동사를 사용하기 보다는 HTTP 메소드를 통해 표현한다.

하지만 오직 URI와 메소드들을 활용해서 모든 것을 표현하는 것에는 한계가 있다. ex) login, logout, 검색 등등