SpringBoot中使用注解对实体类中的属性进行校验

您所在的位置：网站首页 › fastjson字段长度限制 › SpringBoot中使用注解对实体类中的属性进行校验

SpringBoot中使用注解对实体类中的属性进行校验

2024-06-14 19:12| 来源: 网络整理| 查看: 265

☠️每日毒鸡汤：这个社会是存在不公平的，不要抱怨，因为没有用！人总是在反省中进步的！

👋大家好！我是你们的老朋友Java学术趴。

2.5 实体类参数校验2.5.1 验证注解介绍SpringBoot中提供了可以给实体类上的参数加入校验，对于前端请求的数据进行校验。比如数据的长度、格式、类型、是否为空等等，如果没有通过校验直接报错，大大的减少了在代码中使用if...else进行判断以及防止脏数据对数据库的影响。只要当验证的返回值为false，就直接报错，不会在往下执行。

常用的验证注解

注意：这来要也别注意一下 @NotNull、@NotNull、@NotBlank以及@NotEmpty注解的区别

@NotNull ：传递的所有对象都不能是null，其他的不保证。@NotNull : CharSequence, Collection, Map 和 Array 对象不能是 null, 但可以是空集（size = 0）@NotEmpty : CharSequence, Collection, Map 和 Array 对象不能是 null 并且相关对象的 size 大于 0@NotBlank : 这个注解针对的 String 类型，String 不是 null 且去除两端空白字符后的长度大于 0。代码语言：javascript复制空检查 @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=) 验证注解的元素值长度在min和max区间内日期检查 @Past 验证 Date 和 Calendar 对象是否在当前时间之前 @Future 验证 Date 和 Calendar 对象是否在当前时间之后 @Pattern 验证 String 对象是否符合正则表达式的规则数值检查，建议使用在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") private BigDecimal wage; @Valid 递归的对关联对象进行校验, 如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证) @CreditCardNumber信用卡验证 @Email 验证是否是邮件地址，如果为null,不进行验证，算通过验证。 @ScriptAssert(lang= ,script=, alias=) @URL(protocol=,host=, port=,regexp=, flags=) @Constraint ：指定自定义注解逻辑类，使用的是反射机制 Class.class

使用这个验证直接的时候，需要在 pom.xml 中加入依赖

代码语言：javascript复制 jakarta.validation jakarta.validation-api 2.5.2 @@Validated和@Valid的区别

为什么要使用这两个注解，

因为在前端传递过来数据可能是大量的数据或者是一个对象，这样如果一个一个的手写注解验证非常的麻烦，此时就需要使用到这两个注解，这两个注解会递归的将对象中的每个实体类属性进行校验，当所有验证成功的时候才会向下执行。

这两个注解的区别：

所属的包不同： @Valid属于javax.validation包下,是jdk给提供的。@Validated是org.springframework.validation.annotation包下的,是spring提供的。 @Validated要比@Valid更加强大 @Validated在@Valid之上提供了分组功能和验证排序功能

使用方式：

代码语言：javascript复制@RestController @Slf4j public class VerifyController { @PostMapping(value = "/valid") public void verifyValid(@Validated @RequestBody Person person) { // ... } }2.5.3 基本使用方式

第一步：创建一个实体类

代码语言：javascript复制import lombok.Data; import org.hibernate.validator.constraints.Length; import org.hibernate.validator.constraints.Range; import javax.validation.constraints.*; import java.io.Serializable; import java.util.List; /** * @Description TODO PersonBean * @Author Java学术趴 * @可以自己在每个实体类上随意的添加校验注解 */ @Data public class PersonBean implements Serializable { private static final long serialVersionUID = -8374325179529529802L; /** * 年龄 */ @Range(min = 1, max = 99, message = "年龄必须在1~99之间") private Integer personAge; /** * 姓名 */ @Length(min = 5, max = 10, message = "用户名长度必须在5~10之间") private String personName; /** * 密码 */ @Length(min = 5, max = 10, message = "密码长度必须在5~10之间") @NotBlank(message = "密码不能为空") private String password; /** * 手机号 */ @Pattern(regexp = "^[1]([3][0-9]{1}|59|58|88|89)[0-9]{8}$", message = "手机号格式有误") @Length(min = 11, max = 11, message = "手机号必须为11位") private String personPhone; /** * 邮箱 */ @Email(message = "邮箱格式有误") private String personEmail; /** * 资产 */ @Pattern(regexp = "^(([1-9]{1}\d*)|([0]{1}))(\.(\d){0,2})?$", message = "金额有误！必须是数字且最多保留两位小数") private String personMoney; /** * 照片 */ @Size(min = 1, max = 3, message = "集合长度的范围为1~3") @NotEmpty(message = "集合不能为空") private List photoList; }

第二步：Controller

代码语言：javascript复制@RestController @RequestMapping("/person") @Validated public class PersonController { @GetMapping("/get") public DataResult get(@Range(max = 10, message = "age最大值为10") @RequestParam("age") Integer age,@NotBlank(message = "name不可以为空") @Length(min = 3, message = "name长度最少是3") @RequestParam("name") String name) { return DataResult.success(); } @PostMapping("/post") public DataResult post(@Validated @RequestBody PersonBean person) { return DataResult.success(); } }

解释：

分别校验：如果是get请求的单个参数校验，那么在Controller类上加上 @Validated注解，之后直接在参数前加上相应的注解校验即可。也就是其中的 get 方法。批量校验：如果是 post请求的一个对象，那么此时我们需要使用 @Validated注解进行批量校验，因为在实体类中已经给属性加入了相应的验证注解，所以他会使用递归的方式进行逐一的校验。2.5.3 修改参数校验模式SpringBoot默认的是对所有的实体类属性进行验证，之后才会抛出异常，这样效率就会变低，但是其实只要有一个验证失败，那么就代表这个请求失败，直接拒绝这个请求，所以我们创建一个配置类，完成一种新的校验模式：

这个配置文件可以直接复制粘贴到代码中使用。

代码语言：javascript复制import org.hibernate.validator.HibernateValidator; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import javax.validation.Validation; import javax.validation.Validator; import javax.validation.ValidatorFactory; /** * @Description TODO 配置Springboot校验模式 * @Author Java学术趴 */ @Configuration public class ValidatorConfig { /** * validation默认会校验完所有字段，然后返回所有的验证失败信息。 * 可以通过一些简单的配置，开启Fail Fast模式，只要有一个验证失败就立即返回 */ @Bean public Validator validator() { ValidatorFactory validatorFactory = Validation .byProvider(HibernateValidator.class) .configure() .failFast(true) .buildValidatorFactory(); Validator validator = validatorFactory.getValidator(); return validator; } }2.5.4 定义全局异常拦截，将异常中重要信息返回给前端。如果注解校验失败后端直接抛出异常的，并不会给前端返回任何的数据，我们如果想要返回自定义的验证失败信息就需要再配置下全局异常监听。代码语言：javascript复制/** * @Description TODO 全局异常管理 * @Author admin * @Date 2020/12/11 */ import com.lgy.demo.util.DataResult; import org.springframework.validation.FieldError; import org.springframework.web.bind.MethodArgumentNotValidException; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; import javax.validation.ConstraintViolation; import javax.validation.ConstraintViolationException; import java.util.*; @RestControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(value = MethodArgumentNotValidException.class) public DataResult validateException(MethodArgumentNotValidException e) { List fieldErrors = e.getBindingResult().getFieldErrors(); List list = new ArrayList(); for (FieldError error : fieldErrors) { list.add(error.getField() + error.getDefaultMessage()); } return DataResult.custom(500, "参数有误！", list.get(0)); } @ExceptionHandler(value = ConstraintViolationException.class) public DataResult validateException(ConstraintViolationException e) { Set[] groups() default {}; Class

【本文地址】

SpringBoot中使用注解对实体类中的属性进行校验

SpringBoot中使用注解对实体类中的属性进行校验

今日新闻

推荐新闻