@ModelAttribute
실제 개발을 하면 요청 파라미터를 받아서 필요한 객체를 만들고 그 객체에 값을 넣어주어야 한다. 보통 다음과 같이 코드를 작성할 것이다.
@RequestParam String username;
@Request int age;
HelloData data = new HelloData();
data.setUsername(username);
data.setAge(age);
스프링은 이 과정을 완전히 자동화해주는 '@ModelAttribute'기능을 제공한다.
롬복 @DATA
- @Getter, @Setter, @ToString, @EqualsAndHashCode, @RequiredArgsConstructor 를 자동으로 적용해준다.
ModelAttribute 적용 - modelAttribute v1
@ResponseBody
@RequestMapping("/model-attribute-v1")
public String modelAttributeV1(@ModelAttribute HelloData helloData) {
log.info("username={}, age={}", helloData.getUsername(), helloData.getAge());
return "ok";
}
마치 마법처럼 'HelloData'객체가 생성되고, 요청 파라미터의 값도 모두 들어가 있다.
스프링 MVC는 '@ModelAttribute'가 있으면 다음을 실행한다.
- 'HelloData' 객체를 생성한다
- 요청 파라미터의 이름으로 'HelloData'객체의 프로퍼티를 찾는다. 그리고 해당 프로퍼티의 setter를 호출해서 파라미터의 값을 입력(바인딩)한다.
- 예) 파라미터 이름이 'username'이면 'setUsername()'메서드를 찾아서 호출하면서 값을 입력한다.
'@ModelAttribute'는 생략할 수 있다.
그런데 '@RequestParam'도 생략할 수 있으니 혼란이 발생할 수 있다.
스프링은 해당 생략시 다음과 같은 규칙을 적용한다.
- 'String', 'int', 'Integer' 같은 단순 타입 = '@RequestParam'
- 나머지 = '@ModelAttribute' (argument resolver로 지정해둔 타입 외)
단순 텍스트
- HTTP message body에 데이터를 직접 담아서 요청
- HTTP API에서 주로 사용, JSON, XML, TEXT
- 데이터 형식은 주로 JSON 사용
- POST, PUT, PATCH
요청 파라미터와 다르게, HTTP 메시지 바디를 통해 데이터가 직접 넘어오는 경우는 '@RequestParam', '@ModelAttribute'를 사용할 수 없다. (물론 HTML Form 형식으로 전달되는 경우는 요청 파라미터로 인정된다)
스프링 MVC는 다음 파라미터를 지원한다
- HttpEntity: HTTP header, body 정보를 편리하게 조회
-메시지 바디 정보를 직접 조회
-요청 파라미터를 조회하는 기능과 관계없음 '@RequestParam'X,'@ModelAttribute'X
- HttpEntity는 응답에도 사용 가능
-메시지 바디 정보 직접 반환
-헤더 정보 포함 가능
-view 조회X
***'HttpEntity'를 상복 받은 다음 객체들도 같은 기능을 제공한다.
- RequestEntity
-HttpMethod, url 정보가 추가, 요청에서 사용
- ResponseEntity
-HTTP 상태 코드 설정 가능, 응답에서 사용
-return new ResponseEntity<String>("Hello World",reponseHeaders,HttpStatus.Created)
@RequestBody, @ResponseBody
@RequestBody
'@RequestBody'를 사용하면 HTTP 메시지 바디 정보를 편리하게 조회할 수 있다. 참고로 헤더 정보가 필요하다면 'HttpEntity'를 사용하거나 '@RequestHeader'를 사용하면 된다. 이렇게 메시지 바디를 직접 조회하는 기능은 요청 파라미터를 조회하는 '@RequestParam', '@ModelAttribute'와는 전혀 관계가 없다.
@ResponseBody
- @ResponseBody를 사용하면 응답 결과를 HTTP 메시지 바디에 직접 담아 전달할 수 있다. 물론 이 경우에도 view를 사용하지 않는다
요청 파라미터 vs HTTP 메시지 바디
- 요청 파라미터를 조회하는 기능: '@RequestParam', '@ModelAttribute'
- HTTP 메시지 바디를 직접 조회하는 기능: 'RequestBody'