Spring Boot Controller表单配置：如何将空数字字段默认值设为-1

针对你遇到的表单未填写时quotationCluster和quotationExclamationCluster默认传入0（而0是业务有效值）的问题，可通过以下几种方式修改默认值为-1：

方法一：修改表单实体类（CorePhrasesCreateForm） #

将字段类型从int改为Integer，并设置默认值为-1，避免基本类型int的默认0值，同时在对象初始化时就带上目标默认值：

public class CorePhrasesCreateForm {
    // 初始化默认值为-1
    private Integer quotationCluster = -1;
    private Integer quotationExclamationCluster = -1;
    
    // 其他业务字段
    private String value;
    
    // 对应的getter、setter方法
}

配合前端回显优化 #

为了让用户打开页面时输入框显示为空（而非-1），调整Thymeleaf的回显逻辑，当字段值为-1时渲染为空字符串：

<!-- quotationCluster输入框 -->
<input
    type="number"
    name="quotationCluster"
    th:value="${corePhrasesCreateForm.quotationCluster == -1 ? '' : corePhrasesCreateForm.quotationCluster}"/>

<!-- quotationExclamationCluster输入框 -->
<input
    type="number"
    name="quotationExclamationCluster"
    th:value="${corePhrasesCreateForm.quotationExclamationCluster == -1 ? '' : corePhrasesCreateForm.quotationExclamationCluster}"/>

方法二：使用@InitBinder处理参数绑定 #

如果不想修改实体类字段类型，可在Controller中注册自定义属性编辑器，直接将空字符串转换为-1，确保未填写时参数被解析为目标值：

@Controller
@RequestMapping("/your-request-path") // 替换为实际请求路径
public class CorePhrasesController {

    @InitBinder
    public void initBinder(WebDataBinder binder) {
        // 处理quotationCluster字段
        binder.registerCustomEditor(Integer.class, "quotationCluster", new PropertyEditorSupport() {
            @Override
            public void setAsText(String text) throws IllegalArgumentException {
                if (text == null || text.trim().isEmpty()) {
                    setValue(-1);
                } else {
                    setValue(Integer.parseInt(text));
                }
            }
        });

        // 处理quotationExclamationCluster字段
        binder.registerCustomEditor(Integer.class, "quotationExclamationCluster", new PropertyEditorSupport() {
            @Override
            public void setAsText(String text) throws IllegalArgumentException {
                if (text == null || text.trim().isEmpty()) {
                    setValue(-1);
                } else {
                    setValue(Integer.parseInt(text));
                }
            }
        });
    }

    // 原有的createGet、createPost方法
}

这种方式无需修改实体类，直接在参数绑定阶段处理空值转换，前端无需额外调整，空输入会被自动转为-1。

方法三：绑定后手动设置默认值 #

在Controller的POST方法中，检查字段值是否为0（或null），手动替换为-1：

@PostMapping({"/create", "/create/"})
public String createPost(@Valid CorePhrasesCreateForm corePhrasesCreateForm,
                         BindingResult bindingResult,
                         RedirectAttributes atts) {

    // 处理未填写的情况：int类型未填写默认是0，Integer类型未填写是null
    if (corePhrasesCreateForm.getQuotationCluster() == 0 || corePhrasesCreateForm.getQuotationCluster() == null) {
        corePhrasesCreateForm.setQuotationCluster(-1);
    }
    if (corePhrasesCreateForm.getQuotationExclamationCluster() == 0 || corePhrasesCreateForm.getQuotationExclamationCluster() == null) {
        corePhrasesCreateForm.setQuotationExclamationCluster(-1);
    }

    corePhraseFormValidator.validate(corePhrasesCreateForm, bindingResult);

    if (bindingResult.hasErrors()) {
        return "semantics/phrases/core/create";
    }

    atts.addAttribute("message", "Core phrases created");
    return "redirect:/general/message";
}

验证逻辑调整 #

如果你的corePhraseFormValidator中有针对这两个字段的校验规则，需确保允许0作为有效值，同时将-1视为未填写的合法状态（无需校验）。

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