Spring MVC

@RequestParam Annotation in Spring MVC with Example

In spring the @RequestParam annotation is used to bind request parameter values to the handler method arguments in controller. Let’s see use of it with example in this article.

@Target(value=PARAMETER)
@Retention(value=RUNTIME)
@Documented
public @interface RequestParam
  • defaultValue– It is String type attribute and the default value to use as a fallback when the request parameter is not provided or has an empty value.
  • name– It is String type attribute and name of the request parameter to bind to.
  • required– It is Boolean type attribute whether the parameter is required.
  • value– It is String type attribute and it is alias for name attribute.

The ‘defaultValue’ attribute of @RequestParam
It is String type attribute and the default value to use as a fallback when the request parameter is not provided or has an empty value. Providing a default value implicitly sets ‘required’ to false.

@RequestParam(defaultValue="www.dineshonjava.com") String siteName

The ‘required’ attribute of @RequestParam
It is Boolean type attribute whether the parameter is required. The default is true. If parameter is missing in the request then it will be returned status code 400. We can override this to false if the parameter is not present in the request.

Following will be mapped with both /tutorials/bookmark?siteName=dineshonjava and /tutorials/bookmark

@Controller
public class TutorialController {

    @RequestMapping(value = "/tutorials/bookmark")
    public String bookMarkTutorial (
        @RequestParam(required = false) String siteName,
              Model model) {
        model.addAttribute("I have bookmarked tutorial : " + siteName);
        return "success";
    }
}

Using @RequestParam with value and without value attribute

Using ‘value’ element of @RequestParam
It is String type attribute and it is alias for name attribute. ‘value’ attribute of @RequestParam is used to specify URL query param name. Following handler method will be mapped with the request /tutorials/bookmark?site=dineshonjava :

Controller
public class TutorialController {

    @RequestMapping(value = "/tutorials/bookmark")
    public String bookMarkTutorial (
        @RequestParam("site") String siteName,Model map) {
        model.addAttribute("I have bookmarked tutorial : " + siteName);
        return "success";
    }
}

@RequestParam without ‘value’ element
We could skip the ‘value’ attribute of @RequestParam annotation if variable name of handler method is same as request parameter name.
Following handler will be mapped with /tutorials/bookmark?siteName=dineshonjava:

@Controller
public class TutorialController {

    @RequestMapping(value = "/tutorials/bookmark")
    public String bookMarkTutorial (
        @RequestParam String siteName,
              Model model) {
        model.addAttribute("I have bookmarked tutorial : " + siteName);
        return "success";
    }
}

Using multiple @RequestParam annotations
A handler method can have any number of @RequestParam annotations, it depended on the request parameters we are passing to the handler method. Following handler will be mapped with
/tutorials/bookmark?siteName=dineshonjava&author=dinesh:

@Controller
public class TutorialController {

    @RequestMapping(value = "/tutorials/bookmark")
    public String bookMarkTutorial (
        @RequestParam String siteName,
 @RequestParam String author,
              Model model) {
        model.addAttribute("I have bookmarked tutorial : " + siteName+" Author : "+author);
        return "success";
    }
}

Using Map with @RequestParam for multiple params
Spring provide support for bind the request parameters to the Map and MultiValueMap. All query string names and values are populated to the Map. Following will be mapped with /tutorials/bookmark?siteName=dineshonjava&author=dinesh:


@Controller
public class TutorialController {

    @RequestMapping(value = "/tutorials/bookmark")
    public String bookMarkTutorial (
        @RequestParam Map queryMap
              Model model) {
        model.addAttribute("I have bookmarked tutorial : " + queryMap.get("siteName")+
 " Author : "+queryMap.get("author"));
        return "success";
    }
}

Summary
In Spring @RequestParam annotation we can use for bind the request parameters to the handler method arguments. It provides auto-type conversion by default for parameters like int, float, String, Date etc. We can also override the default behavior of this annotation like required attribute set false to non mandatory request parameters.

Previous
Next
Dinesh Rajput

Dinesh Rajput is the chief editor of a website Dineshonjava, a technical blog dedicated to the Spring and Java technologies. It has a series of articles related to Java technologies. Dinesh has been a Spring enthusiast since 2008 and is a Pivotal Certified Spring Professional, an author of a book Spring 5 Design Pattern, and a blogger. He has more than 10 years of experience with different aspects of Spring and Java design and development. His core expertise lies in the latest version of Spring Framework, Spring Boot, Spring Security, creating REST APIs, Microservice Architecture, Reactive Pattern, Spring AOP, Design Patterns, Struts, Hibernate, Web Services, Spring Batch, Cassandra, MongoDB, and Web Application Design and Architecture. He is currently working as a technology manager at a leading product and web development company. He worked as a developer and tech lead at the Bennett, Coleman & Co. Ltd and was the first developer in his previous company, Paytm. Dinesh is passionate about the latest Java technologies and loves to write technical blogs related to it. He is a very active member of the Java and Spring community on different forums. When it comes to the Spring Framework and Java, Dinesh tops the list!

Share
Published by
Dinesh Rajput

Recent Posts

Strategy Design Patterns using Lambda

Strategy Design Patterns We can easily create a strategy design pattern using lambda. To implement…

2 years ago

Decorator Pattern using Lambda

Decorator Pattern A decorator pattern allows a user to add new functionality to an existing…

2 years ago

Delegating pattern using lambda

Delegating pattern In software engineering, the delegation pattern is an object-oriented design pattern that allows…

2 years ago

Spring Vs Django- Know The Difference Between The Two

Technology has emerged a lot in the last decade, and now we have artificial intelligence;…

2 years ago

TOP 20 MongoDB INTERVIEW QUESTIONS 2022

Managing a database is becoming increasingly complex now due to the vast amount of data…

2 years ago

Scheduler @Scheduled Annotation Spring Boot

Overview In this article, we will explore Spring Scheduler how we could use it by…

3 years ago