Spring Boot中常用的JSR 380参数校验注解

@NotNull: 验证对象值不应为 null。
@AssertTrue: 验证布尔值是否为 true。
@AssertFalse: 验证布尔值是否为 false。
@Min(value): 验证数字是否不小于指定的最小值。
@Max(value): 验证数字是否不大于指定的最大值。
@DecimalMin(value): 验证数字值(可以是浮点数)是否不小于指定的最小值。
@DecimalMax(value): 验证数字值(可以是浮点数)是否不大于指定的最大值。
@Positive: 验证数字值是否为正数。
@PositiveOrZero: 验证数字值是否为正数或零。
@Negative: 验证数字值是否为负数。
@NegativeOrZero: 验证数字值是否为负数或零。
@Size(min, max): 验证元素(如字符串、集合或数组)的大小是否在给定的最小值和最大值之间。
@Digits(integer, fraction): 验证数字是否在指定的位数范围内。例如,可以验证一个数字是否有两位整数和三位小数。
@Past: 验证日期或时间是否在当前时间之前。
@PastOrPresent: 验证日期或时间是否在当前时间或之前。
@Future: 验证日期或时间是否在当前时间之后。
@FutureOrPresent: 验证日期或时间是否在当前时间或之后。
@Pattern(regexp): 验证字符串是否与给定的正则表达式匹配。
@NotEmpty: 验证元素(如字符串、集合、Map 或数组)不为 null,并且其大小/长度大于0。
@NotBlank: 验证字符串不为 null,且至少包含一个非空白字符。
@Email: 验证字符串是否符合有效的电子邮件格式。

如何使用?

导入参数校验的依赖

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

在实体类中需要校验的字段添加注解即可,如:

@Data
public class User {
    @NotBlank(message = "用户名不能为空")
    private String username;

    @NotBlank(message = "密码不能为空")
    private String password;

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

    @NotBlank(message = "手机号不能为空")
    @Size(min = 11, max = 11, message = "手机号少于11位")
    private String phone;
    
    @Min(value = 18, message = "年龄必须大于18岁")
    @Max(value = 100, message = "年龄不能大于100岁")
    private String age;
}

在控制器类中指定需要进行参数校验的类

@RequestMapping("/test")
@RestController
public class TestController {
    @PostMapping("/user")
    @ApiOperationlog(description = "测试接口")
    public Response testA(@RequestBody @Validated User user, BindingResult bindingResult){
        if (bindingResult.hasErrors()){
            //获取参数校验失败的信息
            String errorMessage = bindingResult.getFieldErrors()
                    .stream()
                    .map(FieldError::getDefaultMessage).
                    collect(Collectors.joining(","));
            return Response.failed(errorMessage);
        }
        return Response.success();
    }
}
// @Validated注解指定需要校验的类
//BindingResult 校验结果

效果如下
入参

{
 "username":"123",
 "password":"123",
 "email":"@qq.com",
 "phone":"123",
 "age":"1000"
 }

响应


{
    "code": "201",
    "message": "邮箱格式不正确,手机号少于11位,年龄不能大于100岁",
    "data": null
}
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

@Yjd007

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值