우선 @RequestParam
, @RequestBody
, @ModelAttribute
의 차이를 정확히 알아야 한다.
@RequestParam
@RequestParam
은 1개의 HTTP 요청 파라미터를 받기 위해서 사용한다.
@RequestParam
은 필수 여부가 true 이기 때문에 기본적으로 반드시 해당 파라미터가 전송되어야 한다.
해당 파라미터가 전송되지 않으면 400 error가 발생한다.
반드시 필요한 변수가 아니라면 옵션을 통해 설정해야 한다.
@RequestBody
클라이언트가 전송하는 Json(application/json) 형태의 HTTP Body 내용을 Java Object로 변환시켜주는 역할이다.
그래서 Body가 존재하지 않는 Get 메서드에서 @RequestBody
를 사용하려고 하면 에러가 발생하게 된다.
@RequestBody
로 받는 데이터는 Spring에서 관리하는 MessageConverter 중 하나인
MappingJackson2HttpMessageConverter를 통해 Java 객체로 변환한다.
@ModelAttribute
클라이언트가 전송하는 multipart/form-data 형태의 HTTP Body 내용과 HTTP 파라미터들을
Setter을 통해 1 대 1로 객체에 바인딩하기 위해 사용된다.
JSON이나 XML과 같은 형태의 데이터를 변환시키는 @RequestBody
와 달리
@ModelAttribute
는 multipart/form-data 형태의 HTTP Body와 HTTP 파라미터들을 매핑시킨다는 차이가 있다.
Create Post
SNS 개발을 위해 content(String)
와 image(MultipartFile)
를 List 형태로 받아야 하는 상황이다.
이미지는 AWS S3에 저장하며, 파일 이름과 URL을 DB에 저장한다.
방법 1: 사진을 Base64로 인코딩하여 JSON으로 전달
// DTO
public class CreatePostRequest {
private String content;
private List<String> images;
}
// Controller
@PostMapping("/posts")
public ResponseEntity<Void> create(@ModelAttribute CreatePostRequest request) {
...
}
-
Base64로 이미지를 변환하는 경우 최대 33% 까지 파일의 크기가 증대된다.
따라서 네트워크 대역 낭비가 심하다. -
Spring에서 특정 크기 이상의 데이터가 Body에 담기는 경우 요청을 해석하지 못하는 상황이 발생한다.
방법 2: 각각의 데이터를 별도로 form으로 전달
// Controller
@PostMapping("/posts")
public ResponseEntity<Void> create(@RequestParam String content,
@RequestParam List<MultipartFile> images) {
...
}
-
객체를 form을 이용해 데이터를 전달받고 데이터들을 객체로 매핑하기 위해
Spring type convertion을 이용해야 한다. -
List를 받는 경우 데이터의 논리적인 연관을 파악하기 어렵다.
방법 3: form 데이터를 하나의 객체로 전달
// DTO
public class CreatePostRequest {
private String content;
private List<MultipartFile> images;
}
// Controller
@PostMapping("/posts")
public ResponseEntity<Void> create(@ModelAttribute CreatePostRequest request) {
...
}
@ModelAttribute
를 사용하여 form data를 객체로 바로 매핑하는 방법이다.
데이터 간의 논리적인 연관관계를 표현할 수 있고,
Base64와 같이 인코딩 하지 않기 때문에 파일 사이즈가 증대되는 현상도 발생하지 않는다.