腳本之家服務器常用軟件

快捷導航

SpringBoot中日志切面實現(xiàn)小結

更新時間：2024年11月18日 10:06:33 作者：這個名字應該沒人用吧

本文介紹了SpringBoot中日志切面實現(xiàn)小結,通過定義一個自定義注解和創(chuàng)建一個日志切面類,為方法添加日志記錄功能,感興趣的可以了解一下

在應用開發(fā)中，日志記錄對于監(jiān)控、調試和追蹤用戶行為至關重要。Spring Boot 雖然內置了強大的日志框架，但在某些情況下，我們可能需要更細粒度的日志管理。Spring AOP 提供了一種靈活的方式來實現(xiàn)方法級別的日志記錄，而無需侵入業(yè)務代碼。本文將介紹如何通過 Spring AOP 切面來實現(xiàn)這一功能。

什么是Spring AOP？

Spring AOP 是一個面向切面的編程（AOP）框架，它允許開發(fā)者將橫切關注點（如日志記錄、事務管理等）與業(yè)務邏輯分離。通過使用 Spring AOP，我們可以在不修改業(yè)務代碼的情況下，為應用程序添加日志記錄功能。

Spring AOP 詳細可以看這篇文章 Spring AOP入門

日志切面的設計

在我們的示例中，我們定義了一個 SysLog 注解，用于標記需要記錄日志的方法。接著，我們創(chuàng)建了一個日志切面 LogAspect，它會攔截所有帶有 SysLog 注解的方法，并記錄日志信息。

SysLog 注解

首先，我們定義了一個 SysLog 注解，它可以用來標記需要記錄日志的方法：

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface SysLog {
    String value() default "";
}

這個注解非常簡單，它只有一個 value 屬性，用于存儲日志的描述信息。

日志切面 LogAspect

接下來，我們創(chuàng)建了 LogAspect 切面類，它會攔截所有帶有 SysLog 注解的方法：

@Aspect
@Component
public class LogAspect {
    // 省略其他成員變量和方法

    @Around("@annotation(sysLog)")
    public Object logAround(ProceedingJoinPoint joinPoint, SysLog sysLog) throws Throwable {
        // 日志記錄邏輯
    }
}

在這個切面中，我們使用了 @Around 注解來定義一個環(huán)繞通知，它會在目標方法執(zhí)行前后記錄日志信息。

日志記錄的實現(xiàn)

在 LogAspect 切面類中，我們實現(xiàn)了 logAround 方法，它會在目標方法執(zhí)行前后記錄日志信息：

@Around("@annotation(sysLog)")
public Object logAround(ProceedingJoinPoint joinPoint, SysLog sysLog) throws Throwable {
    Log log = new Log();
    log.setTimestamp(new Date());
    log.setDescription(sysLog.value());
    log.setMethodName(joinPoint.getSignature().getName());
    log.setParameters(Arrays.toString(joinPoint.getArgs()));

    try {
        Object result = joinPoint.proceed();
        log.setLevel("INFO");
        log.setMessage("方法 " + joinPoint.getSignature().getName() + " 執(zhí)行成功。");
        return result;
    } catch (Exception e) {
        log.setLevel("ERROR");
        log.setMessage("方法 " + joinPoint.getSignature().getName() + " 執(zhí)行過程中發(fā)生異常。");
        log.setException(e.toString());
        throw e;
    } finally {
        logService.save(log);
    }
}

在這個環(huán)繞通知中，我們首先創(chuàng)建了一個 Log 對象，并設置了日志的基本信息，如時間戳、描述、方法名和參數(shù)。然后，我們執(zhí)行目標方法，并根據(jù)執(zhí)行結果記錄日志信息。如果目標方法執(zhí)行過程中發(fā)生異常，我們會記錄異常信息。

測試

完整代碼

Maven依賴

在 pom.xml 文件中添加依賴：

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

SQL腳本

創(chuàng)建日志表的 SQL 腳本：

DROP TABLE IF EXISTS `logs`;
CREATE TABLE `logs`  (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主鍵ID',
  `description` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '描述',
  `level` varchar(10) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '日志級別',
  `timestamp` datetime NOT NULL COMMENT '時間戳',
  `message` text CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '日志消息',
  `class_name` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '類名',
  `method_name` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '方法名',
  `parameters` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '參數(shù)',
  `user_identifier` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '用戶標識',
  `exception` text CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL COMMENT '異常信息',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 2 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_0900_ai_ci COMMENT = '日志表' ROW_FORMAT = DYNAMIC;

日志實體類 Log

我們定義了一個 Log 實體類，用于存儲日志信息：

/**
 * 日志實體類
 *
 * @author 王聞薪
 */
@Data
@TableName("logs")
public class Log implements Serializable {

    private static final long serialVersionUID = 1L;

    /**
     * 主鍵ID
     */
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;

    /**
     * 描述
     */
    @TableField("description")
    private String description;

    /**
     * 日志級別
     */
    @TableField("level")
    private String level;

    /**
     * 時間戳
     */
    @TableField("timestamp")
    private Date timestamp;

    /**
     * 日志消息
     */
    @TableField("message")
    private String message;

    /**
     * 類名
     */
    @TableField("class_name")
    private String className;

    /**
     * 方法名
     */
    @TableField("method_name")
    private String methodName;


    /**
     * 參數(shù)
     */
    @TableField("parameters")
    private String parameters;

    /**
     * 用戶標識
     */
    @TableField("user_identifier")
    private String userIdentifier;

    /**
     * 異常信息
     */
    @TableField("exception")
    private String exception;

}

這個實體類映射到數(shù)據(jù)庫中的 logs 表，用于存儲日志的詳細信息。

切面代碼

日志切面類 LogAspect：

package org.example.demo.aspectj;

import lombok.extern.slf4j.Slf4j;
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.example.demo.annotation.SysLog;
import org.example.demo.entity.Log;
import org.example.demo.service.ILogService;
import org.example.demo.utils.TokenService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

import java.util.Arrays;
import java.util.Date;

/**
 * 日志切面類
 * 用于攔截標注有@SysLog注解的方法，并記錄日志信息。
 *
 * @author 王聞薪
 */
@Slf4j
@Aspect // 標記為切面類
@Component // 將此切面類交給Spring管理
public class LogAspect {

    @Autowired
    private ILogService logService;

    @Autowired
    private TokenService tokenService;

    /**
     * 環(huán)繞通知
     * 攔截帶有@SysLog注解的方法，并在方法執(zhí)行前后進行日志記錄。
     *
     * @param joinPoint 連接點對象，包含方法的調用信息。
     * @param sysLog 注解對象，包含日志描述信息。
     * @return 方法執(zhí)行結果。
     * @throws Throwable 可能拋出的異常。
     */
    @Around("@annotation(sysLog)")
    public Object logAround(ProceedingJoinPoint joinPoint, SysLog sysLog) throws Throwable {
        // 創(chuàng)建日志對象
        Log log = new Log();
        log.setLevel("INFO");
        log.setTimestamp(new Date());
        log.setUserIdentifier(getUserId().toString());
        log.setDescription(sysLog.value());
        // 記錄方法調用前的日志
        logBefore(joinPoint, log);

        try {
            // 繼續(xù)執(zhí)行目標方法
            Object result = joinPoint.proceed();

            // 記錄方法調用后的日志
            logAfter(joinPoint, result, log);
            log.setMessage("方法 " + joinPoint.getSignature().getName() + " 執(zhí)行成功。");

            return result;
        } catch (Exception e) {
            // 記錄異常日志
            logException(joinPoint, e, log);
            log.setLevel("ERROR");
            log.setMessage("方法 " + joinPoint.getSignature().getName() + " 執(zhí)行過程中發(fā)生異常。");
            throw e; // 重新拋出異常
        } finally {
            // 保存日志到數(shù)據(jù)庫
            logService.save(log);
        }
    }

    /**
     * 記錄方法調用前的日志信息。
     *
     * @param joinPoint 連接點對象，包含方法的調用信息。
     * @param log 日志對象，用于存儲日志信息。
     */
    private void logBefore(ProceedingJoinPoint joinPoint, Log log) {
        log.setClassName(joinPoint.getSignature().getDeclaringTypeName());
        log.setMethodName(joinPoint.getSignature().getName());
        log.setParameters(Arrays.toString(joinPoint.getArgs()));
        log.setTimestamp(new Date()); // 設置日志時間
    }

    /**
     * 記錄方法調用后的日志信息。
     *
     * @param joinPoint 連接點對象，包含方法的調用信息。
     * @param result 方法執(zhí)行結果。
     * @param log 日志對象，用于存儲日志信息。
     */
    private void logAfter(ProceedingJoinPoint joinPoint, Object result, Log log) {
        log.setMessage(log.getMessage() + result);
    }

    /**
     * 記錄方法執(zhí)行過程中的異常信息。
     *
     * @param joinPoint 連接點對象，包含方法的調用信息。
     * @param e 捕獲的異常對象。
     * @param log 日志對象，用于存儲日志信息。
     */
    private void logException(ProceedingJoinPoint joinPoint, Exception e, Log log) {
        log.setException(e.toString());
        log.setMessage(log.getMessage() + " 異常信息：" + e.getMessage());
    }

    /**
     * 獲取當前用戶ID。
     *
     * @return 用戶ID。
     */
    private Long getUserId() {
        return tokenService.getUserId();
    }
}

結論

通過使用 Spring AOP 和注解，我們可以靈活地為 Spring Boot 應用程序添加日志記錄功能，而無需修改業(yè)務邏輯代碼。這不僅提高了代碼的可維護性，還使得日志記錄變得更加方便和強大。

到此這篇關于SpringBoot中日志切面實現(xiàn)小結的文章就介紹到這了,更多相關SpringBoot 日志切面內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

SpringBoot中日志切面實現(xiàn)小結

目錄

什么是Spring AOP？

日志切面的設計

SysLog 注解

日志切面 LogAspect

日志記錄的實現(xiàn)

測試

完整代碼

Maven依賴

SQL腳本

日志實體類 Log

切面代碼

結論

相關文章

最新評論

大家感興趣的內容

最近更新的內容

常用在線小工具

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

SpringBoot中日志切面實現(xiàn)小結

目錄

什么是Spring AOP？

日志切面的設計

SysLog 注解

日志切面 LogAspect

日志記錄的實現(xiàn)

測試

完整代碼

Maven依賴

SQL腳本

日志實體類 Log

切面代碼

結論

相關文章

最新評論

大家感興趣的內容

最近更新的內容

常用在線小工具

什么是Spring AOP？