java中的@Signal注解

@Signal 注解是Java SE 8中引入的一个注解类型，它是 JSR 303 / Bean Validation 1.1 规范的一部分。@Signal 注解用于在bean验证框架中定义约束违规信号。它主要用于在验证过程中，当遇到违反约束的情况时，发出一个信号，以便可以自定义如何处理这些违规情况。

具体来说，@Signal 注解可以被用在方法上，或者与@Constraint 注解一起用于自定义约束。当验证器发现验证失败时，它会通过信号通知验证过程的监听者。监听者可以是任何实现了 ConstraintValidator 或 ConstraintValidatorFactory 接口的类，这些类可以用来自定义验证过程的行为。

例如，你可以定义一个约束，当验证失败时，抛出一个特定的异常或者执行某些自定义的逻辑：

@Target({ METHOD, FIELD, ANNOTATION_TYPE })
@Retention(RUNTIME)
@Constraint(validatedBy = CustomValidator.class)
@Documented
public @interface CustomConstraint {
    String message() default "Invalid value";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    @Signal
    Class<? extends Exception>[] signal() default {};
}

public class CustomValidator implements ConstraintValidator<CustomConstraint, String> {
    @Override
    public void initialize(CustomConstraint constraintAnnotation) {
        // 初始化逻辑
    }

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        // 自定义验证逻辑
        // 如果验证失败，可以通过context的 buildConstraintViolationWithTemplate 方法构建违规信息
        // 并通过 context.disableDefaultConstraintViolation(); 禁用默认违规构建器
        // context.buildConstraintViolationWithTemplate("Invalid value").disableDefaultConstraintViolation();
        return false; // 这里返回 false 表示验证失败
    }
}

在上面的例子中，`@Signal` 注解用于指定当 `CustomConstraint` 约束验证失败时应该抛出的异常类型。