使用SpringBoot AOP 記錄操作日志贩猎、異常日志。

平時我們在做項目時經(jīng)常需要對一些重要功能操作記錄日志萍膛,方便以后跟蹤是誰在操作此功能吭服;我們在操作某些功能時也有可能會發(fā)生異常,但是每次發(fā)生異常要定位原因我們都要到服務(wù)器去查詢?nèi)罩静拍苷业交嚷蓿乙膊荒軐Πl(fā)生的異常進行統(tǒng)計艇棕,從而改進我們的項目,要是能做個功能專門來記錄操作日志和異常日志那就好了串塑。

當(dāng)然我們肯定有方法來做這件事情沼琉,而且也不會很難,我們可以在需要的方法中增加記錄日志的代碼桩匪,和在每個方法中增加記錄異常的代碼打瘪,最終把記錄的日志存到數(shù)據(jù)庫中。聽起來好像很容易傻昙,但是我們做起來會發(fā)現(xiàn)闺骚,做這項工作很繁瑣,而且都是在做一些重復(fù)性工作妆档,還增加大量冗余代碼僻爽,這種方式記錄日志肯定是不可行的。

我們以前學(xué)過Spring 三大特性贾惦,IOC(控制反轉(zhuǎn))胸梆,DI(依賴注入)敦捧,AOP(面向切面),那其中AOP的主要功能就是將日志記錄乳绕,性能統(tǒng)計绞惦,安全控制,事務(wù)處理洋措,異常處理等代碼從業(yè)務(wù)邏輯代碼中劃分出來。今天我們就來用springBoot Aop 來做日志記錄杰刽,好了菠发,廢話說了一大堆還是上貨吧。

一贺嫂、創(chuàng)建日志記錄表滓鸠、異常日志表,表結(jié)構(gòu)如下:

操作日志表

image

異常日志表

二第喳、添加Maven依賴

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

三糜俗、創(chuàng)建操作日志注解類OperLog.java

package com.hyd.zcar.cms.common.utils.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 自定義操作日志注解
 * @author wu
 */
@Target(ElementType.METHOD) //注解放置的目標(biāo)位置,METHOD是可注解在方法級別上
@Retention(RetentionPolicy.RUNTIME) //注解在哪個階段執(zhí)行
@Documented
public @interface OperLog {
    String operModul() default ""; // 操作模塊
    String operType() default "";  // 操作類型
    String operDesc() default "";  // 操作說明
}

四、創(chuàng)建切面類記錄操作日志

package com.hyd.zcar.cms.common.utils.aop;

import java.lang.reflect.Method;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;

import javax.servlet.http.HttpServletRequest;

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.AfterReturning;
import org.aspectj.lang.annotation.AfterThrowing;
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.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.RequestAttributes;
import org.springframework.web.context.request.RequestContextHolder;

import com.gexin.fastjson.JSON;
import com.hyd.zcar.cms.common.utils.IPUtil;
import com.hyd.zcar.cms.common.utils.annotation.OperLog;
import com.hyd.zcar.cms.common.utils.base.UuidUtil;
import com.hyd.zcar.cms.common.utils.security.UserShiroUtil;
import com.hyd.zcar.cms.entity.system.log.ExceptionLog;
import com.hyd.zcar.cms.entity.system.log.OperationLog;
import com.hyd.zcar.cms.service.system.log.ExceptionLogService;
import com.hyd.zcar.cms.service.system.log.OperationLogService;

/**
 * 切面處理類曲饱,操作日志異常日志記錄處理
 *
 * @author wu
 * @date 2019/03/21
 */
@Aspect
@Component
public class OperLogAspect {

    /**
     * 操作版本號
     * <p>
     * 項目啟動時從命令行傳入悠抹,例如:java -jar xxx.war --version=201902
     * </p>
     */
    @Value("${version}")
    private String operVer;

    @Autowired
    private OperationLogService operationLogService;

    @Autowired
    private ExceptionLogService exceptionLogService;

    /**
     * 設(shè)置操作日志切入點 記錄操作日志 在注解的位置切入代碼
     */
    @Pointcut("@annotation(com.hyd.zcar.cms.common.utils.annotation.OperLog)")
    public void operLogPoinCut() {
    }

    /**
     * 設(shè)置操作異常切入點記錄異常日志 掃描所有controller包下操作
     */
    @Pointcut("execution(* com.hyd.zcar.cms.controller..*.*(..))")
    public void operExceptionLogPoinCut() {
    }

    /**
     * 正常返回通知,攔截用戶操作日志扩淀,連接點正常執(zhí)行完成后執(zhí)行楔敌, 如果連接點拋出異常,則不會執(zhí)行
     *
     * @param joinPoint 切入點
     * @param keys      返回結(jié)果
     */
    @AfterReturning(value = "operLogPoinCut()", returning = "keys")
    public void saveOperLog(JoinPoint joinPoint, Object keys) {
        // 獲取RequestAttributes
        RequestAttributes requestAttributes = RequestContextHolder.getRequestAttributes();
        // 從獲取RequestAttributes中獲取HttpServletRequest的信息
        HttpServletRequest request = (HttpServletRequest) requestAttributes
                .resolveReference(RequestAttributes.REFERENCE_REQUEST);

        OperationLog operlog = new OperationLog();
        try {
            operlog.setOperId(UuidUtil.get32UUID()); // 主鍵ID

            // 從切面織入點處通過反射機制獲取織入點處的方法
            MethodSignature signature = (MethodSignature) joinPoint.getSignature();
            // 獲取切入點所在的方法
            Method method = signature.getMethod();
            // 獲取操作
            OperLog opLog = method.getAnnotation(OperLog.class);
            if (opLog != null) {
                String operModul = opLog.operModul();
                String operType = opLog.operType();
                String operDesc = opLog.operDesc();
                operlog.setOperModul(operModul); // 操作模塊
                operlog.setOperType(operType); // 操作類型
                operlog.setOperDesc(operDesc); // 操作描述
            }
            // 獲取請求的類名
            String className = joinPoint.getTarget().getClass().getName();
            // 獲取請求的方法名
            String methodName = method.getName();
            methodName = className + "." + methodName;

            operlog.setOperMethod(methodName); // 請求方法

            // 請求的參數(shù)
            Map<String, String> rtnMap = converMap(request.getParameterMap());
            // 將參數(shù)所在的數(shù)組轉(zhuǎn)換成json
            String params = JSON.toJSONString(rtnMap);

            operlog.setOperRequParam(params); // 請求參數(shù)
            operlog.setOperRespParam(JSON.toJSONString(keys)); // 返回結(jié)果
            operlog.setOperUserId(UserShiroUtil.getCurrentUserLoginName()); // 請求用戶ID
            operlog.setOperUserName(UserShiroUtil.getCurrentUserName()); // 請求用戶名稱
            operlog.setOperIp(IPUtil.getRemortIP(request)); // 請求IP
            operlog.setOperUri(request.getRequestURI()); // 請求URI
            operlog.setOperCreateTime(new Date()); // 創(chuàng)建時間
            operlog.setOperVer(operVer); // 操作版本
            operationLogService.insert(operlog);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    /**
     * 異常返回通知驻谆,用于攔截異常日志信息 連接點拋出異常后執(zhí)行
     *
     * @param joinPoint 切入點
     * @param e         異常信息
     */
    @AfterThrowing(pointcut = "operExceptionLogPoinCut()", throwing = "e")
    public void saveExceptionLog(JoinPoint joinPoint, Throwable e) {
        // 獲取RequestAttributes
        RequestAttributes requestAttributes = RequestContextHolder.getRequestAttributes();
        // 從獲取RequestAttributes中獲取HttpServletRequest的信息
        HttpServletRequest request = (HttpServletRequest) requestAttributes
                .resolveReference(RequestAttributes.REFERENCE_REQUEST);

        ExceptionLog excepLog = new ExceptionLog();
        try {
            // 從切面織入點處通過反射機制獲取織入點處的方法
            MethodSignature signature = (MethodSignature) joinPoint.getSignature();
            // 獲取切入點所在的方法
            Method method = signature.getMethod();
            excepLog.setExcId(UuidUtil.get32UUID());
            // 獲取請求的類名
            String className = joinPoint.getTarget().getClass().getName();
            // 獲取請求的方法名
            String methodName = method.getName();
            methodName = className + "." + methodName;
            // 請求的參數(shù)
            Map<String, String> rtnMap = converMap(request.getParameterMap());
            // 將參數(shù)所在的數(shù)組轉(zhuǎn)換成json
            String params = JSON.toJSONString(rtnMap);
            excepLog.setExcRequParam(params); // 請求參數(shù)
            excepLog.setOperMethod(methodName); // 請求方法名
            excepLog.setExcName(e.getClass().getName()); // 異常名稱
            excepLog.setExcMessage(stackTraceToString(e.getClass().getName(), e.getMessage(), e.getStackTrace())); // 異常信息
            excepLog.setOperUserId(UserShiroUtil.getCurrentUserLoginName()); // 操作員ID
            excepLog.setOperUserName(UserShiroUtil.getCurrentUserName()); // 操作員名稱
            excepLog.setOperUri(request.getRequestURI()); // 操作URI
            excepLog.setOperIp(IPUtil.getRemortIP(request)); // 操作員IP
            excepLog.setOperVer(operVer); // 操作版本號
            excepLog.setOperCreateTime(new Date()); // 發(fā)生異常時間

            exceptionLogService.insert(excepLog);

        } catch (Exception e2) {
            e2.printStackTrace();
        }

    }

    /**
     * 轉(zhuǎn)換request 請求參數(shù)
     *
     * @param paramMap request獲取的參數(shù)數(shù)組
     */
    public Map<String, String> converMap(Map<String, String[]> paramMap) {
        Map<String, String> rtnMap = new HashMap<String, String>();
        for (String key : paramMap.keySet()) {
            rtnMap.put(key, paramMap.get(key)[0]);
        }
        return rtnMap;
    }

    /**
     * 轉(zhuǎn)換異常信息為字符串
     *
     * @param exceptionName    異常名稱
     * @param exceptionMessage 異常信息
     * @param elements         堆棧信息
     */
    public String stackTraceToString(String exceptionName, String exceptionMessage, StackTraceElement[] elements) {
        StringBuffer strbuff = new StringBuffer();
        for (StackTraceElement stet : elements) {
            strbuff.append(stet + "\n");
        }
        String message = exceptionName + ":" + exceptionMessage + "\n\t" + strbuff.toString();
        return message;
    }
}

五卵凑、在Controller層方法添加@OperLog注解

六、操作日志胜臊、異常日志查詢功能

image
image
image

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末勺卢,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子象对,更是在濱河造成了極大的恐慌黑忱,老刑警劉巖,帶你破解...
    沈念sama閱讀 211,194評論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件织盼,死亡現(xiàn)場離奇詭異杨何,居然都是意外死亡,警方通過查閱死者的電腦和手機沥邻,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,058評論 2 385
  • 文/潘曉璐 我一進店門危虱,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人唐全,你說我怎么就攤上這事埃跷∪镧瑁” “怎么了?”我有些...
    開封第一講書人閱讀 156,780評論 0 346
  • 文/不壞的土叔 我叫張陵弥雹,是天一觀的道長垃帅。 經(jīng)常有香客問我,道長剪勿,這世上最難降的妖魔是什么贸诚? 我笑而不...
    開封第一講書人閱讀 56,388評論 1 283
  • 正文 為了忘掉前任,我火速辦了婚禮厕吉,結(jié)果婚禮上酱固,老公的妹妹穿的比我還像新娘。我一直安慰自己头朱,他們只是感情好运悲,可當(dāng)我...
    茶點故事閱讀 65,430評論 5 384
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著项钮,像睡著了一般班眯。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上烁巫,一...
    開封第一講書人閱讀 49,764評論 1 290
  • 那天署隘,我揣著相機與錄音,去河邊找鬼程拭。 笑死定踱,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的恃鞋。 我是一名探鬼主播崖媚,決...
    沈念sama閱讀 38,907評論 3 406
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼恤浪!你這毒婦竟也來了畅哑?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 37,679評論 0 266
  • 序言:老撾萬榮一對情侶失蹤水由,失蹤者是張志新(化名)和其女友劉穎荠呐,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體砂客,經(jīng)...
    沈念sama閱讀 44,122評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡泥张,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,459評論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了鞠值。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片媚创。...
    茶點故事閱讀 38,605評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖彤恶,靈堂內(nèi)的尸體忽然破棺而出钞钙,到底是詐尸還是另有隱情鳄橘,我是刑警寧澤,帶...
    沈念sama閱讀 34,270評論 4 329
  • 正文 年R本政府宣布芒炼,位于F島的核電站瘫怜,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏本刽。R本人自食惡果不足惜鲸湃,卻給世界環(huán)境...
    茶點故事閱讀 39,867評論 3 312
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望盅安。 院中可真熱鬧唤锉,春花似錦、人聲如沸别瞭。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,734評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽蝙寨。三九已至,卻和暖如春嗤瞎,著一層夾襖步出監(jiān)牢的瞬間墙歪,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,961評論 1 265
  • 我被黑心中介騙來泰國打工贝奇, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留虹菲,地道東北人。 一個月前我還...
    沈念sama閱讀 46,297評論 2 360
  • 正文 我出身青樓掉瞳,卻偏偏與公主長得像毕源,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子陕习,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 43,472評論 2 348