@RequestParam: 쿼리 파라미터 및 폼 데이터를 변수에 매핑

상위 맥락

02. 요청 데이터 처리 Binding < 03. Controller 요청 처리 < 01. Spring MVC1 기초와 아키텍처 < MVC < Spring < Web

@RequestParam은 클라이언트가 보낸 쿼리 파라미터나 폼 데이터를 컨트롤러 메서드의 파라미터 변수에 매핑하는 어노테이션입니다. 과거처럼 HttpServletRequest에서 직접 getParameter()를 호출하지 않아도 됩니다.

클라이언트가 다음과 같이 요청한다고 하자.

/detail-page?code=movie-1

컨트롤러 메서드에서는 다음처럼 받을 수 있습니다.

@GetMapping("/detail-page")
public String goDetailPage(@RequestParam String code, Model model) Ellipsis

요청 파라미터 이름과 메서드 변수 이름이 같으면 @RequestParam의 name 속성을 생략할 수 있습니다. 이름이 다르면 명시적으로 지정해야 합니다.

HandlerAdapter는 컨트롤러 메서드를 호출하기 전에 메서드 시그니처를 분석합니다. @RequestParam이 있으면 HTTP 요청에서 해당 이름의 파라미터를 찾아 꺼내고, 필요한 타입으로 변환한 뒤 메서드 인자로 넣어줍니다.

@RequestParam은 기본적으로 required가 true입니다. 필수 파라미터가 누락되면 바인딩 단계에서 오류가 발생할 수 있습니다. 선택 파라미터라면 다음처럼 명시할 수 있습니다.

@RequestParam(required = false)

값이 없을 때 기본값이 필요하다면 defaultValue를 사용합니다.

@RequestParam(defaultValue = "0") int page

@RequestParam은 HTTP 요청 파라미터를 컨트롤러 메서드의 자바 변수로 직접 매핑하여 서블릿 API 의존과 반복 파싱 코드를 줄입니다.

HandlerAdapter와 함께 읽으면 좋습니다.