REST API / REST란 / RESTful

REST란?

Representational State Transfer

자원을 이름으로 구분하여 해당 자원의 상태를 주고 받는 모든 것을 의미한다.

 

 

① URI를 통해 자원을 명시하고

② HTTP Method(GET, PUT, POST, DELETE)를 통해

③ 해당 자원(URI)에 대한 CRUD operatoin을 적용하는 것을 의미한다.

 

 

 

 

 

 

REST API

REST기반으로 서비스 API를 구현하는 것.

자원에 대한 행위는 HTTP Method로 표현한다.

 

 

 

설계 기본 규칙

1. URI는 동사보다는 명사를, 대문자보다는 소문자를 사용하여야 한다.

2. 마지막에 슬래시(/)를 포함하지 않는다.

3. 언더바 대신 하이픈을 사용한다.

4. 파일 확장자는 URI에 포함하지 않는다.

5. 행위를 포함하지 않는다. (get, put, post, delete등)

 

 

 

Rest API를 제공하는 웹 서비스를 RESTful하다고 할 수 있다.

 

 

 

 

REST 관련 Annotation

 

@RestController : Controller가 REST 방식을 처리하기 위한 것임을 명시

@ResponseBody : JSP 같은 뷰로 전달되는 것이 아니라 데이터 자체 전달

@PathVariable : URL 경로에 있는 값을 파라미터로 추출

@CrossOrigin : Ajax의 크로스 도메인 문제를 해결

@RequestBody : JSON 데이터를 원하는 타입으로 바인딩