如何自定义log注解，实现日志操作（切面编程）

已于 2022-09-26 09:20:37 修改
阅读量5.2k 收藏 33
点赞数 7
分类专栏： 日志操作 切面编程 java 文章标签： java mysql
于 2021-02-04 23:14:46 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_42978230/article/details/113666183
版权

有的同学在工作学习时常常遇到这样一个需求，就是进行对日志表的增删改查。记录用户的操作。啊，有的小伙伴说：这还不简单，一顿操作猛如虎，在每个方法下面都写上了insert语句。

这种方式确实可行，（我真这样干过）但是作为优秀的程序员，追求的是优雅的代码

今天在这里记录一下如何使用自定义注解实现日志的操作。

1.在你的代码中加入一个类

/**
 * @description: 自定义log注解
 * @author: Daigl
 * @create: 2021-02-01 21:33
 **/
@Target({ ElementType.PARAMETER, ElementType.METHOD }) //可以作用在类上，也可以作用在方法上
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Log {
    /**
     * 模块
     */
    public String title() default "";

    /**
     * 功能
     */
    public BusinessType businessType() default BusinessType.OTHER;

    /**
     * 操作人类别
     */
    public OperatorType operatorType() default OperatorType.MANAGE;

    /**
     * 是否保存请求的参数
     */
    public boolean isSaveRequestData() default true;

}

枚举类 BusinessType (功能.例如是新增还是修改)

public enum BusinessType {
    /**
     * 其它
     */
    OTHER,

    /**
     * 新增
     */
    INSERT,

    /**
     * 修改
     */
    UPDATE,

    /**
     * 删除
     */
    DELETE,

    /**
     * 授权
     */
    GRANT,

    /**
     * 导出
     */
    EXPORT,

    /**
     * 导入
     */
    IMPORT,

    /**
     * 强退
     */
    FORCE,

    /**
     * 生成代码
     */
    GENCODE,

    /**
     * 清空数据
     */
    CLEAN,

}

枚举类 OperatorType(操作人类别)

public enum OperatorType {
    /**
     * 其它
     */
    OTHER,

    /**
     * 后台用户
     */
    MANAGE,

    /**
     * 手机端用户
     */
    MOBILE

}

2.新建OperLogAspect类（重要）

说明：下面这个类，可以完全复制。
a.注意logPointCut ：切入点 。
b. handleLog：操作数据库。我这里记录的较详细。可根据您的需求进行增删。

package com.aiit.aspectj;

import cn.hutool.core.date.DateUtil;
import com.aiit.aspectj.annotaion.Log;
import com.aiit.aspectj.enums.BusinessStatus;
import com.aiit.domain.OperLog;
import com.aiit.domain.User;
import com.aiit.service.OperLogService;
import com.aiit.util.ServletUtils;
import com.aiit.util.ShiroSecurityUtils;
import com.aiit.utils.AddressUtils;
import com.aiit.utils.IpUtils;
import com.alibaba.fastjson.JSON;
import lombok.extern.log4j.Log4j2;
import org.apache.commons.lang3.StringUtils;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.Signature;
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.http.HttpMethod;
import org.springframework.stereotype.Component;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.web.servlet.HandlerMapping;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.lang.reflect.Method;
import java.util.Map;

/**
 * @program: open-his
 * @description: 操作日志记录处理
 * @author: Daigl
 * @create: 2021-02-04 21:42
 **/
@Component
@Aspect
@Log4j2
public class OperLogAspect {
    @Autowired
    private OperLogService operLogService;

    /**
     * 声明切面
     * 只要Controller的方法中有@log注解就切入 重要
     */
    @Pointcut("@annotation(com.aiit.aspectj.annotaion.Log)")
    public void logPointCut(){}

    /**
     * 处理完请求后执行
     *
     * @param joinPoint 切点
     */
    @AfterReturning(pointcut = "logPointCut()", returning = "jsonResult")
    public void doAfterReturning(JoinPoint joinPoint, Object jsonResult)
    {
        handleLog(joinPoint, null, jsonResult);
    }

    /**
     * 拦截异常操作
     *
     * @param joinPoint 切点
     * @param e 异常
     */
    @AfterThrowing(value = "logPointCut()", throwing = "e")
    public void doAfterThrowing(JoinPoint joinPoint, Exception e)
    {
        handleLog(joinPoint, e, null);
    }

    protected void handleLog(final JoinPoint joinPoint, final Exception e, Object jsonResult)
    {
        try
        {
            // 获得注解
            Log controllerLog = getAnnotationLog(joinPoint);
            if (controllerLog == null)
            {
                return;
            }

            // 获取当前的用户
            User loginUser = ShiroSecurityUtils.getCurrentUser();
				
            // *========数据库日志=========*//
            OperLog operLog = new OperLog();
            operLog.setStatus(String.valueOf(BusinessStatus.SUCCESS.ordinal()));
            // 请求的地址
            String ip = IpUtils.getIpAddr(ServletUtils.getRequest());
            operLog.setOperIp(ip);
            String address = AddressUtils.getRealAddressByIP(ip);
            operLog.setOperLocation(address);
            // 返回参数
            operLog.setJsonResult(JSON.toJSONString(jsonResult));

            operLog.setOperUrl(ServletUtils.getRequest().getRequestURI());
            if (loginUser != null)
            {
                operLog.setOperName(loginUser.getUserName());
            }

            if (e != null)
            {
                operLog.setStatus(String.valueOf(BusinessStatus.FAIL.ordinal()));
                operLog.setErrorMsg(StringUtils.substring(e.getMessage(), 0, 2000));
            }
            // 设置方法名称
            String className = joinPoint.getTarget().getClass().getName();
            String methodName = joinPoint.getSignature().getName();
            operLog.setMethod(className + "." + methodName + "()");
            // 设置请求方式
            operLog.setRequestMethod(ServletUtils.getRequest().getMethod());
            // 处理设置注解上的参数
            getControllerMethodDescription(joinPoint, controllerLog, operLog);
            //设置操作时间
            operLog.setOperTime(DateUtil.date());
            // 保存数据库 *******************************************重要。
            //保存您的日志数据到数据库
            operLogService.insertOperLog(operLog);
        }
        catch (Exception exp)
        {
            // 记录本地异常日志
            log.error("==前置通知异常==");
            log.error("异常信息:{}", exp.getMessage());
            exp.printStackTrace();
        }
    }

    /**
     * 是否存在注解，如果存在就获取
     */
    private Log getAnnotationLog(JoinPoint joinPoint) throws Exception
    {
        Signature signature = joinPoint.getSignature();
        MethodSignature methodSignature = (MethodSignature) signature;
        Method method = methodSignature.getMethod();

        if (method != null)
        {
            return method.getAnnotation(Log.class);
        }
        return null;
    }

    /**
     * 获取注解中对方法的描述信息 用于Controller层注解
     *
     * @param log 日志
     * @param operLog 操作日志
     * @throws Exception
     */
    public void getControllerMethodDescription(JoinPoint joinPoint, Log log, OperLog operLog) throws Exception
    {
        // 设置action动作
        operLog.setBusinessType(String.valueOf(log.businessType().ordinal()));
        // 设置标题
        operLog.setTitle(log.title());
        // 设置操作人类别
        operLog.setOperatorType(log.operatorType().ordinal());
        // 是否需要保存request，参数和值
        if (log.isSaveRequestData())
        {
            // 获取参数的信息，传入到数据库中。
            setRequestValue(joinPoint, operLog);
        }
    }

    /**
     * 获取请求的参数，放到log中
     *
     * @param operLog 操作日志
     * @throws Exception 异常
     */
    private void setRequestValue(JoinPoint joinPoint, OperLog operLog) throws Exception
    {
        String requestMethod = operLog.getRequestMethod();
        if (HttpMethod.PUT.name().equals(requestMethod) || HttpMethod.POST.name().equals(requestMethod))
        {
            String params = argsArrayToString(joinPoint.getArgs());
            operLog.setOperParam(StringUtils.substring(params, 0, 2000));
        }
        else
        {
            Map<?, ?> paramsMap = (Map<?, ?>) ServletUtils.getRequest().getAttribute(HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE);
            operLog.setOperParam(StringUtils.substring(paramsMap.toString(), 0, 2000));
        }
    }


    /**
     * 参数拼装
     */
    private String argsArrayToString(Object[] paramsArray)
    {
        String params = "";
        if (paramsArray != null && paramsArray.length > 0)
        {
            for (int i = 0; i < paramsArray.length; i++)
            {
                if (!isFilterObject(paramsArray[i]))
                {
                    Object jsonObj = JSON.toJSON(paramsArray[i]);
                    params += jsonObj.toString() + " ";
                }
            }
        }
        return params.trim();
    }

    /**
     * 判断是否需要过滤的对象。
     *
     * @param o 对象信息。
     * @return 如果是需要过滤的对象，则返回true；否则返回false。
     */
    public boolean isFilterObject(final Object o)
    {
        return o instanceof MultipartFile || o instanceof HttpServletRequest
                || o instanceof HttpServletResponse;
    }

}

3.写好上面的代码，您就可以在需要记录操作日志的方法上加上@Log注解，这样就可以对增加log日志啦！

 /**
     * 修改
     */
    @PutMapping("updateDictType")
    @Log(title = "修改字典类型",businessType = BusinessType.UPDATE)
    public AjaxResult updateDictType(@Validated DictTypeDto dictTypeDto) {
        if (dictTypeService.checkDictTypeUnique(dictTypeDto.getDictId(), dictTypeDto.getDictType())) {
            return AjaxResult.fail("修改字典【" + dictTypeDto.getDictName() + "】失败，字典类型已存在");
        }
        dictTypeDto.setSimpleUser(ShiroSecurityUtils.getCurrentSimpleUser());
        return AjaxResult.toAjax(this.dictTypeService.update(dictTypeDto));
    }

上图我对一张表的修改操作进行了日志记录。只需要加上@Log即可
后面的参数title:可以随便写。一般是您本方法的作用
businessType：这个后面的参数是我们之前写的枚举类。直接调用。有修改，增加，删除
可以根您的需要可以对BusinessType类进行修改

ok,这样当用户调用到您的updateDictType方法时，就会在日志表中插入一条数据啦。
搬砖的阿陆
关注
  • 7
    点赞
  • 踩
  • 33
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 6
    评论
专栏目录
Qt 自定义 log 日志
05-14
C++ 中比较不错的日志工具有 log4cxx，log4qt 等，但是它们都不能和 qDebug(), qInfo() 等有机的结合在一起，所以在 Qt 中使用总觉得不够舒服，感谢 Qt 提供了 qInstallMessageHandler() 这个函数，使用这个函数可以安装自定义的日志输出处理函数，把日志输出到文件，控制台等，具体的使用可以查看 Qt 的帮助文档。 本文主要是介绍使用 qInstallMessageHandler() 实现一个简单的日志工具，例如调用 qDebug() << “Hi”，输出的内容会同时输出到日志文件和控制台，并且日志文件如果不是当天创建的，会使用它的创建日期备份起来 ———————————————— 版权声明：本文为CSDN博主「康闯」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。 原文链接：https://blog.csdn.net/sirkang/article/details/106115635
php基于自定义函数记录log日志方法
10-19
主要介绍了php基于自定义函数记录log日志方法,涉及php针对文件、目录及错误日志相关操作技巧,需要的朋友可以参考下
自定义注解@Log 插入操作日志
最新发布
m0_61562689的博客
04-02 398
【代码】自定义注解@Log 插入操作日志。
超实用的android自定义log日志输出工具类
08-26
主要为大家详细介绍了一个超实用的android自定义log日志输出工具类，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
php实现的debug log日志操作类实例
10-21
主要介绍了php实现的debug log日志操作类,结合实例形式分析了php针对日志的相关操作技巧,包括php数组、字符串及文件的写操作等用法,需要的朋友可以参考下
Spring AOP中定义切点PointCut详解
热门推荐
zzhongcy的专栏
10-10 1万+
1、AOP是什么？ 软件工程有一个基本原则叫做“关注点分离”（Concern Separation），通俗的理解就是不同的问题交给不同的部分去解决，每部分专注于解决自己的问题。这年头互联网也天天强调要专注嘛！ 这其实也是一种“分治”或者“分类”的思想，人解决复杂问题的能力是有限的，所以为了控制复杂性，我们解决问题时通常都要对问题进行拆解，拆解的同时建立各部分之间...
若依学习（前后端分离版）——自定义注解@Log（如何自定义注解，实现aop）
hwp_ing的博客
03-04 3267
定义了注解的相关信息。这里定义的属性可以在使用时加以定义注解@Target和@Retention的作用。
自定义日志注解Log实现 - SpringAop的实际应用
qq_24251607的博客
04-23 796
本篇文章教给大家自定义日志注解功能的实现，主要技术核心是Spring-AOP。
Spring中自定义Log注解的详解案例
博客
08-25 2206
1.自定义Log注解 @Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) public @interface Log { /** * 操作内容 * * @return */ String content(); /** * 操作日志类型 * * @return */ OperatorTypeEnum type();
SpringBoot集成AOP实现日志记录
qq_39093474的博客
03-19 1460
AOP：面向切面编程，是通过预编译方式和运行期动态代理，实现在不修改源代码的情况下给程序动态统一添加功能的一种技术，同时是对OOP(面向对象编程)的补充和完善，常被用来在spring中实现日志记录、性能监控等功能。面向对象实现日志记录，性能监控这些功能时，需要在每个对象中都添加相同的方法，这样就产生了较大的重复工作量和大量的重复代码，不利于维护，使用AOP，可以大大减少代码数量，方便维护。/*** @Target: 表示次注解可以标注在方法上* @Retention: 运行时生效。
分布式通过AOP进行操作日志记录
m0_49044558的博客
12-30 641
SpringCloud分布式操作日志记录
Spring AOP面向切面编程实现原理方法详解
08-18
Spring AOP面向切面编程实现原理方法详解 面向切面编程（AOP）是Spring框架中的一个重要内容，通过预编译方式和运行期动态代理实现，在不修改源代码的情况下，给程序动态统一添加功能的一种技术。AOP可以对业务逻辑...
Spring Boot之AOP配自定义注解的最佳实践过程
08-26
AOP（Aspect Oriented Programming），即面向切面编程，是Spring框架的大杀器之一。AOP通过将那些反复出现的代码抽取出来，放在一个地方统一处理，从而解耦系统，提高开发效率和代码质量。 二、AOP应用场景 AOP的...
Android中AOP（面向切向编程）的深入讲解
08-26
面向切面编程（AOP，Aspect Oriented Programming）在Android开发中主要用来解决代码的横切关注点，例如日志记录、性能监控、权限检查等，这些功能往往贯穿于多个类或方法之中，使得代码耦合度增加。AOP允许我们将...
Spring boot学习（六）Spring boot实现AOP记录操作日志.pdf
07-05
在本文中，我们将深入探讨如何在Spring Boot项目中利用AOP（面向切面编程）来实现操作日志记录。AOP是一种编程范式，它允许程序员定义“切面”，这些切面可以在程序运行时被自动应用到多个点上，比如方法调用之前、...
spring中AOP 注解开发示例详解
08-31
在Spring框架中，AOP（面向切面编程）是一种强大的工具，它允许开发者将关注点分离，比如日志、事务管理、安全控制等，从核心业务逻辑中抽离出来。本文将深入探讨Spring AOP的注解开发方式，以帮助读者理解如何使用...
使用AOP实现自定义日志
qq_51365907的博客
01-04 874
使用AOP实现自定义日志开发
自定义注解实现日志功能
csdn_ss1991的博客
05-11 2582
介绍：现在做的项目，需要通过aop实现添加日志功能，在需要的方法上加注解即可对该方法执行拦截并添加日志1.      添加相关依赖&lt;spring.version&gt;4.1.7.RELEASE&lt;/spring.version&gt; &lt;aspectj.version&gt;1.6.8&lt;/aspectj.version&gt; &lt;!—springaop相关—&gt; ...
自定义注解&Spring AOP实现日志组件(可重用)
u012780655的博客
11-26 200
项目需求 **需求1: **web项目一般而言都需要日志记录，比较常用的是实用log4j来记录项目的异常日志，将日志单独存储于文件当中，这样有利于我们快速进行bug 排解。 **需求2: **异常的记录一般就是将异常的堆栈保存在文件中，这样文件大小会急剧上升，有效异常信息也不能被立即定位，有没有一种方式可以可以让我们重写异常记录，并保存在异常日志文件当...
java自定义注解 aop切面
05-18
Java自定义注解和AOP切面是两个不同的概念，但它们可以结合使用来实现一些非常有用的功能。 Java自定义注解是Java语言中的一种特殊的语法结构，它允许开发者在代码中添加一些元数据，以便后续处理程序能够基于这些元数据来进行特定的操作。Java自定义注解可以在类、方法、属性等各种代码元素上进行声明，并且可以指定注解的属性，以提供更多的元数据信息。 AOP（面向切面编程）是一种编程思想，它允许开发者在不改变原有代码的情况下，通过添加额外的代码来实现某些横切关注点的功能。AOP切面是一个包含一组通知（Advice）和切点（Pointcut）的类，它可以在程序运行时自动拦截指定的方法或类，并执行相应的通知。 在Java中，我们可以通过将自定义注解和AOP切面结合使用，来实现一些非常有用的功能。例如，我们可以定义一个名为 @Log 的注解，在程序中使用该注解来标记需要记录日志的方法，然后编写一个AOP切面来拦截这些方法，并在方法执行前后记录日志。这样，我们就可以轻松地实现统一的日志记录功能，而不需要在每个方法中都编写日志记录代码。 下面是一个简单的示例代码，演示了如何使用Java自定义注解和AOP切面来实现统一的日志记录功能： ```java // 定义一个名为 @Log 的注解 @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD) public @interface Log { } // 编写一个AOP切面，拦截带有 @Log 注解的方法，并记录日志 @Aspect @Component public class LogAspect { @Around("@annotation(log)") public Object around(ProceedingJoinPoint joinPoint, Log log) throws Throwable { String methodName = joinPoint.getSignature().getName(); System.out.println("方法 " + methodName + " 开始执行..."); Object result = joinPoint.proceed(); System.out.println("方法 " + methodName + " 执行完成，返回值为：" + result); return result; } } // 在程序中使用 @Log 注解标记需要记录日志的方法 @Service public class UserService { @Log public String getUserInfo(String userId) { // ... } } ``` 在上面的代码中，我们首先定义了一个名为 @Log 的注解，并指定了它的作用范围为方法。然后，我们编写了一个AOP切面 LogAspect，使用 @Around 注解来指定切点为所有带有 @Log 注解的方法。在切面的 around 方法中，我们通过 ProceedingJoinPoint 对象获取当前执行的方法名，并在方法执行前后打印日志。最后，我们在 UserService 类的 getUserInfo 方法上使用了 @Log 注解，表示这个方法需要记录日志。 当程序运行时，LogAspect 切面会自动拦截 UserService 类的 getUserInfo 方法，并执行 around 方法中的逻辑，从而实现了统一的日志记录功能。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 6
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

搬砖的阿陆

你的鼓励就是我前进的动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值