AOP实战小案例
前言
AOP技术是指面向切面编程技术,主要用于在具有横切逻辑的场景中,将横切逻辑提取出来,形成独立的模块,然后通过特殊的技术,如Java中的动态代理技术,动态地将横切逻辑织入到具体的应用场景中
大概在去年的这个时候,学习过AOP技术,对AOP中的一些概念也有一些了解,不过基本都是理论上的内容,缺乏实战经验,所以,对AOP的理解并不是很充分,加上最近刚好有个项目需要用到,老大说让我通过AOP来实现,加深对AOP的理解,所以有了这篇文章
环境准备
这篇文章中采用的是SpringBoot 1.5.14.RELEASE版本,当然,其实哪个版本都可以。不用SpringBoot其实也可以,主要是SpringBoot中配置起来比较简单,可以将主要精力集中在AOP上而不是环境的配置上、
需要引入aop依赖以及测试环境(主要是为了方便测试)
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId></dependency><dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope></dependency>
日志记录及性能监控
有时候,为了对程序有更好的控制以及分析,我们需要记录方法的调用情况,调用结果,以及执行时间等信息,这种情况下,基本上就是很多的方法都需要记录,而记录的这些操作又跟业务情况无关,也就是符合横切逻辑的概念,所以,通过AOP来实现是比较理想而且可维护性比较恰当的。
在本案例中,为了回顾之前学习到的注解以及反射等技术,这里通过为方法加上注解的形式来实现日志记录开关,当然,通过切面表达式直接匹配方法实现起来更加简单,不过,作为学习的案例,能在一个小案例中将尽量多的知识用上,也是一个不错的选择
首先是注解的设计以及实现
@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.METHOD)public @interface LogInfo { String value(); }
这里我们的注解设计比较简单,只包含一个基本的元素,用于记录方法的用途。这里需要注意的是注解的保留策略,由于我们需要在运行时获取注解的内容,所以注解的保留策略需要为RetentionPolicy.RUNTIME
接下来是切面的设计
切面,其实就是对应的操作逻辑(增强)以及注入点(切点)的结合,通过切点来定位,增强来实现功能增强
我们知道,SpringAOP中有多种方式来实现,比如通过环绕来实现,或者通过前置以及后置来实现,这两种方式理论上都是可行的,不过实现细节上有所区别
先来看下环绕实现
@Component@Aspectpublic class LogAspect { @Pointcut("@annotation(cn.xuhuanfeng.annnotation.LogInfo)") public void logPointCut(){} @Around(value = "logPointCut()") public Object logAround(ProceedingJoinPoint joinPoint) { // 获取执行方法签名,这里强转为MethodSignature MethodSignature signature = (MethodSignature) joinPoint.getSignature(); Object[] args = joinPoint.getArgs(); // 通过反射来获取注解内容 LogInfo loginfo = signature.getMethod().getAnnotation(LogInfo.class); String description = loginfo.value(); System.out.println("****** "+ description + " Before: " + signature + " args " + Arrays.toString(args)); Object result = null; long start = System.currentTimeMillis(); try { // 调用原来的方法 result = joinPoint.proceed(); } catch (Throwable throwable) { throwable.printStackTrace(); } long end = System.currentTimeMillis(); System.out.println("****** " + description +" After: " + signature + " " + result + "total time: " + (end - start) + " ms"); return result; } }
编写一个简单的操作类
@Servicepublic class BlogService { @LogInfo("获取博客") public String getBlog() { return "Blog info"; } @LogInfo("增加博客") public boolean addBlog(String blog) { System.out.println("adding blog"); return true; } }
对应的测试类如下
@SpringBootTest@RunWith(SpringRunner.class)public class BlogServiceTest { @Autowired private BlogService blogService; @Test public void getBlog() { blogService.getBlog(); } @Test public void addBlog() { blogService.addBlog("blog"); } }
运行结果
****** 增加博客 Before: boolean cn.xuhuanfeng.blog.BlogService.addBlog(String) args [blog] adding blog ****** 增加博客 After: boolean cn.xuhuanfeng.blog.BlogService.addBlog(String) truetotal time: 4 ms ****** 获取博客 Before: String cn.xuhuanfeng.blog.BlogService.getBlog() args [] ****** 获取博客 After: String cn.xuhuanfeng.blog.BlogService.getBlog() Blog infototal time: 0 ms
可以看到,我们所需要的功能已经成功通过AOP中的环绕实现了,既保持了代码的整洁性,以及模块性,又基本实现了功能
前置以及后置实现
除了上面环绕试下外,还可以通过前置以及后置增强来实现,如下所示
@Component@Aspectpublic class LogAspect { @Pointcut("@annotation(com.cmft.springbootdemo.annnotation.LogInfo)") public void logPointCut(){} // 通过ThreadLocal来记录进入方法的时间 private ThreadLocal<Long> logRecorder = new ThreadLocal<>(); private String getDescription(JoinPoint joinPoint) { MethodSignature methodSignature = (MethodSignature) joinPoint.getSignature(); return methodSignature.getMethod().getAnnotation(LogInfo.class).value(); } private long calculateExecutionTime() { long end = System.currentTimeMillis(); long duration = end - logRecorder.get(); logRecorder.remove(); return duration; } @Before("logPointCut()") public void beforeMethod(JoinPoint joinPoint) { logRecorder.set(System.currentTimeMillis()); String description = getDescription(joinPoint); System.out.println("****** "+ description + " Before: " + joinPoint.getSignature() + " args " + Arrays.toString(joinPoint.getArgs())); } @AfterReturning(value = "logPointCut()", returning = "result") public void afterReturning(JoinPoint joinPoint, Object result) { String description = getDescription(joinPoint); System.out.println("****** " + description + " After: " + joinPoint.getSignature() + " " + result + " total time: " + calculateExecutionTime() + " ms"); } }
作者:颜洛滨
链接:https://www.jianshu.com/p/f31ae6fe34e2