Springboot中Aspect切面的實現方式(以記錄日志為例)
今天我們來說說spring中的切面Aspect,這是Spring的一大優勢。面向切面編程往往讓我們的開發更加低耦合,也大大減少了代碼量,同時呢讓我們更專注于業務模塊的開發,把那些與業務無關的東西提取出去,便于后期的維護和迭代。
好了,廢話少說!我們直接步入正題
以系統日志為例首先,我們先做一些準備工作。
1、新建一個Springboot工程
2、添加必要的依賴
AOP 必須
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId></dependency>
gson主要是我用于數據的處理,不是必須的
<dependency> <groupId>com.google.code.gson</groupId> <artifactId>gson</artifactId> <version>2.8.1</version></dependency>
個人喜好
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <scope>runtime</scope></dependency><dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional></dependency>
3、日志實體類和service
package com.space.aspect.bo; import lombok.Data; /** * 系統日志bo * @author zhuzhe * @date 2018/6/4 9:36 * @email [email protected] */@Datapublic class SysLogBO { private String className; private String methodName; private String params; private Long exeuTime; private String remark; private String createDate;}package com.space.aspect.service; import com.space.aspect.bo.SysLogBO;import lombok.extern.slf4j.Slf4j;import org.springframework.stereotype.Service; /** * @author zhuzhe * @date 2018/6/4 9:41 * @email [email protected] */@Slf4j@Servicepublic class SysLogService { public boolean save(SysLogBO sysLogBO){// 這里就不做具體實現了log.info(sysLogBO.getParams());return true; }}
4、定義日志注解
這里呢,我們記錄日志使用注解的形式。所以,先定義一個注解
package com.space.aspect.anno;import java.lang.annotation.*; /** * 定義系統日志注解 * @author zhuzhe * @date 2018/6/4 9:24 * @email [email protected] */@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)@Documentedpublic @interface SysLog { String value() default '';}
5、聲明切面,完成日志記錄
以上4點我們的準備工作已經完成。接下來就是重點了
這里需要你對AOP有一定的了解。起碼知道切點表達式、環繞通知、前置通知、后置通知等。。。
package com.space.aspect.aspect;import com.google.gson.Gson;import com.space.aspect.anno.SysLog;import com.space.aspect.bo.SysLogBO;import com.space.aspect.service.SysLogService;import org.aspectj.lang.ProceedingJoinPoint;import org.aspectj.lang.annotation.Around;import org.aspectj.lang.annotation.Aspect;import org.aspectj.lang.annotation.Pointcut;import org.aspectj.lang.reflect.MethodSignature;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Component;import java.lang.reflect.Method;import java.text.SimpleDateFormat;import java.util.ArrayList;import java.util.Date;import java.util.List; /** * 系統日志切面 * @author zhuzhe * @date 2018/6/4 9:27 * @email [email protected] */@Aspect // 使用@Aspect注解聲明一個切面@Componentpublic class SysLogAspect { @Autowired private SysLogService sysLogService; /** * 這里我們使用注解的形式 * 當然,我們也可以通過切點表達式直接指定需要攔截的package,需要攔截的class 以及 method * 切點表達式: execution(...) */ @Pointcut('@annotation(com.space.aspect.anno.SysLog)') public void logPointCut() {} /** * 環繞通知 @Around , 當然也可以使用 @Before (前置通知) @After (后置通知) * @param point * @return * @throws Throwable */ @Around('logPointCut()') public Object around(ProceedingJoinPoint point) throws Throwable {long beginTime = System.currentTimeMillis();Object result = point.proceed();long time = System.currentTimeMillis() - beginTime;try { saveLog(point, time);} catch (Exception e) {}return result; } /** * 保存日志 * @param joinPoint * @param time */ private void saveLog(ProceedingJoinPoint joinPoint, long time) {MethodSignature signature = (MethodSignature) joinPoint.getSignature();Method method = signature.getMethod();SysLogBO sysLogBO = new SysLogBO();sysLogBO.setExeuTime(time);SimpleDateFormat dateFormat = new SimpleDateFormat('yyyy-MM-dd hh:mm:ss');sysLogBO.setCreateDate(dateFormat.format(new Date()));SysLog sysLog = method.getAnnotation(SysLog.class);if(sysLog != null){ //注解上的描述 sysLogBO.setRemark(sysLog.value());}//請求的 類名、方法名String className = joinPoint.getTarget().getClass().getName();String methodName = signature.getName();sysLogBO.setClassName(className);sysLogBO.setMethodName(methodName);//請求的參數Object[] args = joinPoint.getArgs();try{ List<String> list = new ArrayList<String>(); for (Object o : args) {list.add(new Gson().toJson(o)); } sysLogBO.setParams(list.toString());}catch (Exception e){ }sysLogService.save(sysLogBO); }}
6、測試
接下來,我們就來測試一下吧
package com.space.aspect.controller;import com.space.aspect.anno.SysLog;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.RequestParam;import org.springframework.web.bind.annotation.RestController; /** * @author zhuzhe * @date 2018/6/4 9:47 * @email [email protected] */@RestControllerpublic class TestController { @SysLog('測試') @GetMapping('/test') public String test(@RequestParam('name') String name){return name; }}
啟動項目,訪問我們的test方法。
我們在service里打一個斷點
可以看到,我們所需要的值都成功拿到了。
這樣,我們就成功實現了使用Aspect實現切面記錄日志。
源碼:https://github.com/zhuzhegithub/springboot-aop-aspect
Springboot Aspect切面實現方法日志打印項目每次寫controller方法,都要在開始和結束打印一行日志表示方法開始和結束,每個方法都要寫,太過于麻煩和重復,想到了spring的aop切面,所以使用@Aspect切面和自定義log注解實現了下切面日志打印.
AOPAOP(Aspect Orient Programming),直譯過來就是 面向切面編程。AOP 是一種編程思想,是面向對象編程(OOP)的一種補充,在程序開發中主要用來解決一些系統層面上的問題,比如日志,事務,權限等等,這里主要是做一下方法的日志打印。
aop相關注解:@Aspect:作用是把當前類標識為一個切面供容器讀取
@Pointcut:Pointcut是植入Advice的觸發條件。每個Pointcut的定義包括2部分,一是表達式,二是方法簽名。方法簽名必須是 public及void型。可以將Pointcut中的方法看作是一個被Advice引用的助記符,因為表達式不直觀,因此我們可以通過方法簽名的方式為 此表達式命名。因此Pointcut中的方法只需要方法簽名,而不需要在方法體內編寫實際代碼。
@Around:環繞增強,相當于MethodInterceptor
@AfterReturning:后置增強,相當于AfterReturningAdvice,方法正常退出時執行
@Before:標識一個前置增強方法,相當于BeforeAdvice的功能,相似功能的還有
@AfterThrowing:異常拋出增強,相當于ThrowsAdvice
@After: final增強,不管是拋出異常或者正常退出都會執行
自定義注解聲明一個注解要用到的東西
修飾符:訪問修飾符必須為public,不寫默認為pubic;
關鍵字:關鍵字為@interface;
注解名稱:注解名稱為自定義注解的名稱,使用時還會用到;
注解類型元素:注解類型元素是注解中內容,可以理解成自定義接口的實現部分;
代碼:自定義log注解代碼
/** * 日志注解 * * Target:用于明確注解用于目標類的哪個位置 * Retention:用于標識自定義注解的生命周期 * RUNTIME:生命周期持續到運行時,能夠通過反射獲取到 * Documented:用于標識自定義注解能夠使用javadoc命令生成關于注解的文檔 * * @author xxx * @date 2020/xx/xx */@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)@Documentedpublic @interface LogMessage { /** * 使用value值,在使用注解的時候,不需要寫@LogMessage(value=xxx),直接寫@LogMessage(xxx)即可 */ String value() default ''; /** * 別名使用value,所以在使用注解時,既可以寫@LogMessage(xxx),也可以寫@LogMessage(description=xxx) */ @AliasFor('value') String description() default ''; /** * 是否打印參數 */ boolean parameterPrint() default true;}
apsect切面類注解
/** * 日志切面類 * Aspect :作用是把當前類標識為一個切面供容器讀取 * * @author xxx * @date 2020/xx/xx */@Slf4j@Aspect@Componentpublic class LogAspect { /** * 前置增強,目標方法執行之前執行 * within:用于匹配所以持有指定注解類型內的方法 * annotation:用于匹配當前執行方法持有指定注解的方法 * within(com.xxx.xxx..*) com.xxx.xxx包及子包下的任何方法執行 * * @param joinPoint * @param logManage * @return void * @author xxx * @date 2020/xx/xx */ @Before('within(com.xxx.xxx..*) && @annotation(logManage)') public void addBeforeLogger(JoinPoint joinPoint, LogMessage logManage) {log.info('[{}] Start', logManage.value());// 處理參數try { if (logManage.parameterPrint()) {Object[] args = joinPoint.getArgs(); // 參數值String[] argNames = ((MethodSignature) joinPoint.getSignature()).getParameterNames();Map<String, Object> paramsMap = new HashMap<>();StringBuilder sb = new StringBuilder();if (args != null && args.length > 0) { for (int i = 0; i < args.length; i++) {paramsMap.put(argNames[i], args[i] != null ? args[i].toString() : ''); } for (Map.Entry<String, Object> entry : paramsMap.entrySet()) {sb.append(entry.getKey()).append(':').append(entry.getValue()).append(';'); }}log.info('[方法名稱:{},方法參數:{}', ((MethodSignature) joinPoint.getSignature()).getMethod().getName(), sb.toString()); }} catch (Exception e) { log.info('切面日志打印異常!');} } /** * 返回增強,目標方法正常執行完畢時執行 * * within:用于匹配所以持有指定注解類型內的方法 * annotation:于匹配當前執行方法持有指定注解的方法 * within(com.xxx.xxx..*) com.xxx.xxx 包及子包下的任何方法執行 * * @param joinPoint * @param logManage * @return void * @author xxx * @date 2020/xx/xx */ @AfterReturning('within(com.xxx.xxx..*) && @annotation(logManage)') public void addAfterReturningLogger(JoinPoint joinPoint, LogMessage logManage) {log.info('[{}] End', logManage.value()); }}
controller中使用
@LogMessage('測試日志打印')@GetMapping(value = '/test', produces = MediaType.APPLICATION_JSON_UTF8_VALUE)public void xxx() { log.info('test');}
這樣在方法執行前和返回后都會打印日志,只需要在想要打印日志的方法上添加@LogMessage('')注解就可以了。
以上為個人經驗,希望能給大家一個參考,也希望大家多多支持好吧啦網。
相關文章: