Java 4种校验注解（值校验、范围校验、长度校验、格式校验）及校验多字段前端必传其一

一、校验多字段前端必传其一

1、使用自定义注解来标识

package com.zjjw.city.iface.aspect;

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;


/**
 * @author: chenjiaxiang
 * @create: 2023/3/30 09:53
 **/
@Target( {ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = AtLeastOneNotEmptyValidator.class)
@Documented
public @interface AtLeastOneNotEmpty {

    String message() default "至少有一个属性不可为空";

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

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

    String[] fields();
}

package com.zjjw.city.iface.aspect;



import org.springframework.util.StringUtils;

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.lang.reflect.Field;


/**
 * @author: chenjiaxiang
 * @create: 2023/3/30 09:55
 **/
public class AtLeastOneNotEmptyValidator implements ConstraintValidator<AtLeastOneNotEmpty, Object> {

    private String[] fields;

    @Override
    public void initialize(AtLeastOneNotEmpty atLeastOneNotEmpty) {
        this.fields = atLeastOneNotEmpty.fields();
    }

    @Override
    public boolean isValid(Object object, ConstraintValidatorContext constraintValidatorContext) {
        if (object == null) {
            return true;
        }
        try {
            for (String fieldName : fields) {
                Object property = getField(object, fieldName);
                if (!StringUtils.isEmpty(property)) {
                    return true;
                }
            }
            return false;
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
    }

    private Object getField(Object object, String fieldName) throws IllegalAccessException {
        if (object == null) {
            return null;
        }
        Class<?> clazz = object.getClass();
        Field[] fields = clazz.getDeclaredFields();
        for (Field field : fields) {
            if (field.getName().equals(fieldName)) {
                field.setAccessible(true);
                return field.get(object);
            }
        }
        return null;
    }
}

2、示例：

 二、4种校验注解（值校验、范围校验、长度校验、格式校验）

1、Maven依赖

 
        <!--第一种方式导入校验依赖-->
        <dependency>
            <groupId>javax.validation</groupId>
            <artifactId>validation-api</artifactId>
            <version>2.0.1.Final</version>
        </dependency>
        <!--第二种方式导入校验依赖-->
        <dependency>
            <groupId>org.hibernate.validator</groupId>
            <artifactId>hibernate-validator</artifactId>
        </dependency>

2 值校验

2.1 @Null注解

被注解的元素必须为null

@Null(message = "必须为null")
private String username;

2.2 @NotNull注解

被注解的元素必须不为null

@NotNull(message = "必须不为null")
private String username;

2.3 @NotBlank注解

验证注解的元素值不为空（不为null、去除首位空格后长度为0） ，并且类型为String。

@NotBlank(message = "必须不为空")
private String username;

2.4 @NotEmpty注解

验证注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0） ，并且类型为String。

@NotEmpty(message = "必须不为null且不为空")
private String username;

2.5 @AssertTrue注解

被注解的元素必须为true，并且类型为boolean。

@AssertTrue(message = "必须为true")
private boolean status;

2.6 @AssertFalse注解

被注解的元素必须为false，并且类型为boolean。

@AssertFalse(message = "必须为false")
private boolean status;

3 范围校验

3.1 @Min注解

被注解的元素其值必须大于等于最小值，并且类型为int，long，float，double。

@Min(value = 18, message = "必须大于等于18")
private int age;

3.2 @Max注解

被注解的元素其值必须小于等于最小值，并且类型为int，long，float，double。

@Max(value = 18, message = "必须小于等于18")
private int age;

3.3 @DecimalMin注解

验证注解的元素值大于等于@DecimalMin指定的value值，并且类型为BigDecimal。

@DecimalMin(value = "150", message = "必须大于等于150")
private BigDecimal height;

3.4 @DecimalMax注解

验证注解的元素值小于等于@DecimalMax指定的value值 ，并且类型为BigDecimal。

@DecimalMax(value = "300", message = "必须大于等于300")
private BigDecimal height;

3.5 @Range注解

验证注解的元素值在最小值和最大值之间，并且类型为BigDecimal，BigInteger，CharSequence，byte，short，int，long。

@Range(max = 80, min = 18, message = "必须大于等于18或小于等于80")
private int age;

3.6 @Past注解

被注解的元素必须为过去的一个时间，并且类型为java.util.Date。

@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
@Past(message = "必须为过去的时间")
private Date createDate;

3.7 @Future注解

被注解的元素必须为未来的一个时间，并且类型为java.util.Date。

@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
@Future(message = "必须为未来的时间")
private Date createDate;

4 长度校验

4.1 @Size注解

被注解的元素的长度必须在指定范围内，并且类型为String，Array，List，Map。

@Size(max = 11, min = 7, message = "长度必须大于等于7或小于等于11")
private String mobile;

4.2 @Length注解

验证注解的元素值长度在min和max区间内 ，并且类型为String。

@Length(max = 11, min = 7, message = "长度必须大于等于7或小于等于11")
private String mobile;

5 格式校验

5.1 @Digits注解

验证注解的元素值的整数位数和小数位数上限 ，并且类型为float，double，BigDecimal。

@Digits(integer=3,fraction = 2,message = "整数位上限为3位，小数位上限为2位")
private BigDecimal height;

5.2 @Pattern注解

被注解的元素必须符合指定的正则表达式，并且类型为String。

@Pattern(regexp = "\\d{11}",message = "必须为数字，并且长度为11")
private String mobile;

5.3 @Email注解

验证注解的元素值是Email，也可以通过regexp和flag指定自定义的email格式，类型为String。

 @Email(message = "必须是邮箱")
private String email;