SpringBoot参数校验

为什么需要参数校验

在日常的接口开发中，为了防止非法参数对业务造成影响，经常需要对接口的参数进行校验，例如登录的时候需要校验用户名和密码是否为空，添加用户的时候校验用户邮箱地址、手机号码格式是否正确。靠代码对接口参数一个个校验的话就太繁琐了，代码可读性极差。

@RestController
@RequestMapping("/user")
public class UserController {

    @PostMapping("add")
    public ResponseEntity<String> add(User user) {
        if(user.getName()==null) {
            return ResponseResult.fail("user name should not be empty");
        } else if(user.getName().length()<5 || user.getName().length()>50){
            return ResponseResult.fail("user name length should between 5-50");
        }
        if(user.getAge()< 1 || user.getAge()> 150) {
            return ResponseResult.fail("invalid age");
        }
        // ...
        return ResponseEntity.ok("success");
    }
}

Validator框架就是为了解决开发人员在开发的时候少写代码，提升开发效率；Validator专门用来进行接口参数校验，例如常见的必填校验，email格式校验，用户名必须位于6到12之间等等...

Validator校验框架遵循了JSR-303验证规范（参数校验规范）, JSR是 Java Specification Requests的缩写。

hibernate validation是对这个规范的实现，并增加了校验注解如@Email、@Length等。

Spring Validation是对hibernate validation的二次封装，用于支持spring mvc参数自动校验。

Spring Validation的使用

引入依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

注：从 springboot-2.3开始，校验包被独立成了一个 starter组件，所以需要引入validation和web，而 springboot-2.3之前的版本只需要引入 web 依赖就可以了。

请求参数封装

@Data
@ApiModel(value = "User")
public class User {

    private String userId;

    @NotEmpty(message = "不能为空")
    @Email(message = "邮箱格式不正确")
    private String email;

    @NotEmpty(message = "不能为空")
    @Pattern(regexp = "^(\\d{6})(\\d{4})(\\d{2})(\\d{2})(\\d{3})([0-9]|X)$", message = "身份证不合法")
    private String cardNo;

    @NotEmpty(message = "不能为空")
    @Length(min = 1, max = 10, message = "昵称不得超过10个字符")
    private String nickName;

    @NotEmpty(message = "不能为空")
    @Range(min = 0, max = 1, message = "性别代码为0或1")
    private int sex;

    @Max(value = 100, message = "请输入合法年龄")
    private int age;

}

Controller中获取参数绑定结果

使用@Valid或者@Validated注解，参数校验的值放在BindingResult中

@Slf4j
@RestController
@RequestMapping("/user")
public class UserController {

    @PostMapping("add")
    public ResponseEntity<String> add(@Valid @RequestBody User user, BindingResult bindingResult) {
        if (bindingResult.hasErrors()) {
            List<ObjectError> errors = bindingResult.getAllErrors();
            errors.forEach(p -> {
                FieldError fieldError = (FieldError) p;
                log.error("Invalid Parameter : object - {},field - {},errorMessage - {}", fieldError.getObjectName(), fieldError.getField(), fieldError.getDefaultMessage());
            });
            return ResponseEntity.badRequest().body("invalid parameter");
        }
        return ResponseEntity.ok("success");
    }
}

分组校验

定义分组

在上边的User类中定义分组，接口不需要实现

	//定义分组
	public interface AddValidationGroup {
	}
	public interface EditValidationGroup {
	}

添加分组

@Data
public class User {

    @NotEmpty(message = "{user.msg.userId.notEmpty}", groups = {EditValidationGroup.class}) // 这里
    private String userId;
	
	//定义分组
	public interface AddValidationGroup {
	}
	public interface EditValidationGroup {
	}

}

使用分组

PS: 需要使用@Validated注解

@Slf4j
@RestController
@RequestMapping("/user")
public class UserController {

   
    @PostMapping("add")
    public ResponseEntity<User> add(@Validated(AddValidationGroup.class) @RequestBody User user) {
        return ResponseEntity.ok(user);
    }

    
    @PostMapping("edit")
    public ResponseEntity<User> edit(@Validated(EditValidationGroup.class) @RequestBody User user) {
        return ResponseEntity.ok(user);
    }
}

@Validated和@Valid区别

在检验Controller的入参是否符合规范时，使用@Validated或者@Valid在基本验证功能上没有太多区别。但是在分组、注解地方、嵌套验证等功能上两个有所不同：

分组

@Validated：提供了一个分组功能，可以在入参验证时，根据不同的分组采用不同的验证机制，这个网上也有资料，不详述。@Valid：作为标准JSR-303规范，还没有吸收分组的功能。

注解地方

@Validated：可以用在类型、方法和方法参数上。但是不能用在成员属性（字段）上

@Valid：可以用在方法、构造函数、方法参数和成员属性（字段）上

嵌套类型

Address是User类中的一个嵌套属性，只能用@Valid

@Data
public class User {

    @Valid // 这里只能用@Valid
    private Address address;

}

常见的约束注解

JSR303/JSR-349: JSR303是一项标准,只提供规范不提供实现，规定一些校验规范即校验注解，如@Null，@NotNull，@Pattern，位于javax.validation.constraints包下。JSR-349是其的升级版本，添加了一些新特性。

注解	功能
@AssertFalse	被注释的元素只能为false
@AssertTrue	被注释的元素只能为true
@DecimalMax	被注释的元素必须小于或等于
@DecimalMin	被注释的元素必须大于或等于
@Digits	被注释的元素数字的值超出了允许范围(只允许在{integer}位整数和{fraction}位小数范围内)
@Email	被注释的元素不是一个合法的电子邮件地址
@Future	被注释的元素需要是一个将来的时间
@FutureOrPresent	被注释的元素需要是一个将来或现在的时间
@Max	被注释的元素最大不能超过
@Min	被注释的元素最小不能小于
@Negative	被注释的元素必须是负数
@NegativeOrZero	被注释的元素必须是负数或零
@NotBlank	被注释的元素不能为空
@NotEmpty	被注释的元素不能为空
@NotNull	被注释的元素不能为null
@Null	被注释的元素必须为null
@Past	被注释的元素需要是一个过去的时间
@PastOrPresent	被注释的元素需要是一个过去或现在的时间
@Pattern	被注释的元素需要匹配正则表达式"{regexp}"
@Positive	被注释的元素必须是正数
@PositiveOrZero	被注释的元素必须是正数或零
@Size	被注释的元素个数必须在{min}和{max}之间

hibernate validation：hibernate validation是对这个规范的实现，并增加了一些其他校验注解，如@Email，@Length，@Range等等

注解	功能
@CreditCardNumber	被注释的元素不合法的信用卡号码
@Currency	被注释的元素不合法的货币 (必须是{value}其中之一)
@EAN	被注释的元素不合法的{type}条形码
@Email	被注释的元素不是一个合法的电子邮件地址 (已过期)
@Length	被注释的元素长度需要在{min}和{max}之间
@CodePointLength	被注释的元素长度需要在{min}和{max}之间
@LuhnCheck	被注释的元素${validatedValue}的校验码不合法, Luhn模10校验和不匹配
@Mod10Check	被注释的元素${validatedValue}的校验码不合法, 模10校验和不匹配
@Mod11Check	被注释的元素${validatedValue}的校验码不合法, 模11校验和不匹配
@ModCheck	被注释的元素${validatedValue}的校验码不合法, ${modType}校验和不匹配 (已过期)
@NotBlank	被注释的元素不能为空 (已过期)
@NotEmpty	被注释的元素不能为空 (已过期)
@ParametersScriptAssert	被注释的元素执行脚本表达式"{script}"没有返回期望结果
@Range	被注释的元素需要在{min}和{max}之间
@SafeHtml	被注释的元素可能有不安全的HTML内容
@ScriptAssert	被注释的元素执行脚本表达式"{script}"没有返回期望结果
@URL	被注释的元素需要是一个合法的URL
@DurationMax	被注释的元素必须小于${inclusive == true ? '或等于' : ''}${days == 0 ? '' : days += '天'}${hours == 0 ? '' : hours += '小时'}${minutes == 0 ? '' : minutes += '分钟'}${seconds == 0 ? '' : seconds += '秒'}${millis == 0 ? '' : millis += '毫秒'}$
@DurationMin	被注释的元素必须大于${inclusive == true ? '或等于' : ''}${days == 0 ? '' : days += '天'}${hours == 0 ? '' : hours += '小时'}${minutes == 0 ? '' : minutes += '分钟'}${seconds == 0 ? '' : seconds += '秒'}${millis == 0 ? '' : millis += '毫秒'}$

posted @ 2023-05-08 10:16 leepandar 阅读(151) 评论(0) 编辑收藏举报

刷新页面返回顶部

醒醒和等等