Spring Boot @RequestParam

last modified July 16, 2023

In this article we are going to use the @RequestParam annotation in a controller to read request parameters.

Spring is a popular Java application framework and Spring Boot is an evolution of Spring which helps create stand-alone, production-grade Spring based applications easily.

Spring @RequestParam

@RequestParam is a Spring annotation used to bind a web request parameter to a method parameter.

It has the following optional elements:

Spring @RequestParam example

The following example creates a Spring Boot web application which uses @RequestParam. We have an HTML form with two tags: text input and check box. These two tags create request parameters that are read in the controller with @RequestParam.

├── main
│   ├── java
│   │   └── com
│   │       └── zetcode
│   │           ├── Application.java
│   │           └── controller
│   │               └── MyController.java
│   └── resources
│       └── static
│           └── index.html
└── test
    ├── java
    └── resources

This is the project structure of the Spring Boot application.

plugins {
    id 'org.springframework.boot' version '3.1.1'
    id 'io.spring.dependency-management' version '1.1.0'
    id 'java'

group = 'com.zetcode'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

repositories {

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-devtools'

In the the Gradle build file we have the spring-boot-starter-web, which is a starter for building web applications using Spring MVC. It uses Tomcat as the default embedded container. The spring-boot-devtools is an artifact useful when developing Spring Boot applications; it allows automatic restart or live reload of applications. The application is packaged into a JAR file.

package com.zetcode.controller;

import org.springframework.http.MediaType;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;

public class MyController {

    @RequestMapping(path="/message", produces=MediaType.TEXT_PLAIN_VALUE)
    public String processForm(@RequestParam(defaultValue="Guest") String name,
                              @RequestParam(required = false) String adult) {

        var greet = "on".equals(adult) ? "Good morning" : "Hi";

        return String.format("%s %s!", greet, name);

The controller processes the HTML form. It reads two parameters from the request.

public class MyController {

A controller class is annotated with the @Controller annotation in Spring.

@RequestMapping(path="/message", produces=MediaType.TEXT_PLAIN_VALUE)

The processForm method is mapped to the /message path and returns plain text. The @ResponseBody annotation indicates that the method return value is bound to the web response body.

public String processForm(@RequestParam(defaultValue="Guest") String name,
        @RequestParam(required = false) String adult) {

With the @RequestParam annotation, we bind the request parameter to the method variable. The defaultValue option gives a default value if the parameter is not available (the text input was left empty). The required option tells that the parameter is required. The method retuns a string.

var greet = "on".equals(adult) ? "Good morning" : "Hi";

return String.format("%s %s!", greet, name);

We build the message and return it.

<!DOCTYPE html>
<html lang="en">
        <title>Home page</title>
        <meta charset="UTF-8"/>
        <meta name="viewport" content="width=device-width, initial-scale=1.0"/>

        <form action="message">

                <input type="text" name="name">

                <label><input type="checkbox" name="adult">Adult</label>

            <button type="submit">Submit</button>


The index.html file is the home page. The file is located in the src/main/resources/static directory, where Spring Boot expects static resources such as HTML or CSS files. We have a simple HTML form with input text and check box tags.

<form action="message">

The action option contains a string that is used in controller method mapping.

package com.zetcode;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

public class Application  {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);

Application is the entry point which sets up Spring Boot application. The @SpringBootApplication annotation enables auto-configuration and component scanning.

$ ./gradlew bootRun

After the application is run, we can navigate to localhost:8080.

In this article we have created web application with Spring Boot framework. We have demonstrated the usage of @RequestParam.


My name is Jan Bodnar and I am a passionate programmer with many years of programming experience. I have been writing programming articles since 2007. So far, I have written over 1400 articles and 8 e-books. I have over eight years of experience in teaching programming.

List all Spring Boot tutorials.