AopLog是一个用于记录请求方法日志的工具包，利用SpringAop和ThreadLocal实现。它简化了日志记录，支持自定义日志收集器，能够记录请求参数、响应、耗时等信息，并且可以在异常时记录堆栈信息。日志收集异步化，不影响方法执行性能。通过@AopLog注解，可以轻松控制日志记录，并使用LogData.step方法记录方法执行步骤。
点击上方“芋道源码”，选择“设为星标”
管她前浪，还是后浪？
能浪的浪，才是好浪！
每天 8:55 更新文章，每天掉亿点点头发...
源码精品专栏
来源：cnblogs.com/ealenxie/p/13685216.html
介绍
快速开始
项目通过maven的pom.xml引入
或者通过gradle引入
@AopLog注解使用，进行日志记录
自定义全局的日志收集器实现收集 LogCollector
记录的日志对象LogData属性说明
AopLog 注解选项说明
LogData的step方法。
关于
介绍
AopLog是基于Spring Aop 和ThreadLocal实现的一个专门对请求方法内容日志的拦截与处理的日志工具包。
场景 :
使用Spring Aop拦截参数日志目前大部分做法都基本上大同小异,不想日后每个项目工程都写一份这样的Aop拦截处理日志的代码,甚至代码侵入。
我想知道一些相对重要的请求方法的请求参数,响应参数,请求头,以及内部耗时,方法是成功还是失败等等信息。发生错误时我也不知道执行到哪一步发生了异常，是不是某个参数导致出的逻辑问题。
普通的log.info或warn信息没有所属请求的上下关系,并不方便查看和分析。
正式环境中,我并不想打印太多无意义的info日志(有些只是为了排查问题打印的日志,程序正常运行时其实毫无意义)，只希望在发生异常时记录日志或者只希望每次请求只记录一条关键的请求信息。
日志的收集,我希望将这些请求的日志记录下来，记录的实现方式我自己决定，比如正常的日志打印，常见的日志写入数据库，日志写入到文件，日志入队列等等。
整个日志的记录完全不干扰正常请求方法的流程,日志的收集处理异步化,完全不影响正常请求方法的性能与响应。
只需要通过
@AopLog注解决定是否记录。
快速开始
项目通过maven的pom.xml引入
<dependency>
<groupId>com.github.ealenxie</groupId>
<artifactId>aop-log</artifactId>
<version>2.1</version>
</dependency>
或者通过gradle引入
compile group: 'com.github.ealenxie', name: 'aop-log', version: '2.1'
@AopLog注解使用，进行日志记录
直接在类(作用类的所有方法)或类方法(作用于方法)上加上注解@AopLog,进行日志记录
例如 :
import com.github.AopLog;
import name.ealen.infra.base.resp.RespBody;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
/**
* @author EalenXie create on 2020/6/22 14:28
*/
@AopLog(type = "测试",stackTraceOnErr = true)
@RestController
public class AppController {
@GetMapping("/app/sayHello")
public RespBody<String> sayHello() {
return RespBody.ok("hello EalenXie");
}
}
自定义全局的日志收集器实现收集 LogCollector
例如只是简单打印,或写入到库等等。
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.github.LogData;
import com.github.collector.LogCollector;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
/**
* @author EalenXie create on 2020/9/15 13:46
* 此为样例参考
* 配置一个简单的日志收集器 这里只是做了一个log.info打印一下，可以在这里写入到数据库中或者写入
*/
@Slf4j
@Component
public class AopLogCollector implements LogCollector {
private ObjectMapper objectMapper = new ObjectMapper();
@Override
public void collect(LogData logData) {
try {
log.info(objectMapper.writeValueAsString(logData));
} catch (JsonProcessingException e) {
e.printStackTrace();
}
}
}
配置@Component的全局日志收集器只能配置一个。
接口调用 /say/hello 测试即可看看到控制台打印出结果 :
2020-09-16 16:01:04.782 INFO 2012 --- [AsyncExecutor-2] name.ealen.infra.advice.AopLogCollector : {"appName":"app-template","host":"127.0.0.1","port":8080,"clientIp":"192.168.110.1","reqUrl":"http://localhost:8080/app/sayHello","httpMethod":"GET","headers":{"User-Agent":"Apache-HttpClient/4.5.10 (Java/11.0.5)"},"type":"测试","content":"","method":"name.ealen.api.facade.AppController#sayHello","args":null,"respBody":{"code":"200","desc":"OK","message":"请求成功","dateTime":"2020-09-16 16:01:04","body":"hello EalenXie"},"logDate":1600243264780,"costTime":1,"threadName":"http-nio-8080-exec-3","threadId":33,"success":true}
记录的日志对象LogData属性说明
LogData 记录的内容
| 字段 | 类型 | 注释 |
|---|---|---|
| appName | String | 应用名称 |
| host | String | 主机 |
| port | int | 端口号 |
| clientIp | String | 请求客户端的Ip |
| reqUrl | String | 请求地址 |
| headers | Object | 请求头部信息(可选择记录) 默认记录user-agent,content-type |
| type | String | 操作类型,默认值undefined |
| content | String | 方法步骤内容,默认是空,可使用LogData.step进行内容步骤记录 |
| method | String | 请求的本地java方法 |
| args | Object | 方法请求参数 |
| respBody | Object | 方法响应参数 |
| costTime | long | 整个方法耗时 |
| logDate | Date | Log产生时间,LogData对象初始化的时间 |
| threadName | String | 线程名称 |
| threadId | long | 线程Id |
| success | boolean | 执行状态,成功(true)/异常(false) |
AopLog 注解选项说明
| 选项 | 类型 | 说明 | 默认 |
|---|---|---|---|
| logOnErr | boolean | 仅当发生异常时才记录收集 | false |
| type | String | 操作类型 | 默认值"undefined" |
| headers | String[] | 记录的header信息 ,选择要记录哪些header信息 | 默认"User-Agent","content-type" |
| args | boolean | 是否记录请求参数 | true |
| respBody | boolean | 是否记录响应参数 | true |
| stackTraceOnErr | boolean | 当目标方法发生异常时,是否追加异常堆栈信息到LogData的content中 | false |
| asyncMode | boolean | 异步方式收集 | true |
| collector | Class<? extends LogCollector> | 指定日志收集器 | 默认不调整收集器,使用全局的日志收集器 |
LogData的step方法。
记录步骤。(如果某些重要步骤希望被记录下来) 例如 :
import com.github.AopLog;
import com.github.LogData;
import name.ealen.infra.base.resp.RespBody;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
/**
* @author EalenXie create on 2020/6/22 14:28
*/
@AopLog(type = "测试",stackTraceOnErr = true)
@RestController
public class AppController {
@GetMapping("/app/sayHello")
public RespBody<String> sayHello() {
LogData.step("1. 第一步执行完成");
//......
LogData.step("2. 第二步执行完成");
//.....
LogData.step("3. service的方法执行完成");
//.....
return RespBody.ok("hello EalenXie");
}
}
注意: 此方法如果不在被@AopLog注解的方法的整体调用链路中使用，则当前线程中的ThreadLocal中的LogData不会释放，需要手动调用LogData.removeCurrent();
此时再次接口调用 /say/hello 测试即可看看到控制台打印出结果，重点观察content字段 :
2020-09-16 17:26:20.285 INFO 3284 --- [AsyncExecutor-2] name.ealen.infra.advice.AopLogCollector : {"appName":"app-template","host":"127.0.0.1","port":8080,"clientIp":"192.168.110.1","reqUrl":"http://localhost:8080/app/sayHello","httpMethod":"GET","headers":{"User-Agent":"Apache-HttpClient/4.5.10 (Java/11.0.5)"},"type":"测试","content":"1. 第一步执行完成\n2. 第二步执行完成\n3. service的方法执行完成\n","method":"name.ealen.api.facade.AppController#sayHello","args":null,"respBody":{"code":"200","desc":"OK","message":"请求成功","dateTime":"2020-09-16 17:26:20","body":"hello EalenXie"},"logDate":1600248380283,"costTime":1,"threadName":"http-nio-8080-exec-2","threadId":32,"success":true}
关于
开源Github地址 : https://github.com/EalenXie/aop-log
欢迎加入我的知识星球，一起探讨架构，交流源码。加入方式，长按下方二维码噢：
已在知识星球更新源码解析如下：
最近更新《芋道 SpringBoot 2.X 入门》系列，已经 20 余篇，覆盖了 MyBatis、Redis、MongoDB、ES、分库分表、读写分离、SpringMVC、Webflux、权限、WebSocket、Dubbo、RabbitMQ、RocketMQ、Kafka、性能测试等等内容。
提供近 3W 行代码的 SpringBoot 示例，以及超 4W 行代码的电商微服务项目。
获取方式：点“在看”，关注公众号并回复 666 领取，更多内容陆续奉上。
兄弟，艿一口，点个赞！????
扫一扫
2765
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
