java如何使用注解实现自定义拦截器 java注解拦截器实现的基础入门教程​

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

/**
 * 自定义日志注解，用于标记需要记录方法执行日志的方法
 */
@Target(ElementType.METHOD) // 作用于方法
@Retention(RetentionPolicy.RUNTIME) // 运行时有效，以便通过反射读取
public @interface Loggable {
    String value() default ""; // 可以带一个参数，比如日志描述
}

import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.stereotype.Component;

import java.lang.reflect.Method;
import java.util.Arrays;

/**
 * 日志拦截切面
 */
@Aspect // 声明这是一个切面
@Component // 注册为Spring组件
public class LoggableAspect {

    // 定义切点，匹配所有带有 @Loggable 注解的方法
    @Pointcut("@annotation(com.example.demo.annotation.Loggable)")
    public void loggablePointcut() {
    }

    /**
     * 环绕通知：在方法执行前、后都执行逻辑
     * @param joinPoint 连接点，包含了被拦截方法的信息
     * @return 方法执行结果
     * @throws Throwable 异常
     */
    @Around("loggablePointcut()")
    public Object logMethodExecution(ProceedingJoinPoint joinPoint) throws Throwable {
        long startTime = System.currentTimeMillis();
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        Method method = signature.getMethod();
        String methodName = method.getName();
        String className = method.getDeclaringClass().getSimpleName();
        Object[] args = joinPoint.getArgs();

        // 获取注解上的值
        Loggable loggable = method.getAnnotation(Loggable.class);
        String logDescription = loggable != null ? loggable.value() : "无描述";

        System.out.println(">>> 进入方法: " + className + "." + methodName + "(), 描述: " + logDescription + ", 参数: " + Arrays.toString(args));

        Object result = null;
        try {
            // 执行目标方法
            result = joinPoint.proceed();
            System.out.println("<<< 离开方法: " + className + "." + methodName + "(), 返回值: " + result);
        } catch (Throwable e) {
            System.err.println("!!! 方法异常: " + className + "." + methodName + "(), 异常信息: " + e.getMessage());
            throw e; // 重新抛出异常，让上层处理
        } finally {
            long endTime = System.currentTimeMillis();
            System.out.println("--- 方法执行耗时: " + (endTime - startTime) + "ms");
        }
        return result;
    }
}

@EnableAspectJAutoProxy

spring-boot-starter-aop

@Loggable

import org.springframework.stereotype.Service;
import com.example.demo.annotation.Loggable; // 假设你的注解包路径

@Service
public class MyBusinessService {

    @Loggable("处理用户订单")
    public String processOrder(String orderId, int quantity) {
        System.out.println("实际业务逻辑：正在处理订单 " + orderId + "，数量 " + quantity);
        if (quantity <= 0) {
            throw new IllegalArgumentException("数量必须大于0");
        }
        return "订单 " + orderId + " 处理成功";
    }

    @Loggable("查询商品信息")
    public String getProductInfo(String productId) {
        System.out.println("实际业务逻辑：查询商品 " + productId);
        return "商品[" + productId + "] 详情";
    }

    public void doSomethingElse() {
        System.out.println("这个方法没有注解，不会被拦截。");
    }
}

processOrder

getProductInfo

@Loggable

methodA()

methodB()

methodB()

methodA()

methodB()

methodA()

methodB()

AopContext.currentProxy()

@Order

@RequiresPermission("user:create")

if (hasPermission())

@ValidateUserId

@MonitorPerformance

@Idempotent

@SensitiveData

@RateLimit(permits = 10)

@Cacheable