SpringBoot使用AOP记录请求日志和异常日志

• 本文基础WEB环境使用SpringBoot及Spring-Data-Jpa构建

• 关于SpringBoot及JPA用法本文不再过多讨论，下面是引入的jar：

  
  
   

  

  起步依赖
  
  
   

  

  web及aop依赖
  
  
   

  

  jpa依赖
  
  
   

  

  mysql驱动
• 本文着重AOP的使用，你也可以使用自己构建的环境

1. 由于本文中使用的JPA，因此首先创建保存日志及保存异常的实体类，如果你使用的是Mybatis，则需要首先创建表然后根据表来逆向生成实体类

• 保存日志的实体类：

  
  
   

  

  日志实体

• 保存异常的实体类：

  
  
   

  

  异常实体

2. 接下来我们定义一个Operation注解，用于声明在方法上描述此方法执行了什么操作：

   
   
    

   

   操作注解

• @Target 声明这是一个自定义注解类，ElementType.METHOD 表明此注解可声明在方法上
• @Retention 声明注解保留期限，RetentionPolicy.RUNTIME 表明此注解可保留至运行时，可以通过反射获取注解信息

3. 然后编写一个AOP切面类，由于使用的SpringBoot只要保证在Application子目录之下就被会自动扫描，所以只需要注解声明即可，并不需要额外配置

   
   
    

   

   请求切面

• @Aspect 声明这是一个切面类
• @Compoent 此类交由Spring容器管理

4. 定义请求日志切入点：

   
   
    

   

   切入点

• @PointCut 定义请求日志切入点，其切入点表达式有多种匹配方式，详细请自行参阅资料，此处切入点为所有声明@Operation注解的方法

5. 编写方法的前置通知：

   
   
    

   

   前置通知

• 前置通知在执行目标方法之前执行
• 在前置通知中设置请求日志信息，如开始时间，请求参数，注解内容等

6. 编写方法的返回通知：

   
   
    

   

   返回通知

• 返回通知，在目标方法正常结束之后执行
• 在返回通知中补充请求日志信息，如返回时间，方法耗时，返回值，并且保存日志信息

7. 编写方法的异常通知：

   
   
    

   

   异常通知

• 异常通知，在目标方法非正常结束，发生异常或者抛出异常时执行
• 在异常通知中设置异常信息，并将其保存

8. Spring AOP 共计五种通知，由于本文中只需要三种，其它两种只做简单介绍，如有兴趣请自行查阅资料

• 后置通知：在目标方法执行之后执行，与返回通知不同的是此通知无法拿到返回值，并且不管是否发生异常都会执行
• 环绕通知：围绕动态代理的全过程，需要携带ProceedingJoinPoint参数，并且必须有返回值，且ProceedingJoinPoint类型的参数可以决定是否执行目标方法

9. 在前置通知中设置请求日志信息的工具类：

• 获取请求IP

  
  
   

  

  获取请求IP

• 获取请求方式

  
  
   

  

  获取请求方式

• 获取切入点的参数信息

  
  
   

  

  获取切入点的参数信息
  
  
   

  

  获取切入点的参数信息

10. 编写一个简易Controoler，用于测试请求日志记录：

    
    
     

    

    测试请求日志

• 启动SpringBoot之后，访问测试请求日志的URL，查看请求日志表记录，可以看到日志已成功记录：

  
  
   

  

  请求成功
  
  
   

  

  请求日志表记录

• 接下来把测试请求日志的Controoler修改为抛出一个异常，测试异常记录：

 

测试异常日志

• 然后重新启动SpringBoot，再次访问刚才的URL，可以看到产生了异常：

  
  
   

  

  请求异常

• 再次查看请求日志表，发现还是一条记录，说明异常通知执行后并不会执行返回通知，这正是我们期望的结果：

  
  
   

  

  请求日志记录

• 然后我们再查看异常记录表，发现已经将异常记录：

  
  
   

  

  异常日志

至此，SpringBoot AOP记录请求日志和异常日志完成