Spring MVC에서 `@RequestParam`을 활용한 HTTP 요청 파라미터 처리 방법

Spring MVC에서 컨트롤러 메서드에 HTTP 요청 파라미터를 전달받아 처리할 때, @RequestParam 어노테이션을 많이 사용합니다. 이 글에서는 @RequestParam을 사용하는 방법과 그 유용성을 다루고, @RequestParam Map<String, String>을 사용하여 모든 요청 파라미터를 처리하는 방법을 소개하겠습니다.

 

1. @RequestParam 기본 사용법

@RequestParam 어노테이션은 HTTP 요청 파라미터를 컨트롤러 메서드의 매개변수에 바인딩하는 데 사용됩니다. 기본적으로 @RequestParam("parameterName") 형태로 사용하며, parameterName은 요청 파라미터의 이름을 나타냅니다.

 

@PostMapping("/submit")
public String handleSubmit(@RequestParam("name") String nameValue) {
    System.out.println("Name: " + nameValue);
    return "Processed";
}

위 코드에서 @RequestParam("name")은 name이라는 이름의 HTTP 요청 파라미터를 nameValue 변수에 바인딩합니다. 예를 들어, POST /submit?name=John 요청이 들어오면 nameValue에는 "John"이 저장됩니다.

 

2. 파라미터 이름과 변수 이름이 동일할 때 생략 가능

만약 HTTP 요청 파라미터의 이름과 메서드 파라미터의 이름이 동일하다면, @RequestParam의 name 속성을 생략할 수 있습니다.

 

@PostMapping("/submit")
public String handleSubmit(@RequestParam String name) {
    System.out.println("Name: " + name);
    return "Processed";
}

이 경우, POST /submit?name=John 요청이 들어오면 name 변수에 "John"이 저장됩니다.

 

3. 기본값 설정

 

@RequestParam은 기본값을 설정할 수 있는 defaultValue 속성을 제공합니다. 만약 요청에 해당 파라미터가 없으면 기본값이 사용됩니다.

@PostMapping("/submit")
public String handleSubmit(@RequestParam(name = "name", defaultValue = "Guest") String name) {
    System.out.println("Name: " + name);
    return "Processed";
}

위 코드에서 POST /submit 요청이 들어오면 name 변수에는 "Guest"가 저장됩니다.

 

4. 모든 파라미터를 Map으로 처리하기

 

때로는 HTTP 요청에서 전달되는 모든 파라미터를 일괄적으로 처리해야 하는 경우가 있습니다. 이때 유용한 방법이 @RequestParam Map<String, String>을 사용하는 것입니다. 이 방법을 사용하면 모든 요청 파라미터가 Map의 key-value 쌍으로 저장되어 쉽게 접근할 수 있습니다.

예를 들어, 아래와 같은 요청이 있다고 가정해 봅시다:

POST /submit
Content-Type: application/x-www-form-urlencoded

param1=value1&param2=value2&param3=value3

이 요청을 처리하기 위해 다음과 같은 코드를 사용할 수 있습니다:

@PostMapping("/submit")
public String handleSubmit(@RequestParam Map<String, String> allParams) {
    allParams.forEach((key, value) -> {
        System.out.println(key + ": " + value);
    });
    return "Processed";
}

위 코드에서 allParams는 다음과 같은 구조를 가지는 Map으로 전달됩니다:

allParams = {
    "param1" -> "value1",
    "param2" -> "value2",
    "param3" -> "value3"
}

이 방법을 사용하면 모든 요청 파라미터를 쉽게 순회하며 처리할 수 있습니다. 특히, 파라미터의 개수가 동적으로 변할 수 있거나, 특정 파라미터를 일일이 지정할 수 없는 상황에서 유용합니다.

 

5. @RequestParam과 Map을 함께 사용한 장점

• 유연성: 특정 파라미터의 이름을 지정하지 않고도 모든 요청 파라미터에 접근할 수 있습니다.
• 동적 파라미터 처리: 요청 파라미터가 동적으로 변하는 경우, 미리 파라미터 이름을 알 필요 없이 모든 파라미터를 처리할 수 있습니다.
• 단순화: 여러 개의 파라미터를 개별적으로 처리하는 대신, 하나의 Map에 담아 일괄적으로 처리할 수 있어 코드가 간결해집니다.

 

6. 요약

Spring MVC에서 @RequestParam은 HTTP 요청 파라미터를 쉽게 처리할 수 있는 강력한 도구입니다. @RequestParam Map<String, String>을 사용하면 모든 파라미터를 일괄적으로 처리할 수 있어, 특정 상황에서 매우 유용합니다. 이 방법을 통해 더 유연하고 간결한 코드를 작성할 수 있습니다.

---

이 글을 통해 Spring MVC에서 @RequestParam을 활용한 다양한 요청 파라미터 처리 방법을 이해하고, 더 나아가 Map을 사용한 일괄 파라미터 처리의 유용성을 익히시기 바랍니다.