导读（皮一下）
为什么需要自定义校验注解？
系统执行业务逻辑之前，会对输入数据进行校验，检测数据是否有效合法的。所以我们可能会写大量的if else等判断逻辑，特别是在不同方法出现相同的数据时，校验的逻辑代码会反复出现，导致代码冗余，阅读性和可维护性极差。
- 鉴于通用性和普遍性，Spring框架提供了validator组件，通过一些校验器，可以对一些数据进行统一的完整性和有效性等校验，即简单又好用。
- JSR-303是Java为Bean数据合法性校验提供的标准框架，它定义了一整套校验注解，可以标注在成员变量，属性方法等之上。
- 但是这些通用的校验注解，并不能满足我们的所有需求，如电话号格式校验，身份证号格式校验…
常用的校验器
在Java开发中，校验器（validator）是指用于数据验证的工具或库，它们帮助确保应用程序的数据符合预期的格式或规则。以下是一些常用的校验器库和框架：
| 名称 | 描述 |
|---|---|
| Bean Validation (JSR 303/349/380) | Java平台的标准数据验证API，提供注解驱动的数据验证机制 |
| Hibernate Validator | Bean Validation的参考实现，提供丰富的预定义注解，如@NotNull, @Size等 |
| Spring Validation | Spring框架中的集成Bean Validation的包，提供额外的校验功能 |
| Apache Commons Validator | 提供用于验证不同数据格式的工具，如电子邮件、URL、IP地址等 |
| Google Guava | Guava库中的Strings类，用于简单的字符串校验 |
| AssertJ | 一个断言库，用于编写更可读的单元测试，也常用于校验方法参数和对象状态 |
| JSR 303/349/380注解 | 包括@Null, @NotNull, @AssertTrue等，用于标注验证规则 |
| 自定义校验器 | 开发者可以自定义校验注解和校验器类，满足特定的业务需求 |
| Spring Boot Starter Validation | Spring Boot提供的验证启动器，集成了Hibernate Validator，简化配置 |
| Lombok | 自动生成Getter、Setter、构造器等，可配合Bean Validation使用，减少样板代码 |
自定义校验注解
自定义校验注解通常分为如下几步：
- 配置验证框架： 确保项目中包含了Bean Validation API的相关依赖（pom依赖，有没有校验器的jar）
- 创建注解，使用
@Constraint元注解来声明这是一个约束注解，使用@Target和@Retention元注解来指定注解的作用目标和保留策略。 - 实现校验器： 创建一个类实现
ConstraintValidator接口，这个类将包含实际的校验逻辑。需要重写initialize方法（初始化，基本不咋用到）和isValid方法，isValid方法用于执行具体的校验逻辑。 - 使用注解：在需要校验的字段或方法上使用自定义注解。
自定义电话号格式校验注解
import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;/*** 手机号校验注解*/
@Documented
@Constraint(validatedBy = PhoneNumberValidator.class)
@Target({ElementType.METHOD, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidPhoneNumber {String message() default "手机号格式不正确";Class<?>[] groups() default {};Class<? extends Payload>[] payload() default {};
}
// 实现校验逻辑的类
import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;public class PhoneNumberValidator implements ConstraintValidator<ValidPhoneNumber, String> {@Overridepublic void initialize(ValidPhoneNumber constraintAnnotation) {// 初始化方法，可以在这里进行一些初始化工作，但通常不需要实现}@Overridepublic boolean isValid(String phoneNumber, ConstraintValidatorContext context) {// 正则表达式，用于校验手机号格式String regex = "^1[3-9]\\d{9}$";return phoneNumber.matches(regex);}
}
使用方式：
public class User {@ValidPhoneNumber(message = "请输入正确的手机号")private String phone;// ...
}
自定义身份证号格式校验注解
import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;@Documented
@Constraint(validatedBy = IDCardValidator.class)
@Target({ElementType.METHOD, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidIDCard {String message() default "身份证号码格式不正确";Class<?>[] groups() default {};Class<? extends Payload>[] payload() default {};
}
import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;public class IDCardValidator implements ConstraintValidator<ValidIDCard, String> {private static final int ID_CARD_LENGTH_18 = 18;private static final String ID_CARD_REGEX_18 = "^[1-9]\\d{5}(18|19|20)\\d{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])\\d{3}([0-9]|X)$";private static final char[] VERIFY_CODE = {'1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'};private static final int[] WEIGHTS = {7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2};@Overridepublic void initialize(ValidIDCard constraintAnnotation) {}@Overridepublic boolean isValid(String idCard, ConstraintValidatorContext context) {if (idCard == null || idCard.length() != ID_CARD_LENGTH_18) {return false;}if (!idCard.matches(ID_CARD_REGEX_18)) {return false;}// 验证18位身份证的校验码return validate18(idCard);}private boolean validate18(String idCard) {int sum = 0;for (int i = 0; i < 17; i++) {sum += Character.getNumericValue(idCard.charAt(i)) * WEIGHTS[i];}int mod = sum % 11;char checkCode = VERIFY_CODE[mod];return Character.toUpperCase(idCard.charAt(17)) == checkCode;}
}
使用方式：
import javax.validation.constraints.NotNull;
import javax.validation.Valid;public class Person {@NotNull(message = "姓名不能为空")private String name;@ValidIDCard(message = "身份证号码格式不正确")private String idCard;// ...
}
