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