How to Handle Form Data in Spring Boot: Simple Guide

In Spring Boot, you handle form data by using @ModelAttribute to bind form fields to a Java object or @RequestParam to get individual form values. The form data is sent via POST, and your controller method processes it by accepting these parameters.

Why This Happens

When you try to handle form data without proper annotations or parameter setup, Spring Boot cannot bind the form fields to your method parameters. This causes errors like missing parameters or empty objects.

java

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;

@Controller
public class UserController {

    @PostMapping("/submit")
    public String submitForm(@ModelAttribute User user) {
        // Added @ModelAttribute to enable binding
        System.out.println(user);
        return "result";
    }
}

public class User {
    private String name;
    private int age;

    // getters and setters
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

Output

HTTP 400 Bad Request or User object fields are null because Spring can't bind form data without @ModelAttribute.

The Fix

Add @ModelAttribute to the method parameter to tell Spring Boot to bind form data to the object. Alternatively, use @RequestParam for individual fields.

java

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
public class UserController {

    @PostMapping("/submit")
    public String submitForm(@ModelAttribute User user) {
        System.out.println("Name: " + user.getName());
        System.out.println("Age: " + user.getAge());
        return "result";
    }

    // Or handle individual fields
    @PostMapping("/submitSingle")
    public String submitSingle(@RequestParam String name, @RequestParam int age) {
        System.out.println("Name: " + name);
        System.out.println("Age: " + age);
        return "result";
    }
}

public class User {
    private String name;
    private int age;

    // getters and setters
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

Output

Console prints submitted form data correctly, e.g., Name: Alice, Age: 30

Prevention

Always use @ModelAttribute for binding form data to objects and @RequestParam for single fields. Validate your form inputs and use Spring's validation annotations to catch errors early. Keep your form field names matching your object property names.

Related Errors

Common related errors include:

• HTTP 400 Bad Request: Happens when required form fields are missing or types mismatch.
• Binding errors: Occur if form field names don't match object properties.
• NullPointerException: When you try to use form data without proper binding.

Fix these by checking your form field names, adding @ModelAttribute, and validating inputs.

Key Takeaways

Use @ModelAttribute to bind form data to Java objects in Spring Boot controllers.

Use @RequestParam to get individual form fields when you don't need an object.

Ensure form field names match your object's property names exactly.

Validate form data to prevent binding and type errors.

Always annotate controller parameters properly to avoid HTTP 400 errors.