当前位置：首页 > news >正文

SpringBoot中使用表单数据有效性检验

news 来源：原创 2025/6/24 6:43:06

在SpringBoot里使用服务器端的数据校验和单独使用SpringMVC中的数据校验采用的是一样的技术JSR303这个规范的实现产品Hibernate-Validate。

一、JSR-303简介

JSR-303只是一个规范，而Spring也没有对这一规范进行实现，那么当我们在SpringMVC中使用JSR-303的时候就需要我们提供一个对JSR-303规范的实现，Hibernate Validator就是实现了这一规范的具体框架。

JSR-303的校验是基于注解的，它内部已经定义好了一系列的限制注解，我们只需要把这些注解标记在需要验证的实体类的属性上或是其对应的get方法上。

二、JSR 303 基本的校验规则

空检查

@Null 验证对象是否为null

@NotNull 验证对象是否不为null, 无法查检长度为0的字符串

@NotBlank 检查约束字符串是不是Null还有被Trim后的长度是否大于0,只对字符串,且会去掉前后空格.

@NotEmpty 检查约束元素是否为NULL或者是EMPTY.

Booelan检查

@AssertTrue 验证 Boolean 对象是否为 true

@AssertFalse 验证 Boolean 对象是否为 false

长度检查

@Size(min=, max=) 验证对象（Array,Collection,Map,String）长度是否在给定的范围之内

@Length(min=, max=) Validates that the annotated string is between min and max included.

日期检查

@Past 验证 Date 和 Calendar 对象是否在当前时间之前，验证成立的话被注释的元素一定是一个过去的日期

@Future 验证 Date 和 Calendar 对象是否在当前时间之后，验证成立的话被注释的元素一定是一个将来的日期

@Pattern 验证 String 对象是否符合正则表达式的规则，被注释的元素符合制定的正则表达式，regexp:正则表达式 flags: 指定 Pattern.Flag 的数组，表示正则表达式的相关选项。

数值检查

建议使用在Stirng,Integer类型，不建议使用在int类型上，因为表单值为“”时无法转换为int，但可以转换为Stirng为”“,Integer为null

@Min 验证 Number 和 String 对象是否大等于指定的值

@Max 验证 Number 和 String 对象是否小等于指定的值

@DecimalMax 被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度

@DecimalMin 被标注的值必须不小于约束中指定的最小值. 这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度

@Digits 验证 Number 和 String 的构成是否合法

@Digits(integer=,fraction=) 验证字符串是否是符合指定格式的数字，interger指定整数精度，fraction指定小数精度。

@Range(min=, max=) 被指定的元素必须在合适的范围内

@Range(min=10000,max=50000,message=”range.bean.wage”)

@Valid 递归的对关联对象进行校验, 如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证)

@CreditCardNumber信用卡验证

@Email 验证是否是邮件地址，如果为null,不进行验证，算通过验证。

@ScriptAssert(lang= ,script=, alias=)

@URL(protocol=,host=, port=,regexp=, flags=)

三、具体操作步骤

（1）SpringBoot已经将相关的jar包整合进来了，不用我们自己导入jar包了

（2）在JavaBean的属性上加验证注解。

@Entity
@Table(name = "t_users")
public class User {private int id;@NotEmptyprivate String username;@NotEmptyprivate String pasword;

（3）在Controller的处理方法上的参数前，加@Valid注解，增加出错后，错误信息放置的对象参数Errors/BindingResult errorrs。

（4）前面把错误信息带回了添加页面，显示出来，前面讲异常处理的时候，已经说了回显的异常信息会放到errors变量里注入视图

<form th:action="@{/adduser.html}" method="post">用户名：<input type="text" name="username" /><span style="color: red;" th:errors="${user.username}">ss</span><br><br>用户密码：<input type="text" name="pasword" /><span style="color: red;" th:errors="${user.password}"></span><br><br>选中用户地址：<select name="address.id"><option th:value="${address.id}"  th:each="address:${addresses}">[[${address.addressInfo}]]</option></select><br><br><input type="submit" th:value="添加" />
</form>