SpringBoot实战:轻松使用AOP+注解实现操作日志记录

开发 前端
通过上述步骤,我们利用AOP和自定义注解在SpringBoot应用中实现了操作日志的记录。这种方式不仅减少了代码冗余,提高了开发效率,还增强了系统的可维护性和可扩展性。

引言

在企业应用开发中,操作日志记录是确保系统安全性、可追溯性以及调试分析的重要手段之一。通过记录用户的操作行为,不仅可以帮助开发者快速定位问题,还能满足审计和合规需求。本文旨在探讨如何在SpringBoot应用程序中通过AOP(面向切面编程)和自定义注解实现操作日志记录,并将日志存储到数据库中。

AOP简介

AOP(Aspect Oriented Programming)面向切面编程,是对OOP(Object-Oriented Programming)的一种补充。它允许开发者在不修改源代码的情况下增加额外的功能,如日志记录、事务管理、权限控制等。在SpringBoot中,AOP通过注解和动态代理实现,极大地简化了横切关注点的管理。

环境准备

  • JDK版本:JDK 17
  • Spring Boot版本:Spring Boot 3.2.2
  • MySQL版本:8.0.37
  • 构建工具:Maven

确保项目中包含Spring AOP的依赖:

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

数据库设计

首先,需要创建一个操作日志记录表,用于存储日志信息。以下是一个简单的操作日志表结构示例:

CREATE TABLE `sys_oper_log` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `title` varchar(50) DEFAULT NULL COMMENT '模块标题',
  `business_type` varchar(20) DEFAULT NULL COMMENT '业务类型',
  `method` varchar(100) DEFAULT NULL COMMENT '方法名称',
  `request_method` varchar(10) DEFAULT NULL COMMENT '请求方式',
  `operator_type` varchar(10) DEFAULT NULL COMMENT '操作类别',
  `oper_name` varchar(50) DEFAULT NULL COMMENT '操作人员',
  `oper_url` varchar(255) DEFAULT NULL COMMENT '请求URL',
  `oper_ip` varchar(50) DEFAULT NULL COMMENT '主机地址',
  `oper_param` text COMMENT '请求参数',
  `json_result` text COMMENT '返回参数',
  `status` int DEFAULT NULL COMMENT '操作状态',
  `error_msg` varchar(200) DEFAULT NULL COMMENT '错误消息',
  `oper_time` datetime DEFAULT NULL COMMENT '操作时间',
  `execute_time` bigint DEFAULT NULL COMMENT '执行时长',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='操作日志记录';

创建实体类

对应上述数据库表,创建一个系统日志实体类SysOperLog,使用Lombok简化代码:

@Data
@Schema(description = "操作日志记录")
@TableName(value = "sys_oper_log")
public class SysOperLog implements Serializable {
    // 省略字段定义,参考数据库表结构
}

创建注解

定义一个自定义注解@Log,用于标记需要记录日志的方法:

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Log {
    String title() default "";
    BusinessType businessType() default BusinessType.OTHER;
    boolean isSaveRequestData() default true;
    boolean isSaveResponseData() default true;
    String[] excludeParamNames() default {};
}

// 业务操作类型枚举
public enum BusinessType {
    OTHER, INSERT, UPDATE, DELETE
    // 可根据实际需要扩展
}

创建切面类

使用@Aspect注解定义一个切面类LogAspect,用于拦截带有@Log注解的方法,并记录日志:

@Aspect
@Component
public class LogAspect {

    @Autowired
    private SysOperLogService sysOperLogService; // 假设的日志服务

    @Pointcut("@annotation(com.example.demo.annotation.Log)")
    public void logPointcut() {}

    @Around("logPointcut()")
    public Object around(ProceedingJoinPoint joinPoint) throws Throwable {
        long startTime = System.currentTimeMillis();
        Object result = joinPoint.proceed();
        long executeTime = System.currentTimeMillis() - startTime;

        // 收集日志信息,这里仅为示例
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        Log logAnnotation = signature.getMethod().getAnnotation(Log.class);
        // 省略日志信息组装过程

        // 保存日志
        sysOperLogService.saveLog(log); // 假设的保存日志方法

        return result;
    }
}

注意:这里的saveLog方法需要根据实际业务逻辑进行实现,包括日志信息的详细组装和数据库保存操作。

使用注解

在需要记录日志的方法上添加@Log注解:

@Service
public class SomeService {

    @Log(title = "用户管理", businessType = BusinessType.UPDATE)
    public void updateUserInfo(UserInfo userInfo) {
        // 业务逻辑
    }
}

总结

通过上述步骤,我们利用AOP和自定义注解在SpringBoot应用中实现了操作日志的记录。这种方式不仅减少了代码冗余,提高了开发效率,还增强了系统的可维护性和可扩展性。希望本文对你在实际开发中的日志记录工作有所帮助。

责任编辑:武晓燕 来源: 程序员编程日记
相关推荐

2023-03-06 11:36:13

SpingBoot注解

2021-03-01 23:26:41

日志Spring BootAOP

2022-02-08 17:07:54

Spring BooSpring Aop日志记录

2024-08-26 08:27:18

2023-03-30 07:48:46

接口鉴权SpringBoot

2022-02-17 13:39:09

AOP接口方式

2024-06-14 09:30:58

2023-03-03 09:11:12

高并发SpringBoot

2022-12-13 09:19:06

高并发SpringBoot

2022-06-14 10:47:27

项目日志PUT

2021-02-03 05:24:44

API日志

2024-01-04 07:55:32

系统操作日志接口

2021-02-14 20:41:56

API日志web

2024-02-29 08:52:31

PostgreSQL数据分析GROUP BY

2009-09-14 10:29:02

LINQ删除记录

2024-09-11 08:35:54

2011-08-04 13:31:50

数据库记录更改日志触发器

2024-05-06 08:45:25

Spring分布式日志

2023-11-07 16:00:25

面向切面编程开发

2011-09-05 14:31:20

路由器限速
点赞
收藏

51CTO技术栈公众号