如何用Java注解实现方法参数的checkNode校验替代手动调用？

当然可以实现你要的@ValidNode注解，不用每次手动调用checkNode()。下面是几种可行的方案：

一、用AOP（面向切面编程）实现自定义注解校验 #

这是最直接的方式，通过切面拦截带有@ValidNode注解的方法参数，自动执行校验逻辑。

1. 定义@ValidNode注解 #

先写一个标记用的注解，指定它可以标记参数，并且运行时能被读取：

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

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidNode {
}

2. 编写AOP切面处理校验 #

以Spring AOP为例，写一个切面类，拦截所有带有@ValidNode参数的方法，自动调用校验逻辑：

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.stereotype.Component;
import java.lang.reflect.Parameter;

@Aspect
@Component
public class ValidNodeAspect {

    // 拦截所有包含@ValidNode注解参数的方法
    @Before("execution(* *(.., @ValidNode (*), ..))")
    public void validateNodeParam(JoinPoint joinPoint) {
        MethodSignature methodSig = (MethodSignature) joinPoint.getSignature();
        Parameter[] params = methodSig.getMethod().getParameters();
        Object[] args = joinPoint.getArgs();

        // 遍历参数，找到带注解的并执行校验
        for (int i = 0; i < params.length; i++) {
            if (params[i].isAnnotationPresent(ValidNode.class)) {
                String node = (String) args[i];
                checkNode(node);
            }
        }
    }

    // 你的原有校验逻辑
    private void checkNode(final String node) throws IllegalStateException {
        if (node == null || node.trim().isEmpty()) {
            throw new IllegalStateException("节点不能为空");
        }
        // 这里可以加其他校验规则，比如格式、长度检查等
    }
}

3. 使用方式 #

直接在方法参数上标记@ValidNode就行，不用手动调用checkNode()：

public void addNode(@ValidNode final String node) throws IllegalStateException {
    // 业务逻辑代码
}

二、借助Bean Validation框架（JSR-380）实现 #

如果是Spring项目，更推荐用成熟的校验框架，自定义约束注解，比自己写AOP更规范。

1. 自定义@ValidNode约束注解 #

import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;

@Target({ElementType.PARAMETER, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = NodeValidator.class)
public @interface ValidNode {
    String message() default "节点格式不合法";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

2. 编写校验器实现类 #

import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;

public class NodeValidator implements ConstraintValidator<ValidNode, String> {
    @Override
    public boolean isValid(String node, ConstraintValidatorContext context) {
        if (node == null || node.trim().isEmpty()) {
            // 自定义错误提示
            context.disableDefaultConstraintViolation();
            context.buildConstraintViolationWithTemplate("节点不能为空").addConstraintViolation();
            return false;
        }
        // 其他校验规则，比如节点名称格式、是否符合业务规则等
        return true;
    }
}

3. 使用方式 #

在类上标记@Validated，方法参数加@ValidNode：

import org.springframework.validation.annotation.Validated;

@Validated
public class NodeService {
    public void addNode(@ValidNode final String node) throws IllegalStateException {
        // 业务逻辑
    }
}

三、非Spring环境的替代方案 #

如果不是Spring项目，可以用原生AspectJ实现AOP，或者用注解处理器在编译阶段自动生成校验代码（不过注解处理器实现起来更复杂，适合对性能要求极高的场景）。

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