Hey there, let's tackle this issue where your Spring MVC app is returning null when trying to fetch a HashSet from checkboxes. I've been in this spot before, so let's break it down step by step to get it working.

The most common reason for null here is that your HashSet property isn't initialized. Spring needs an existing collection instance to populate the selected checkbox values—if it's null, Spring can't magically create it for you.

Here's how to set it up correctly:

public class YourFormEntity {
    // Initialize the HashSet directly so it's never null
    private HashSet<String> selectedItems = new HashSet<>();

    // Don't forget the getter and setter—Spring relies on these for data binding
    public HashSet<String> getSelectedItems() {
        return selectedItems;
    }

    public void setSelectedItems(HashSet<String> selectedItems) {
        this.selectedItems = selectedItems;
    }
}

Your checkbox names must match the property name in your entity exactly (case-sensitive!). You can use Spring's form tags for easier binding, or plain HTML—either works as long as the name is correct.

Using Spring Form Tags (Recommended) #

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

<form:form modelAttribute="yourFormEntity" method="post" action="/submit-form">
    <!-- Loop through your available options (passed from controller) -->
    <c:forEach items="${availableOptions}" var="option">
        <form:checkbox path="selectedItems" value="${option}" label="${option}" />
        <br>
    </c:forEach>
    <button type="submit">Submit</button>
</form:form>

Using Plain HTML #

If you prefer plain HTML, make sure the name attribute matches your entity's property name:

<form method="post" action="/submit-form">
    <c:forEach items="${availableOptions}" var="option">
        <input type="checkbox" name="selectedItems" value="${option}" />
        <label>${option}</label>
        <br>
    </c:forEach>
    <button type="submit">Submit</button>
</form:form>

Use @ModelAttribute to bind the form data directly to your entity, or @RequestParam if you want to handle the collection separately.

Option 1: Bind to Entity (Cleanest) #

@Controller
public class FormController {

    // Serve the form page, and pass an initialized entity + options
    @GetMapping("/form")
    public String showForm(Model model) {
        YourFormEntity formEntity = new YourFormEntity();
        List<String> availableOptions = Arrays.asList("Option A", "Option B", "Option C");
        
        model.addAttribute("yourFormEntity", formEntity);
        model.addAttribute("availableOptions", availableOptions);
        return "your-form-page";
    }

    // Handle form submission
    @PostMapping("/submit-form")
    public String processForm(@ModelAttribute("yourFormEntity") YourFormEntity formEntity) {
        // selectedItems will NEVER be null here—we initialized it in the entity!
        if (formEntity.getSelectedItems().isEmpty()) {
            // Handle case where no checkboxes were selected
            System.out.println("No items selected");
        } else {
            System.out.println("Selected items: " + formEntity.getSelectedItems());
        }
        return "result-page";
    }
}

Option 2: Use @RequestParam Directly #

If you don't want to use an entity, you can grab the collection directly—just remember to mark it as required=false (since no selected checkboxes means the parameter won't be sent):

@PostMapping("/submit-form")
public String processForm(@RequestParam(value = "selectedItems", required = false) HashSet<String> selectedItems) {
    // If no checkboxes were selected, selectedItems will be null—so initialize it here
    if (selectedItems == null) {
        selectedItems = new HashSet<>();
    }
    System.out.println("Selected items: " + selectedItems);
    return "result-page";
}

• Forgetting to initialize the HashSet: As mentioned earlier, this is the #1 cause of null values. Always initialize the collection in your entity.
• Mismatched checkbox names: Double-check that the name attribute in your JSP exactly matches the property name in your entity (case-sensitive!).
• Ignoring unselected checkboxes: If no checkboxes are selected, the browser won't send the parameter at all. Initializing the collection in your entity fixes this automatically.

内容的提问来源于stack exchange，提问作者Aby