核心内容摘要
怎么用 LangGraph 创建属于你自己的 AI 智能体
自定义注解的定义自定义注解是 Java 中的一种元数据标记允许在代码中添加自定义信息并能通过反射机制进行处理。
我们首先定义一个自定义注解然后在 Spring 中使用该注解来标识需要处理的类或方法。
示例定义一个简单的自定义注解LogExecutionTimejava复制Target(ElementType.METHOD) // 该注解只用于方法上 Retention(RetentionPolicy.RUNTIME) // 注解在运行时可用 public interface LogExecutionTime { }Target(ElementType.METHOD)表示该注解只能应用于方法上。
Retention(RetentionPolicy.RUNTIME)表示该注解会在运行时通过反射获取。
自定义注解的处理器设计自定义注解通常需要一个处理器来执行特定的操作例如记录日志、验证权限等。
在 Spring 中我们通常使用 AOP 来处理注解具体实现步骤如下定义一个切面类。
在切面类中定义一个通知方法监听被自定义注解标注的方法。
使用 Spring AOP 来处理注解的逻辑。
示例定义一个处理LogExecutionTime注解的切面java复制Aspect Component public class LogExecutionTimeAspect { Around(annotation(LogExecutionTime)) // 通过注解进行方法拦截 public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable { long start System.currentTimeMillis(); // 记录方法执行前的时间 Object result joinPoint.proceed(); // 执行目标方法 long end System.currentTimeMillis(); // 记录方法执行后的时间 // 输出方法执行时间 System.out.println(Execution time of joinPoint.getSignature() is (end - start) ms); return result; } }
注解处理器与 AOP 配合在 Spring 中注解的处理通常与 AOP面向切面编程一起使用。
Spring 会根据注解类型动态生成代理对象拦截带有注解的目标方法并在方法执行前后执行增强逻辑。
Spring AOP 会根据注解和方法匹配来确定何时执行通知。
核心源码解析Around注解的工作原理java复制Around(annotation(LogExecutionTime)) // 注解拦截器的核心实现 public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable { long start System.currentTimeMillis(); // 记录执行开始时间 Object result joinPoint.proceed(); // 执行目标方法 long end System.currentTimeMillis(); // 记录执行结束时间 System.out.println(Execution time of joinPoint.getSignature() is (end - start) ms); return result; }joinPoint.proceed()表示调用目标方法。
ProceedingJoinPoint是JoinPoint的子类支持方法的继续执行。
启动 Spring AOP 的配置为了使 Spring 能够识别自定义注解并使用切面进行处理需要确保 AOP 功能已经启用。
Spring 提供了两种启用 AOP 的方式使用 XML 配置文件。
使用注解EnableAspectJAutoProxy。
配置 AOP 功能java复制Configuration EnableAspectJAutoProxy public class AopConfig { }
自定义注解的处理器与 Spring 容器集成Spring 容器负责创建所有的 Bean包括自定义的注解处理器。
为了确保自定义注解处理器能够生效我们需要将其作为 Spring 的一个组件 (Component) 放入 Spring 容器管理。
示例将切面类注册为 Spring Beanjava复制Aspect Component public class LogExecutionTimeAspect { // 切面逻辑 }
注解处理器的执行顺序Spring AOP 会在执行目标方法之前和之后进行插入。
处理器的执行顺序和 Spring AOP 的代理顺序密切相关。
如果有多个Aspect注解的切面类Spring 会根据配置的顺序来决定它们的执行顺序。
如果使用了Order注解还可以指定处理器的优先级。
默认情况下AOP 的执行顺序是按照 Spring Bean 的加载顺序来执行。
示例通过Order控制切面的执行顺序java复制Aspect Order(
Component public class LogExecutionTimeAspect { // 切面逻辑 } Aspect Order(
Component public class AnotherAspect { // 其他切面逻辑 }
综合示例使用自定义注解与处理器下面是一个完整的示例演示如何创建自定义注解和处理器并在 Spring Boot 项目中进行集成。
自定义注解定义java复制Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface LogExecutionTime { }AOP 切面定义java复制Aspect Component public class LogExecutionTimeAspect { Around(annotation(LogExecutionTime)) public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable { long start System.currentTimeMillis(); Object result joinPoint.proceed(); long end System.currentTimeMillis(); System.out.println(Execution time of joinPoint.getSignature() is (end - start) ms); return result; } }应用实例java复制Service public class MyService { LogExecutionTime public String doSomething() { // 模拟业务逻辑 try { Thread.sleep(
; } catch (InterruptedException e) { Thread.currentThread().interrupt(); } return Done; } }
总结通过自定义注解和 Spring AOP 的结合可以实现灵活的代码增强功能而无需修改业务逻辑代码。
这种方式特别适用于日志记录、权限校验、性能监控等横切关注点的处理