java参数 java参数校验注解

一、常用校验注解

@Null 限制只能为null

@NotNull 限制必须不为null

@AssertFalse 限制必须为false

@AssertTrue 限制必须为true

@DecimalMax(value) 限制必须为一个不大于指定值的数字

@DecimalMin(value) 限制必须为一个不小于指定值的数字

@Digits(integer,fraction) 限制必须为一个小数，且整数部分的位数不能超过integer，小数部分的位数不能超过fraction

@Future 限制必须是一个将来的日期

@Max(value) 限制必须为一个不大于指定值的数字

@Min(value) 限制必须为一个不小于指定值的数字

@Past 限制必须是一个过去的日期

@Pattern(value) 限制必须符合指定的正则表达式

@Size(max,min) 限制字符长度必须在min到max之间

@Past 验证注解的元素值（日期类型）比当前时间早

@NotEmpty 验证注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0）

@NotBlank 验证注解的元素值不为空（不为null、去除首位空格后长度为0），不同于@NotEmpty，@NotBlank只应用于字符串且在比较时会去除字符串的空格

@Email 验证注解的元素值是Email，也可以通过正则表达式和flag指定自定义的email

二、创建注解接口

NumberThanMin

import com.hierway.wms.inventory.utils.annotation.impl.NumberThanMinImpl;
import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;
import static java.lang.annotation.ElementType.PARAMETER;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

@Target({
    
     METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER }) //范围
@Retention(RetentionPolicy.RUNTIME) // 运行时
@Repeatable(NumberThanMin.List.class)
@Documented
@Constraint(validatedBy = {
    
    NumberThanMinImpl.class}) // 指明自定义注解的实现类
public @interface NumberThanMin {
    
    

    String message() default "It has to be greater than 0";

    Class<?>[] groups() default {
    
    };

    Class<? extends Payload>[] payload() default {
    
    };

    double minThan() default 0;

    @Target({
    
     METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
    @Retention(RUNTIME)
    @Documented
    public @interface List {
    
    
        NumberThanMin[] value();
    }
}

三、注解接口实现类

NumberThanMinImpl

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.math.BigDecimal;

/**
 * @Description
 * @Author by mocar小师兄
 **/
public class NumberThanMinImpl implements ConstraintValidator<NumberThanMin, Number> {
    
    
    Number min;

    @Override
    public void initialize(NumberThanMin constraintAnnotation) {
    
    
        min = constraintAnnotation.minThan();
    }

    @Override
    public boolean isValid(Number param, ConstraintValidatorContext constraintValidatorContext) {
    
    
        if (null == param){
    
    
            return false;
        }
        return new BigDecimal(param.toString()).compareTo(new BigDecimal(min.toString())) > 0;

    }
}

四、应用

/**
     * 数量
     */
    @NotNull(message = "数量不能为空")
    //@DecimalMin(value="0",message="数量不能小于0")
    @NumberThanMin(message="数量必须大于0!")
    private Double quantity;