Java编写自定义校验注解时，怎么编写允许参数为空，当参数不为空时才进行校验

在 Java 中编写自定义校验注解时，可以使用 `@ReportAsSingleViolation` 注解来指定只要有一个校验失败就返回结果，而不是等待所有的校验结果返回。同时，可以使用 `@javax.validation.constraints.Null` 和 `@javax.validation.constraints.NotNull` 注解来判断参数是否为 `null`。

具体来说，你可以按照以下步骤编写一个允许参数为空的自定义校验注解：

1. 定义注解

@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = {MyValidator.class})
@ReportAsSingleViolation
public @interface MyAnnotation {
    String message() default "my message";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

2. 定义校验器

public class MyValidator implements ConstraintValidator<MyAnnotation, String> {
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        if (value == null) {
            // 允许参数为空，直接返回 true
            return true;
        }
        // 对非空参数进行校验
        boolean isValid = // 校验逻辑
        if (!isValid) {
            context.disableDefaultConstraintViolation();
            context.buildConstraintViolationWithTemplate("my message")
                   .addConstraintViolation();
        }
        return isValid;
    }
}

在校验器中，我们首先判断参数是否为 `null`，如果是，则直接返回 `true`，即认为校验通过。如果参数不为 `null`，则进行校验逻辑，如果校验失败，则使用 `context.buildConstraintViolationWithTemplate()` 方法构建校验失败的信息。

3. 在需要校验的参数上应用注解

public void myMethod(@MyAnnotation String param) {
    // 方法逻辑
}

在需要校验的参数上使用 `@MyAnnotation` 注解，即可触发自定义校验注解的校验逻辑。如果参数为 `null`，则直接返回 `true`，否则进行校验逻辑。