REST (Representational State Transfer : 자원의 상태 전달) - 네트워크 아키텍처
- 다음의 5가지를 잘 지켰는지에 따라 RESTFul하다고 말한다.
- Client, Server : 클라이언트와 서버가 서로 독립적으로 분리 되어 있어야 한다.
- Stateless : 요청에 대해서 클라이언트의 상태를 서버에 저장하지 않는다.
- Cache : 클라이언트는 서버의 응답을 Cache할 수 있어야한다.
클라이언트가 Cache를 통해 응답을 재사용할 수 있어야 하며, 이를 통해 서버의 부하를 낮춘다.
- 계층화 (Layered System) : 서버와 클라이언트 사이에 방화벽, 게이트웨이, Proxy등 다양한 계층 형태로 구성이 가능해야 하며, 이를 확장 할 수 있어야한다.
- 인터페이스 일관성 : 인터페이스의 일관성을 지키고, 아키텍처를 단순화시켜 작은 단위로 분리하여, 클라이언트, 서버가 독립적으로 개선 될 수 있어야한다.
- Code on Demand (Optional) : 자바 애플릿, 자바스크립트, 플래시 등 특정한 기능을 서버로부터 클라이언트가 전달받아 코드를 실행 할 수 있어야 한다.
다음의 인터페이스 일관성이 잘 지켜졌는지에 따라, REST를 잘 사용했는지 판단할 수 있다.
- 자원의 식별
- 웹 기반의 REST에서는 리소스 접근을 할 때 URI를 사용한다.
- ex) https://foo.co.kr/user/100 Resource : user 식별자 : 100
- 메시지를 통한 리소스 조작
- Web에서는 다양한 방식으로 데이터를 전달 할 수 있다.
- 그 중 가장 많이 사용하는 방식은 HTML, XML, JSON, TEXT등이 있다.
- 이 중에서 어떤 타입의 데이터인지를 알려주기 위해 HTTP Header부분에 content-type을 통해 데이터의 타입을 지정해 줄 수 있다.
- 또한 리소스 조작을 위해 데이터 전체를 전달 하지 않고, 이를 메시지로 전달한다.
ex) 서버의 user라는 정보의 전화번호를 처음에는 number라고 결정했고, 이 정보를 Client와 주고 받을 때, 그대로 사용하고 있었다면 후에 서버의 resource변경으로 phone-number로 바꾸게 된다면 Client는 처리하지 못하고 에러가 발생한다.
→ 이러한 부분을 방지 하기 위해 별도의 메시지의 형태로 데이터를 주고 받으며 Client-server가 독립적으로 확장 가능하도록 한다.
- 자기 서술적 메시지
- 요청 하는 데이터가 어떻게 처리 되어져야 하는지 충분한 데이터를 포함 할 수 있어야한다.
- HTTP기반의 REST에서는 HTTP Method와 Header정보, 그리고 URI의 포함되는 정보로 표현 할 수 있다.
- GET : https://foo.co.kr/user/100 , 사용자의 정보 요청
- POST : https://foo.co.kr/user , 사용자 정보 생성
- PUT : https://foo.co.kr/user , 사용자 정보 생성 및 수정
- DELETE : https://foo.co.kr/user/100 , 사용자 정보 삭제
- 이 외에 담지 못 한 정보들은 URI의 메시지를 통해 표현한다.
- 애플리케이션 상태에 대한 엔진으로써 하이퍼미디어
- REST API를 개발할 때 단순히 Client요청에 대한 데이터만 응답 해주는 것이 아닌 관련된 리소스에 대한 Link정보까지 같이 포함 되어져야 한다.
- 현업에서 잘 지키지 않는것 → 클라이언트 개발할 때 서버의 API스펙을 보고 데이터 클래스를 만들어 mapping하게 되는데 주소 정보까지 mapping하게 되면 서버로 부터 받아오는 데이터 이외에 불필요한 정보까지 작성해야하기 때문 - 이러한 조건들을 잘 갖춘 경우 REST Ful하다고 표현하고, 이를 REST API라고 부른다.