43. HTTP 요청 파라미터 @RequestParam

스프링이 제공하는 @RequestParam을 사용하면 요청 파라미터를 매우 편리하게 사용할 수 있다.

 

 @ResponseBody
    @RequestMapping("/request-param-v2")
    public String requestParamV2(
        @RequestParam("username") String memberName,
        @RequestParam("age") int memberAge){

        log.info("username={}, age={}",memberName,memberAge);
        return"ok";
    }

@RequestParam : 파라미터 이름으로 바인딩

@ResponseBody : View조회를 무시하고, HTTP message body에 직접 해당 내용 입력

 

@RequestParam의 name(value) 속성이 파라미터 이름으로 사용

@RequestParma("username") String memberName

 -> request.getParameter("username")

@ResponseBody
    @RequestMapping("/request-param-v3")
    public String requestParamV3(
            @RequestParam String username,
            @RequestParam int age){

        log.info("username={}, age={}",username ,age);
        return"ok";
    }

    @ResponseBody
    @RequestMapping("/request-param-v4")
    public String requestParamV4(String username, int age){
        log.info("username={}, age={}",username ,age);
        return"ok";
    }

위의 코드에서 더 간편하게 하기위한 과정이다.

v3에서는 HTTP 파라미터 이름이 변수 이름과 같으면 @RequestParam(name="")생략이 가능하다.

v4에서는 String,int ,Integer등의 단순 타입이면 @RequestParam도 생략가능하다.

 

@RequestParam 애노테이션을 생략하면 스프링MVC는 내부에서 required=false를 적용한다.

 

이렇게 애노테이션을 완전히 생략해도 되는데, 너무 없는 것도 과할 수 있다.

@RequestParam이 있으면 명확하게 요청 파라미터에서 데이터를 읽는다는 것을 알 수 있다.

    @ResponseBody
    @RequestMapping("/request-param-required")
    public String requestParamRequired(
            @RequestParam(required = false) String username,
            @RequestParam(required = false)  Integer age){
        log.info("username={}, age={}",username ,age);
        return"ok";
    }

@RequestParam.required

파라미터 필수 여부

기본값이 파라미터 필수(true)이다.

 

/request-param 요청

username이 없으므로 400 예외가 발생한다.

 

주의! - 파라미터 이름만 사용

/request-param?username=

파라미터 이름만 있고 값이 없는 경우 -> 빈문자로 통과

 

주의! - 기본형에 null 입력

/request-param 요청

@RequestParam( required = false) int age

 

null을 int에 입력하는 것은 불가능(500예외 발생)

따라서 null을 받을 수 있는 Integer로 변경하거나, 또는 defaultValue 사용

 

@ResponseBody
    @RequestMapping("/request-param-default")
    public String requestParamDefault(
            @RequestParam(required = true, defaultValue = "guest") String username,
            @RequestParam(required = false, defaultValue = "-1")  int age){
        log.info("username={}, age={}",username ,age);
        return"ok";
    }

파라미터에 값이 없는 경우 defaultValue 를 사용하면 기본 값을 적용할 수 있다.

이미 기본 값이 있기 때문에 required 는 의미가 없다.

 

defaultValue 는 빈 문자의 경우에도 설정한 기본 값이 적용된다.

/request-param?username=

 

 @ResponseBody
    @RequestMapping("/request-param-map")
    public String requestParamMap(@RequestParam Map<String, Object> paramMap){
        log.info("username={}, age={}",paramMap.get("username"),paramMap.get("age"));
        return"ok";
    }

파리미터를 Map, MultiValueMap으로 조회할 수 있다.

 

@RequestParam Map

  Map(key = value)

 

@RequestParam MultiValueMap

  MultiValueMap(key=[value1, value2, ...] ex) {key=uesrIds, value=[id1, id2])

 

파라미터의 값이 1개가 확실하다면 Map을 사용해도 되지만, 그렇지 않다면 MultiValueMap을 사용하자