쉬운 프로그래밍

REST API 본문

Programming/Spring Boot

REST API

쉬운형 2021. 1. 26. 00:47

REST는 Representational State Transfer의 약어이다.

 

하나의 URI는 하나의 고유한 Resource를 대표하도록 설계된다는 개념을 가진다.

 

에를들면 'contents/32'는 컨텐츠 중 32번이라는 고유한 의미를 가지도록 설계한다는 의미이다.

 

이에 대한 처리는 GET/POST 방식과 같이 추가적인 정보를 통해서 결정한다.

 

따라서 REST 방식은 다음과 같이 구성된다.

 

URI + GET/POST/PUT/DELETE 등

 

스프링 부트에서 REST 관련 기능을 다루는 어노테이션은 다음과 같다.

 

1. @RestController

 

@RestController는 Controller가 REST 방식을 다룬 다는 것을 명시한다.

 

REST 방식은 서버에서 순수 데이터만을 전송한다.

 

기존 Controller는 Model에 데이터를 담은 후 Thymeleaf 등과 같은 View로 전달하지만,  RestController는 순수한 데이터를 반환한다. 

 

또한, @ResponseBody를 자체 내장하고 있다.

 

 

2. @PathVariable

 

REST 방식에서는 URL 내에 최대한 많은 정보를 담고자 한다. @PathVariable 어노테이션을 이용하여 URL 경로 일부를 파라미터로 사용할 수 있다.

 

ex) http://localhost:8000/board/{bno}/page/{pno}

 

위의 URL에서 { }로 처리된 부분은 컨트롤러에서 변수로 사용이 가능하다.

 

예시 컨트롤러. 이 때 int, double 등 기본 자료형은 사용 불가

 

@GetMapping("/product/{hat}/{pid}")
public String[] getPath (@PathVariable("hat") String hat,
						 @PathVariable("pid") Integer pid) {
	
	return new String[] { "category : " + hat, "productid : " + pid };
    }

 

REST 방식의 데이터 교환에서 가장 특이한 점은 기존의 GET/POST 외에 다양한 방식으로 데이터를 전달한다는 점이다.

 

HTTP의 전송 방식은 아래와 같은 형태로 사용된다.

 

Create - POST

Read - GET

Update - PUT

Delete - DELETE

 

REST 방식의 핵심은 데이터가 URI와 결합하는 것이므로 member라는 자원이 존재할 때 전송방식을 URI와 결합하면 다음과 같은 형태가 된다.

 

등록 - POST - /members/new

조회 - GET - /members/{id}

수정 - PUT - /members/{id} + body, form태그 생각

삭제 - DELETE - /member/{id}

 

REST방식 테스트할때 Junit과 Postman 등을 사용하는 것을 생활화 해야한다.

Comments