@RequestParam, @ModelAttribute, @RequestBody의 차이는?

[ahah525]

문제

강의에서 배웠던 1)HTTP 요청 데이터 전달 방법 3가지를 기반으로 2)@RequestParam, @ModelAttribute, @RequestBody 어노테이션의 차이/언제 사용하는지에 대해 정리해보자.

관련 섹션

• MVC1 section 6

[ahah525]

💡HTTP 요청 데이터 전달 방법 3가지

1. 쿼리 파라미터 : GET

URL의 쿼리 파라미터에 데이터를 포함해서 전달하는 방식이다.

- 요청 URL: http://localhost:8080?username=hello&age=20

2. HTML Form : POST

메시지 바디에 쿼리 파리미터 형식으로 데이터를 전달하는 방식이다.

- 요청 URL: http://localhost:8080/request-param
- content-type: application/x-www-form-urlencoded
- message body: username=hello&age=20

3. HTTP 메시지 바디 : POST, PUT, PATCH

메시지 바디에 JSON, XML, TEXT 형식의 데이터를 직접 담아서 전달하는 방식이다.

- 요청 URL: http://localhost:8080/request-json
- content-type: application/json
- message body: {"username": "hello", "age": 20}

💡@RequestParam, @ModelAttribute, @RequestBody의 차이

1. @RequestParam → 1, 2번 처리 방법

1개의 HTTP 요청 파라미터를 맵핑한다.

• 기본으로 required=false로 설정되어, 전송되지 않으면 400 에러가 발생한다.

2. @ModelAttribute → 1, 2번 처리 방법

HTTP Body나 요청 파라미터들을 Java 객체에 맵핑한다.

• Query String, Form 데이터만 처리할 수 있다.
• 객체는 필드를 바인딩할 생성자 혹은 기본 생성자 + setter 메서드가 필요하다.
  • 기본 생성자가 있으면 인스턴스를 우선 생성하고, setter 메서드로 바인딩을 시도한다.

3. @RequestBody → 3번 처리 방법

HTTP 요청 Body(JSON, XML 등)을 HttpMessageConverter를 통해 Java 객체로 변환한다.

• 내부적으로 ObjectMapper를 통해 JSON 값을 Java 객체로 역직렬화한다.
  • 역직렬화를 하기 위해 기본 생성자가 필요하다.
  • 바인딩을 위해 필드명을 알아 내려면, getter나 setter 중 1가지는 정의되어 있어야 한다.
    • getter나 setter 메서드가 모두 정의되어있지 않으면, HttpMessageNotWritableException 예외가 발생한다.

📍역직렬화

생성자를 거치지 않고 리플렉션을 통해 객체를 구성하는 메커니즘

📍Reflection(리플렉션)

구체적인 클래스 타입을 알지 못해도 그 클래스의 메서드, 타입, 변수들에 접근할 수 있도록 해주는 자바 API

• 객체 생성, 메서드 호출, 필드값 조회 및 설정
• e.g. 스프링의 Dependency Injection, Jackson 라이브러리의 ObjectMapper

Reference

• 신입 개발자 기술면접 질문 정리 - 백엔드
• [HTTP] Request 요청 데이터를 전달하는 방법
• [우아한테크코스] 기본 생성자가 필요한 이유 (Why the default constructor is needed) (feat. Jackson ObjectMapper + Reflection)
• @RequestBody vs @ModelAttribute*
• 스프링 ModelAttribute 데이터 바인딩 과정 이해하기
• 자바 리플렉션 (Reflection) 기초
• @ModelAttribute을 setter 없이 사용할 수 있는 이유*
• Spring MVC - @ModelAttribute의 장점(@RequestParam와 @ModelAttribute)