SpringBoot開發(fā)技巧之使用AOP記錄日志示例解析
為什么要用AOP?
答案是解耦!
Aspect Oriented Programming 面向切面編程。解耦是程序員編碼開發(fā)過程中一直追求的。AOP也是為了解耦所誕生。
具體思想是:定義一個切面,在切面的縱向定義處理方法,處理完成之后,回到橫向業(yè)務流。
AOP 主要是利用代理模式的技術來實現(xiàn)的。
具體的代理實現(xiàn)可以參考這篇文章,講解的非常詳細。http://www.fzitv.net/article/130525.htm
通過預編譯方式和運行期動態(tài)代理實現(xiàn)程序功能的統(tǒng)一維護的一種技術。利用 AOP 可以對業(yè)務邏輯的各個部分進行隔離,從而使得業(yè)務邏輯各部分之間的耦合度降低,提高程序的可重用性,同時提高了開發(fā)的效率。
常用的工作場景
事務控制
日志記錄
本文沒有過度深度學習原理,因為是菜鳥一個,先學會怎么不加班。
必須知道的概念
AOP 的相關術語
通知(Advice)
通知描述了切面要完成的工作以及何時執(zhí)行。比如我們的日志切面需要記錄每個接口調(diào)用時長,就需要在接口調(diào)用前后分別記錄當前時間,再取差值。
- 前置通知(Before):在目標方法調(diào)用前調(diào)用通知功能;
- 后置通知(After):在目標方法調(diào)用之后調(diào)用通知功能,不關心方法的返回結(jié)果;
- 返回通知(AfterReturning):在目標方法成功執(zhí)行之后調(diào)用通知功能;
- 異常通知(AfterThrowing):在目標方法拋出異常后調(diào)用通知功能;
- 環(huán)繞通知(Around):通知包裹了目標方法,在目標方法調(diào)用之前和之后執(zhí)行自定義的行為。
連接點(JoinPoint)
通知功能被應用的時機。比如接口方法被調(diào)用的時候就是日志切面的連接點。
切點(Pointcut)
切點定義了通知功能被應用的范圍。比如日志切面的應用范圍就是所有接口,即所有 controller 層的接口方法。
切面(Aspect)
切面是通知和切點的結(jié)合,定義了何時、何地應用通知功能。
引入(Introduction)
在無需修改現(xiàn)有類的情況下,向現(xiàn)有的類添加新方法或?qū)傩浴?/p>
織入(Weaving)
把切面應用到目標對象并創(chuàng)建新的代理對象的過程。
Spring 中使用注解創(chuàng)建切面
相關注解
@Aspect:用于定義切面
@Before:通知方法會在目標方法調(diào)用之前執(zhí)行
@After:通知方法會在目標方法返回或拋出異常后執(zhí)行
@AfterReturning:通知方法會在目標方法返回后執(zhí)行
@AfterThrowing:通知方法會在目標方法拋出異常后執(zhí)行
@Around:通知方法會將目標方法封裝起來
@Pointcut:定義切點表達式
切點表達式
指定了通知被應用的范圍,表達式格式:
execution (方法修飾符 返回類型 方法所屬的包.類名.方法名稱(方法參數(shù)) //com.ninesky.study.tiny.controller包中所有類的public方法都應用切面里的通知 execution(public * com.ninesky.study.tiny.controller.*.*(..)) //com.ninesky.study.tiny.service包及其子包下所有類中的所有方法都應用切面里的通知 execution(* com.ninesky.study.tiny.service..*.*(..)) //com.ninesky.study.tiny.service.PmsBrandService類中的所有方法都應用切面里的通知 execution(* com.macro.ninesky.study.service.PmsBrandService.*(..))
實戰(zhàn)應用-利用AOP記錄日志
從傳統(tǒng)行業(yè)轉(zhuǎn)行,以前都沒想過打日志埋點,第一份工作,真的應該選擇一個好的平臺比較重要。
定義日志信息封裝
用于封裝需要記錄的日志信息,包括操作的描述、時間、消耗時間、url、請求參數(shù)和返回結(jié)果等信息
public class WebLog {
/**
* 操作描述
*/
private String description;
/**
* 操作用戶
*/
private String username;
/**
* 操作時間
*/
private Long startTime;
/**
* 消耗時間
*/
private Integer spendTime;
/**
* 根路徑
*/
private String basePath;
/**
* URI
*/
private String uri;
/**
* URL
*/
private String url;
/**
* 請求類型
*/
private String method;
/**
* IP地址
*/
private String ip;
/**
* 請求參數(shù)
*/
private Object parameter;
/**
* 請求返回的結(jié)果
*/
private Object result;
//省略了getter,setter方法
}
定義注解,通過注解減少代碼量
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface OperationLog {
String name();//調(diào)用接口的名稱
boolean intoDb() default false;//該條操作日志是否需要持久化存儲
}
統(tǒng)一日志處理切面
@Aspect
@Component
@Order(1)
@Slf4j
public class WebLogAspect {
private static final Logger controlLog = LoggerFactory.getLogger("tmall_control");
@Pointcut("execution(public * com.yee.walnut.*.*.*(..))")
public void webLog() {
}
@Before(value = "webLog()&& @annotation(OperationLog)")
public void doBefore(ControllerWebLog controllerWebLog) throws Throwable {
}
@AfterReturning(value = "webLog()&& @annotation(OperationLog)", returning = "ret")
public void doAfterReturning(Object ret, ControllerWebLog controllerWebLog) throws Throwable {
}
@Around(value = "webLog()&& @annotation(OperationLog)")
public Object doAround(ProceedingJoinPoint joinPoint, OperationLog operationLog) throws Throwable {
long startTime = System.currentTimeMillis();
//獲取當前請求對象
ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
HttpServletRequest request = attributes.getRequest();
//記錄請求信息
Object[] objs = joinPoint.getArgs();
WebLog webLog = new WebLog();
Object result = joinPoint.proceed();//返回的結(jié)果,這是一個進入方法和退出方法的一個分界
Signature signature = joinPoint.getSignature();
MethodSignature methodSignature = (MethodSignature) signature;
Method method = methodSignature.getMethod();
long endTime = System.currentTimeMillis();
String urlStr = request.getRequestURL().toString();
webLog.setBasePath(StrUtil.removeSuffix(urlStr, URLUtil.url(urlStr).getPath()));
webLog.setIp(request.getRemoteUser());
webLog.setMethod(request.getMethod());
webLog.setParameter(getParameter(method, joinPoint.getArgs()));
webLog.setResult(JSONUtil.parse(result));
webLog.setSpendTime((int) (endTime - startTime));
webLog.setStartTime(startTime);
webLog.setUri(request.getRequestURI());
webLog.setUrl(request.getRequestURL().toString());
controlLog.info("RequestAndResponse {}", JSONObject.toJSONString(webLog));
//必須有這個返回值??梢赃@樣理解,Around方法之后,不再是被織入的函數(shù)返回值,而是Around函數(shù)返回值
return result;
}
/**
* 根據(jù)方法和傳入的參數(shù)獲取請求參數(shù)
*/
private Object getParameter(Method method, Object[] args) {
List<Object> argList = new ArrayList<>();
Parameter[] parameters = method.getParameters();
for (int i = 0; i < parameters.length; i++) {
//將RequestBody注解修飾的參數(shù)作為請求參數(shù)
RequestBody requestBody = parameters[i].getAnnotation(RequestBody.class);
if (requestBody != null) {
argList.add(args[i]);
}
//將RequestParam注解修飾的參數(shù)作為請求參數(shù)
RequestParam requestParam = parameters[i].getAnnotation(RequestParam.class);
if (requestParam != null) {
Map<String, Object> map = new HashMap<>();
String key = parameters[i].getName();
if (!StringUtils.isEmpty(requestParam.value())) {
key = requestParam.value();
}
map.put(key, args[i]);
argList.add(map);
} else {
argList.add(args[i]);
}
}
if (argList.size() == 0) {
return null;
} else if (argList.size() == 1) {
return argList.get(0);
} else {
return argList;
}
}
}
在方法上加上自定義注解即可
@OperationLog(name = "TurnOnOffStrategy")
public String doOperation(GlobalDto globalDto, DeviceOperator deviceOperator) {
}
以上就是SpringBoot開發(fā)技巧之利用AOP記錄日志示例解析的詳細內(nèi)容,更多關于SpringBoot開發(fā)AOP記錄日志的資料請關注腳本之家其它相關文章!
相關文章
Java實現(xiàn)自定義LinkedList類的示例代碼
LinkedList類跟ArrayList類不同,它通過指針以及結(jié)點的操作對鏈表進行增刪改查。本文就來和大家分享下Java如何為實現(xiàn)自定義LinkedList類,需要的可以參考一下2022-08-08
Springboot內(nèi)外部logback多環(huán)境配置詳解
本文主要介紹了Springboot內(nèi)外部logback多環(huán)境配置詳解,文中通過示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下2022-01-01

