Spring Boot中一些验证字段注解说明

本文介绍了Java中常用的校验注解,如@NotNull、@DecimalMinMax等,通过例子展示了如何在实体类中使用这些注解进行参数验证,并演示了如何在Controller中结合@Valid进行请求校验。

1、这些注解用于java的实体类属性字段上,在进行请求或请求的时候会根 据字段的注解进行对应的校验,简化校验相关的代码。

2、在前端请求解析到 controller 的时候,可使用 @valid 注解,开启校验,当校验不同过时,会返回对应的message描述。

//被注释的元素必须为null
@Null(message = "元素不能为空!")  

//被注释的元素不能为null
@NotNull  

//被注释的元素必须为true
@AssertTrue  

//被注释的元素必须为false
@AssertFalse  

//被注释的元素必须是一个数字,其值必须大于等于指定的最小值
@Min(value)  

//被注释的元素必须是一个数字,其值必须小于等于指定的最大值
@Max(value)  

//被注释的元素必须是一个数字,其值必须大于等于指定的最小值
@DecimalMin(value)  

//被注释的元素必须是一个数字,其值必须小于等于指定的最大值
@DecimalMax(value)  

//被注释的元素的大小必须在指定的范围内。
@Size(max,min) 

//被注释的元素必须是一个数字,其值必须在可接受的范围内
@Digits(integer,fraction) 

//被注释的元素必须是一个过去的日期 
@Past  

//被注释的元素必须是一个将来的日期
@Future  

//被注释的元素必须符合指定的正则表达式。
@Pattern(value) 

//被注释的元素必须是电子邮件地址
@Email 

//被注释的字符串的大小必须在指定的范围内
@Length 

//被注释的字符串必须非空
@NotEmpty  

//被注释的元素必须在合适的范围内
@Range 

3、例子:

package com.commons.entity;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;

import javax.validation.constraints.NotNull;
import java.io.Serializable;
import java.util.Date;

/**
 * @author mis_wu
 * @date 2022/3/13 11:39
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
@ToString
@ApiModel(value = "电影用户信息表")
public class MovieUserInfo implements Serializable {

    @ApiModelProperty("用户id")
    @NotNull(message = "用户id不能为空!")
    private Long userId;

    @ApiModelProperty("用户名")
    @NotNull(message = "用户名不能为空!")
    private String userName;

    @ApiModelProperty("用户登陆密码")
    @NotNull(message = "用户密码不能为空!")
    private String userPassword;
}
//使用@Valild验证
@PostMapping("/movieUserRegister")
public ResponseResult movieUserRegister(@Valid MovieUserInfo movieUserInfo){
    movieUsersServices.movieUserRegister(movieUserInfo);
    return null;
}
Spring Boot 中自定义验证注解对 BigDecimal 字段进行复杂验证,可按以下步骤操作: ### 定义自定义注解 通过 `@Constraint` 注解指定校验器实现类,完成自定义校验注解开发。该注解需指定 `validatedBy` 属性,指向校验器实现类。同时使用 `@Target` 和 `@Retention` 注解来指定注解的作用目标和保留策略。以下是一个示例,用于验证 BigDecimal 字段是否在指定的范围内: ```java import javax.validation.Constraint; import javax.validation.Payload; import java.lang.annotation.*; @Documented @Constraint(validatedBy = BigDecimalRangeValidator.class) @Target({ElementType.FIELD, ElementType.PARAMETER}) @Retention(RetentionPolicy.RUNTIME) public @interface BigDecimalRange { String message() default "BigDecimal value is not in the valid range"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; BigDecimal min() default BigDecimal.ZERO; BigDecimal max() default BigDecimal.TEN; } ``` ### 实现校验器 校验器实现类需继承 `ConstraintValidator`,重写 `isValid` 方法定义校验逻辑。在 `isValid` 方法中编写具体的验证逻辑,判断 BigDecimal 字段的值是否符合要求: ```java import javax.validation.ConstraintValidator; import javax.validation.ConstraintValidatorContext; import java.math.BigDecimal; public class BigDecimalRangeValidator implements ConstraintValidator<BigDecimalRange, BigDecimal> { private BigDecimal min; private BigDecimal max; @Override public void initialize(BigDecimalRange constraintAnnotation) { this.min = constraintAnnotation.min(); this.max = constraintAnnotation.max(); } @Override public boolean isValid(BigDecimal value, ConstraintValidatorContext context) { if (value == null) { return true; } return value.compareTo(min) >= 0 && value.compareTo(max) <= 0; } } ``` ### 在实体类中使用自定义注解 在需要验证的实体类的 BigDecimal 字段上使用自定义注解: ```java import java.math.BigDecimal; public class Product { @BigDecimalRange(min = new BigDecimal("10.00"), max = new BigDecimal("100.00")) private BigDecimal price; public BigDecimal getPrice() { return price; } public void setPrice(BigDecimal price) { this.price = price; } } ``` ### 在控制器中触发验证 在控制器方法的参数前添加 `@Valid` 注解触发验证,同时使用 `BindingResult` 来处理验证结果: ```java import org.springframework.validation.BindingResult; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RestController; @RestController public class ProductController { @PostMapping("/products") public String createProduct(@Validated @RequestBody Product product, BindingResult bindingResult) { if (bindingResult.hasErrors()) { return bindingResult.getAllErrors().get(0).getDefaultMessage(); } // 处理业务逻辑 return "Product created successfully"; } } ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值