Spring MVC不使用@Valid注解如何实现自定义输入校验
你当前实现方案的问题
你的方案功能层面是可以实现需求的,但存在三个比较明显的设计缺陷:
- 领域模型污染:
@Entity类是用来映射数据库表结构的,为了表单校验新增的@Transient临时字符串字段,本质是把视图层的适配逻辑硬塞进了领域实体,长期维护会让实体类职责混乱,后续复用实体类的时候这些临时字段会造成无意义的冗余 - 重复代码量极高:每新增一个数值类型的校验字段,就要在实体类加一对临时字段、对应的getter/setter,字段多了之后代码冗余度会非常高
- 现有代码存在语法错误:控制器里写的
Person.getStrYear()、Person.setYear(...)是类静态调用的写法,根本拿不到前端传参后注入的person实例值,实际运行会直接报错
更优的无@Valid注解实现方案
完全不需要改动实体类结构,利用SpringMVC原生的自定义类型绑定扩展点,就能实现自定义校验、绕开默认的类型转换异常,核心改造逻辑如下:
1. 用@InitBinder接管字段绑定逻辑
在对应控制器(或全局的控制器增强类)中,注册针对year字段的自定义绑定规则,替代SpringMVC默认碰到非数字就直接抛异常的转换逻辑:
@InitBinder public void initYearBinder(WebDataBinder binder) { // 针对Person类的year字段,注册自定义字符串转int的规则 binder.registerCustomEditor(int.class, "year", new StringTrimmerEditor(true) { @Override public void setAsText(String text) { // 完全自定义校验逻辑,不会提前抛出类型转换异常 if (text == null || text.isBlank()) { // 空值场景处理:按业务需求设置默认值或标记错误 setValue(0); return; } // 自定义数字格式校验规则 if (!text.matches("^\\d{4}$")) { // 校验不通过时,直接向绑定结果写入错误信息 binder.getBindingResult().rejectValue("year", "year.format.error", "请输入4位有效数字的年份"); return; } // 校验通过时正常转换为int类型 setValue(Integer.parseInt(text.trim())); } }); }
校验不通过时,Spring会自动把用户输入的原始字符串存在绑定结果的错误对象中,Thymeleaf渲染表单时会自动把这个值填回输入框,不需要手动在实体类存储临时字符串字段做适配。
2. 控制器层简化校验逻辑
不需要在实体类加任何临时字段,直接通过BindingResult读取校验结果即可:
@RequestMapping(value = "/person", method = RequestMethod.POST) public ModelAndView editPerson(@ModelAttribute Person person, BindingResult bindingResult) { ModelAndView modelAndView = new ModelAndView("Person.html"); modelAndView.addObject("personBind", person); // 直接判断是否有校验错误,不需要手动写字符串转数字的逻辑 if (bindingResult.hasErrors()) { // 校验不通过:跳转回表单页,Thymeleaf会自动回显错误信息和用户输入的原始值 return modelAndView; } // 校验通过:执行业务保存逻辑 // savePerson(person); return modelAndView; }
方案优势
- 实体类完全保持原有结构,不需要新增任何临时适配字段,领域模型职责清晰
- 校验逻辑可以抽成公共工具类,所有需要数值校验的字段可以复用同一套绑定规则,没有冗余代码
- 全程不使用
@Valid注解,所有校验规则完全由自己掌控,不存在框架内置校验逻辑的黑盒 - 原生支持表单回显,校验不通过时用户输入的原始内容会保留在输入框中,不会出现空值
补充说明
如果后续校验字段越来越多,更规范的做法是单独定义一个和前端表单结构对应的请求DTO,专门用来承接前端参数、做参数校验,完全不和数据库映射的@Entity类混用。但针对你当前不想大改现有代码的场景,用@InitBinder自定义绑定的方案是改动最小、冗余最少的实现方式。
内容的提问来源于stack exchange,提问作者jkfe
相关产品推荐
相关产品推荐

