📌 스프링 MVC 파라미터 처리 완전 정복 | 1편: @RequestParam, @RequestBody 완벽 이해하기

📅 2025-04-23

📝 학습 내용

1️⃣ 스프링 파라미터 처리 개요

스프링 MVC에서는 클라이언트 요청 데이터를 컨트롤러에서 효율적으로 처리하기 위해 다양한 어노테이션을 제공합니다.

요청 방식(GET/POST)과 데이터 형태(Form, JSON 등)에 따라 적절한 방식을 선택하는 것이 핵심입니다.

처리 방식	설명	주요 어노테이션
쿼리스트링 / 폼 데이터	동기 방식, URL 또는 form 기반 전달	@RequestParam
JSON, 비동기 데이터	비동기 요청 시 사용 (Ajax 등)	@RequestBody
객체 바인딩	DTO로 파라미터 자동 매핑	@ModelAttribute
URL 경로 변수	RESTful URL에서 값 추출	@PathVariable

---

2️⃣ 주요 어노테이션 설명

✅ @RequestParam

• 용도: 쿼리스트링 또는 폼 데이터(key=value)를 변수로 매핑.
• 예시:

@GetMapping("/p02")
public void p02(@RequestParam(value = "name", required = true) String name) {
    log.info("GET/param/p02..." + name);
}

---

✅ @RequestBody

• 용도: 요청 본문(Body)의 JSON 데이터를 처리.
• 예시:

@PostMapping("/p04")
public void p04(@RequestBody String name) {
    log.info("POST/param/p04..." + name);
}

---

🔹 @RequestParam vs @RequestBody 비교

구분	@RequestParam	@RequestBody
데이터 전달 방식	쿼리스트링, 폼 데이터(Form)	요청 본문(Body)
주로 사용하는 방식	GET, POST	POST, PUT, PATCH
데이터 형태	key=value	JSON, XML, Text
예시	?name=Tom	{ "name": "Tom" }

---

✅ @ModelAttribute & @PathVariable

• 요청 데이터를 DTO로 매핑하거나, URL 경로 변수를 추출할 때 사용.
• 예시는 생략하고 다음 편에서 심화 설명 예정.

---

3️⃣ 기본 예제 코드 (주석 포함)

@GetMapping("/example")
public String example(
    @RequestParam String name,      // 쿼리스트링 또는 폼 데이터에서 'name' 추출
    @RequestBody(required = false) String jsonData,  // 요청 본문(JSON 등) 데이터 수신
    @ModelAttribute PersonDto dto,  // 파라미터를 DTO로 자동 매핑
    @PathVariable(required = false) Long id          // URL 경로 변수 추출
) {
    return "resultPage";  // 뷰 이름 반환
}

💡 TIP

• @RequestParam은 GET/POST 폼 처리에 최적화
• @RequestBody는 JSON 기반 API 설계 시 필수
• DTO 바인딩 시 @ModelAttribute를 활용하면 깔끔한 코드 작성 가능

---

🔥 요약

요청 방식과 데이터 형태에 따라 적절한 어노테이션을 선택하는 것이

스프링 파라미터 처리의 핵심이다!

• 동기 요청(Form, 쿼리스트링) ➡️ @RequestParam
• 비동기 요청(JSON) ➡️ @RequestBody
• 객체 바인딩 ➡️ @ModelAttribute
• RESTful 경로 ➡️ @PathVariable

---

🔗 참고 자료

• Spring 공식 문서 - Web MVC
• Baeldung - Spring @RequestParam
• Baeldung - Spring @RequestBody

---

느낀 점

단순한 사용법 암기보다, 언제 어떤 어노테이션을 선택해야 하는지 이해하는 것이 중요했다.

요청 데이터의 형태와 목적을 고려해 가장 효율적인 방법을 적용하는 것이 실무에서의 핵심 스킬!

---