Java校验能否传入动态参数？自定义校验器传参方案问询

问题背景 #

现有如下类定义和校验器：
类定义：

class ClassA {
  @FancyValidation
  String value;
}

对应的校验器实现：

public class FancyValidator implements ConstraintValidator<FancyValidation, String> {

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        return doSomeFancyThingsWithValue(value);
    }
}

目前只能通过注解固定参数（如@FancyValidation(param1 = "value1")）传参，或用分组开关校验规则，但无法实现调用validator.validate(instanceOfClassA, parameter1)时把动态参数传递到isValid方法中执行校验逻辑。

可行实现方案 #

方案1：利用ConstraintValidatorContext的自定义属性传递参数

Bean Validation的ConstraintValidatorContext支持存储自定义属性，可以在调用校验时通过上下文包装器注入动态参数：

调用校验的代码：

int parameter1 = 15;
Validator validator = Validation.buildDefaultValidatorFactory().getValidator();

Set<ConstraintViolation<ClassA>> violations = validator.validate(instanceOfClassA, new DefaultValidatorContext() {
    @Override
    public <T> T unwrap(Class<T> type) {
        if (type == ConstraintValidatorContext.class) {
            ConstraintValidatorContext originalContext = super.unwrap(type);
            // 注入动态参数到上下文属性
            originalContext.putProperty("parameter1", parameter1);
            return type.cast(originalContext);
        }
        return super.unwrap(type);
    }
});

修改后的校验器：

public class FancyValidator implements ConstraintValidator<FancyValidation, String> {

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        // 从上下文获取动态参数
        Integer parameter1Value = (Integer) context.getProperty("parameter1");
        return doSomeFancyThingsWithValue(value, parameter1Value);
    }
}

方案2：手动管理校验器实例，直接注入参数

如果不需要复用Bean Validation的完整特性（如分组、级联校验），可以直接创建校验器实例并设置动态参数：

调用校验的代码：

int parameter1 = 15;
FancyValidator validator = new FancyValidator();
validator.setParameter1(parameter1);

// 手动执行校验逻辑
boolean isValid = validator.isValid(instanceOfClassA.getValue(), null);

修改后的校验器：

public class FancyValidator implements ConstraintValidator<FancyValidation, String> {
    private Integer parameter1;

    // 提供参数设置方法
    public void setParameter1(Integer parameter1) {
        this.parameter1 = parameter1;
    }

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        return doSomeFancyThingsWithValue(value, parameter1);
    }
}

方案3：基于Hibernate Validator扩展注入参数（适配完整校验特性）

如果使用Hibernate Validator作为Bean Validation的实现，可以通过自定义ConstraintValidatorFactory结合线程上下文传递动态参数，既保留完整校验特性又支持动态传参：

1. 定义线程上下文存储参数：

public class ValidationParamHolder {
    private static final ThreadLocal<Integer> PARAM1_HOLDER = new ThreadLocal<>();

    public static void setParam1(Integer value) {
        PARAM1_HOLDER.set(value);
    }

    public static Integer getParam1() {
        return PARAM1_HOLDER.get();
    }

    public static void clear() {
        PARAM1_HOLDER.remove();
    }
}

2. 自定义校验器工厂：

public class CustomValidatorFactory implements ConstraintValidatorFactory {
    private final ConstraintValidatorFactory delegate;

    public CustomValidatorFactory(ConstraintValidatorFactory delegate) {
        this.delegate = delegate;
    }

    @Override
    public <T extends ConstraintValidator<?, ?>> T getInstance(Class<T> validatorClass) {
        T validator = delegate.getInstance(validatorClass);
        // 给目标校验器注入动态参数
        if (validator instanceof FancyValidator) {
            ((FancyValidator) validator).setParameter1(ValidationParamHolder.getParam1());
        }
        return validator;
    }

    @Override
    public void releaseInstance(ConstraintValidator<?, ?> instance) {
        delegate.releaseInstance(instance);
    }
}

3. 配置并使用Validator：

// 初始化带自定义工厂的Validator
ValidatorFactory factory = Validation.byProvider(HibernateValidator.class)
        .configure()
        .constraintValidatorFactory(new CustomValidatorFactory(new DefaultConstraintValidatorFactory()))
        .buildValidatorFactory();
Validator validator = factory.getValidator();

// 调用校验时设置线程参数
int parameter1 = 15;
ValidationParamHolder.setParam1(parameter1);
try {
    Set<ConstraintViolation<ClassA>> violations = validator.validate(instanceOfClassA);
    // 处理校验结果
} finally {
    // 清理线程参数，避免内存泄漏
    ValidationParamHolder.clear();
}

4. 校验器代码同方案2，需包含setParameter1方法。

内容的提问来源于stack exchange，提问作者Greg