Java SpringBoot项目怎么优雅的实现操作日志记录
导读:本文共5107.5字符,通常情况下阅读需要17分钟。同时您也可以点击右侧朗读,来听本文内容。按键盘←(左) →(右) 方向键可以翻页。
摘要:希望大家仔细阅读,能够学有所成!一、AOP是什么?AOP(Aspect-Oriented Programming:⾯向切⾯编程),说起AOP,几乎学过Spring框架的人都知道,它是Spring的三大核心思想之一(IOC:控制反转,DI:依赖注入,AOP:面向切面编程)。能够将那些与业务⽆关,却为业务模块所共同调⽤的逻辑或责任(例如事务处理、⽇志管理、权限控制等)封装起来,便于减少系统的重复代码,... ...
目录
(为您整理了一些要点),点击可以直达。希望大家仔细阅读,能够学有所成!
一、AOP是什么?
AOP(Aspect-Oriented Programming:⾯向切⾯编程),说起AOP,几乎学过Spring框架的人都知道,它是Spring的三大核心思想之一(IOC:控制反转,DI:依赖注入,AOP:面向切面编程)。能够将那些与业务⽆关,却为业务模块所共同调⽤的逻辑或责任(例如事务处理、⽇志管理、权限控制等)封装起来,便于减少系统的重复代码,降低模块间的耦合度,并有利于未来的可拓展性和可维护性。
二、AOP做了什么?
简单说来,AOP主要做三件事:
1、在哪里切入,也就是日志记录等非业务代码在哪些业务代码中执行。
2、在什么时候切入,是在业务代码执行前还是后。
3、切入后做什么事情,比如权限校验,日志记录等。
可以用一张图来理解:
图上的一个核心术语的说明:
Pointcut:切点,决定在何处切入业务代码中(即织入切面)。切点分为execution方式和annotation方式。execution方式:可以用路径表达式指定哪些类织入切面,annotation方式:可以指定被哪些注解修饰的代码织入切面。
Advice:处理,包括处理时机和处理内容。处理内容就是要做什么事,比如校验权限和记录日志。处理时机就是在什么时机执行处理内容,分为前置处理(即业务代码执行前)、后置处理(业务代码执行后)等。
Aspect:切面,即Pointcut和Advice。
Joint point:连接点,是程序执行的一个点。例如,一个方法的执行或者一个异常的处理。在 Spring AOP 中,一个连接点总是代表一个方法执行。
Weaving:织入,就是通过动态代理,在目标对象方法中执行处理内容的过程。
三、实现步骤
(1)自定义一个注解@Log (2)创建一个切面类,切点设置为拦截标注@Log的方法,截取传参,进行日志记录 (3)将@Log标注在接口上
具体的实现步骤如下:
1. 添加AOP依赖
代码如下(示例):
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-aop</artifactId>
</dependency>
2. 自定义一个日志注解
日志一般使用的是注解类型的切点表达式,我们先创建一个日志注解,当spring容器扫描到有此注解的方法就会进行增强。
代码如下(示例):
@Target({ElementType.PARAMETER,ElementType.METHOD})//注解放置的目标位置,PARAMETER:可用在参数上METHOD:可用在方法级别上
@Retention(RetentionPolicy.RUNTIME)//指明修饰的注解的生存周期RUNTIME:运行级别保留
@Documented
public@interfaceLog{/*
模块
*/
Stringtitle()default"";/*
功能
*/
publicBusinessTypebusinessType()defaultBusinessType.OTHER;/*
是否保存请求的参数
*/
publicbooleanisSaveRequestData()defaulttrue;/
是否保存响应的参数
/
publicbooleanisSaveResponseData()defaulttrue;
}
3. 切面声明
申明一个切面类,并交给Spring容器管理。
代码如下(示例):
@Aspect
@Component
@Slf4j
publicclassLogAspect{
@Autowired
privateIXlOperLogServiceoperLogService;
/
处理完请求后执行
@paramjoinPoint切点
*/
@AfterReturning(pointcut="@annotation(controllerLog)",returning="jsonResult")
publicvoiddoAfterReturnibng(JoinPointjoinPoint,LogcontrollerLog,ObjectjsonResult){
handleLog(joinPoint,controllerLog,null,jsonResult);
}
protectedvoidhandleLog(finalJoinPointjoinPoint,LogcontrollerLog,finalExceptione,ObjectjsonResult){
try{
//获取当前的用户
JwtUserloginUser=SecurityUtils.getLoginUser();//日志记录
XlOperLogoperLog=newXlOperLog();
operLog.setStatus(0);
//请求的IP地址
StringiP=ServletUtil.getClientIP(ServletUtils.getRequest());
if("0:0:0:0:0:0:0:1".equals(iP)){
iP="127.0.0.1";
}
operLog.setOperIp(iP);
operLog.setOperUrl(ServletUtils.getRequest().getRequestURI());
if(loginUser!=null){
operLog.setOperName(loginUser.getUsername());
}
if(e!=null){
operLog.setStatus(1);
operLog.setErrorMsg(StringUtils.substring(e.getMessage(),0,2000));
}
//设置方法名称
StringclassName=joinPoint.getTarget().getClass().getName();
StringmethodName=joinPoint.getSignature().getName();
operLog.setMethod(className+"."+methodName+"()");
operLog.setRequestMethod(ServletUtils.getRequest().getMethod());
operLog.setOperTime(newDate());
//处理设置注解上的参数
getControllerMethodDescription(joinPoint,controllerLog,operLog,jsonResult);
//保存数据库
operLogService.save(operLog);}catch(Exceptionexp){
log.error("异常信息:{}",exp.getMessage());
exp.printStackTrace();
}
}
/*
获取注解中对方法的描述信息用于Controller层注解
@paramlog日志
@paramoperLog操作日志
@throwsException
/
publicvoidgetControllerMethodDescription(JoinPointjoinPoint,Loglog,XlOperLogoperLog,ObjectjsonResult)throwsException{
//设置操作业务类型
operLog.setBusinessType(log.businessType().ordinal());
//设置标题
operLog.setTitle(log.title());
//是否需要保存request,参数和值
if(log.isSaveRequestData()){
//设置参数的信息
setRequestValue(joinPoint,operLog);
}
//是否需要保存response,参数和值
if(log.isSaveResponseData()&&StringUtils.isNotNull(jsonResult)){
operLog.setJsonResult(StringUtils.substring(JSON.toJSONString(jsonResult),0,2000));
}
}
/
获取请求的参数,放到log中
@paramoperLog操作日志
@throwsException异常
/
privatevoidsetRequestValue(JoinPointjoinPoint,XlOperLogoperLog)throwsException{
StringrequsetMethod=operLog.getRequestMethod();
if(HttpMethod.PUT.name().equals(requsetMethod)||HttpMethod.POST.name().equals(requsetMethod)){
Stringparsams=argsArrayToString(joinPoint.getArgs());
operLog.setOperParam(StringUtils.substring(parsams,0,2000));
}else{
Map<?,?>paramsMap=(Map<?,?>)ServletUtils.getRequest().getAttribute(HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE);
operLog.setOperParam(StringUtils.substring(paramsMap.toString(),0,2000));
}
}
/
参数拼装
/
privateStringargsArrayToString(Object[]paramsArray){
Stringparams="";
if(paramsArray!=null&¶msArray.length>0){
for(Objectobject:paramsArray){
//不为空并且是不需要过滤的对象
if(StringUtils.isNotNull(object)&&!isFilterObject(object)){
ObjectjsonObj=JSON.toJSON(object);
params+=jsonObj.toString()+"";
}
}
}
returnparams.trim();
}
/*
判断是否需要过滤的对象。
@paramobject对象信息。
@return如果是需要过滤的对象,则返回true;否则返回false。
*/
@SuppressWarnings("rawtypes")
publicbooleanisFilterObject(finalObjectobject){
Class<?>clazz=object.getClass();
if(clazz.isArray()){
returnclazz.getComponentType().isAssignableFrom(MultipartFile.class);
}elseif(Collection.class.isAssignableFrom(clazz)){
Collectioncollection=(Collection)object;
for(Objectvalue:collection){
returnvalueinstanceofMultipartFile;
}
}elseif(Map.class.isAssignableFrom(clazz)){
Mapmap=(Map)object;
for(Objectvalue:map.entrySet()){
Map.Entryentry=(Map.Entry)value;
returnentry.getValue()instanceofMultipartFile;
}
}
returnobjectinstanceofMultipartFile||objectinstanceofHttpServletRequest
||objectinstanceofHttpServletResponse||objectinstanceofBindingResult;
}
}
4. 标注在接口上
将自定义注解标注在需要记录操作日志的接口上,代码如下(示例):
@Log(title="代码生成",businessType=BusinessType.GENCODE)
@ApiOperation(value="批量生成代码")
@GetMapping("/download/batch")
publicvoidbatchGenCode(HttpServletResponseresponse,Stringtables)throwsIOException{
String[]tableNames=Convert.toStrArray(tables);
byte[]data=genTableService.downloadCode(tableNames);
genCode(response,data);
}
5. 实现的效果
执行相关操作就会记录日志,记录了一些基础信息存在数据表里。
Java SpringBoot项目怎么优雅的实现操作日志记录的详细内容,希望对您有所帮助,信息来源于网络。