分享几个实用的参数校验注解（含字段依赖校验、枚举字段值有效性校验、参数类型转换）

莞尔流年

已于 2023-01-06 17:48:43 修改

阅读量1.8k

点赞数

分类专栏：开发工具类文章标签：枚举值校验注解依赖参数值校验 Excel导入参数校验

于 2023-01-06 17:43:01 首次发布

本文链接：https://blog.csdn.net/u010473656/article/details/128581904

版权

本文分享了三种实用的参数校验注解，包括字段依赖校验，确保字段A值在特定情况下字段B不为空；枚举字段有效性校验，验证请求中的枚举字段值是否合法；以及String参数类型转换集成校验，针对Excel导入的日期和金额字段进行转换和校验。通过注解声明、处理类和应用示例，详细阐述了这些校验的实现方法。

摘要由CSDN通过智能技术生成

字段依赖校验相关代码

应用场景

某个字段的值校验依赖于另一个字段的值
举例：当字段A in {1,2,3}时，字段B不能为空

注解声明

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target({
   ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface NotNullWhen {
   

    //当前字段最小值
    long min() default 0;

    //依赖字段名
    String dependsOnField();

    //依赖字段值域
    String[] dependsOnFieldValues();

    //校验失败时的提示信息
    String message() default "";

}

注解处理类

public class ParamValidator {
   
	public static void validateWithDepends(Object validateObject) {
   
        List<Field> fieldList = new ArrayList<>();
        Collections.addAll(fieldList, validateObject.getClass().getDeclaredFields());
        Collections.addAll(fieldList, validateObject.getClass().getSuperclass().getDeclaredFields());
        for (Field field : fieldList) {
   
            NotNullWhen annotation = field.getDeclaredAnnotation(NotNullWhen.class);
            if (annotation == null) {
   
                continue;
            }
            Field dependsOnField = null;
            try {
   
                dependsOnField = validateObject.getClass().getDeclaredField(annotation.dependsOnField());
            } catch (NoSuchFieldException e) {
   
                e.printStackTrace();
                throw ServiceException.of(ResultCode.PARAM_INVALID);
            }
            try {
   
                dependsOnField.setAccessible(true);
                Object value = dependsOnField.get(validateObject);

                if (value == null) {
   
                    continue;
                }
                if (Arrays.stream(annotation.dependsOnFieldValues()).anyMatch(v -> String.valueOf(value).equals(v))) {
   
                    Object annotationFieldValue = null;
                    field.setAccessible(true);
                    annotationFieldValue = field.get(validateObject);
                    if (field.getType() == Integer.class || field.getType() == Long.class) {
   
                        if (annotationFieldValue == null || (Long.parseLong(String.valueOf(annotationFieldValue)) < annotation.min())) {
   
                            throw ServiceException.ofWarn(ResultCode.PARAM_INVALID, annotation.message());
                        }
                    }
                    if (field.