关于注解,平时接触的可不少,像是 @Controller、@Service、@Autowried 等等,不知道你是否有过这种疑惑,使用 @Service 注解的类成为我们的业务类,使用 @Controller 注解的类就成了请求的控制器,使用 @Autowried 注解的类就会帮我们实现自动注入…

以前,我们只知道使用注解,今天我们要手写一个注解。

一、以日志记录为例

在没有使用注解实现记录日志之前,我们往往自己去调用日志记录的 Service,然后写入数据库表。

今天我们将从方法上添加自定义注解实现日志自动记录,如下:

52e77c79b07d49c6554ff2a0185d7f02.png

二、了解关于注解知识

JDK 提供了 meta-annotation 用于自定义注解的时候使用,这四个注解为:@Target,@Retention,@Documented 和 @Inherited。

以 @Controller 为例,其源码也是如此:

fc6b30adb15c78f562e0de8e503e6881.png

我们来看一下上边提到的四个注解:

注解 说明
@Target 用于描述注解的使用范围,即:被描述的注解可以用在什么地方
@Retention 指定被描述的注解在什么范围内有效
@Documented 是一个标记注解,木有成员,用于描述其它类型的annotation 应该被作为被标注的程序成员的公共 API,因此可以被例如javadoc此类的工具文档化
@Inherited 元注解是一个标记注解,@Inherited 阐述了某个被标注的类型是被继承的。如果一个使用了 @Inherited 修饰的 annotation 类型被用于一个 class,则这个 annotation 将被用于该class的子类

三、开始我们的自定义注解

两个类:
SystemLog:自定义注解类,用于标记到方法、类上,如@SystemLog
SystemLogAspect:AOP实现切点拦截。

关于AOP的补充:
关于AOP面向切面编程概念啥的就不啰嗦了,还不了解的可以自定百度了

描述AOP常用的一些术语有:
通知(Adivce)、连接点(Join point)、切点(Pointcut)、切面(Aspect)、引入(Introduction)、织入(Weaving)

关于术语的部分可参考:https://www.cnblogs.com/niceyoo/p/10162077.html

需要明确的核心概念:切面 = 切点 + 通知。

@Aspect 注解形式是 AOP 的一种实现,如下看一下我们要写的两个类吧。

1、@SystemLog

定义我们的自定义注解类

/**
 * 系统日志自定义注解
 */
@Target({ElementType.PARAMETER, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface SystemLog {         /**
         * 日志名称
         * @return
         */
        String description() default "";         /**
         * 日志类型
         * @return
         */
        LogType type() default LogType.OPERATION;
}
2、@SystemLogAspect

AOP拦截@SystemLog注解

/**
 * Spring AOP实现日志管理
 * @author Exrickx
 */
@Aspect
@Component
@Slf4j
public class SystemLogAspect {     private static final ThreadLocal<Date> beginTimeThreadLocal = new NamedThreadLocal<Date>("ThreadLocal beginTime");     @Autowired
    private LogService logService;     @Autowired
    private UserService userService;     @Autowired(required = false)
    private HttpServletRequest request;     /**
     * 定义切面,只置入带 @SystemLog 注解的方法或类 
     * Controller层切点,注解方式
     * @Pointcut("execution(* *..controller..*Controller*.*(..))")
     */
    @Pointcut("@annotation(club.sscai.common.annotation.SystemLog)")
    public void controllerAspect() {     }     /**
     * 前置通知 (在方法执行之前返回)用于拦截Controller层记录用户的操作的开始时间
     * @param joinPoint 切点
     * @throws InterruptedException
     */
    @Before("controllerAspect()")
    public void doBefore(JoinPoint joinPoint) throws InterruptedException{         ##线程绑定变量(该数据只有当前请求的线程可见)
        Date beginTime=new Date();
        beginTimeThreadLocal.set(beginTime);
    }     /**
     * 后置通知(在方法执行之后并返回数据) 用于拦截Controller层无异常的操作
     * @param joinPoint 切点
     */
    @AfterReturning("controllerAspect()")
    public void after(JoinPoint joinPoint){
        try {
            String username = "";
            String description = getControllerMethodInfo(joinPoint).get("description").toString();
            Map<String, String[]> logParams = request.getParameterMap();
            String principal = SecurityContextHolder.getContext().getAuthentication().getPrincipal().toString();
            ## 判断允许不用登录的注解
            if("anonymousUser".equals(principal)&&!description.contains("短信登录")){
                return;
            }
            if(!"anonymousUser".equals(principal)){
                UserDetails user = (UserDetails) SecurityContextHolder.getContext().getAuthentication().getPrincipal();
                username = user.getUsername();
            }
            if(description.contains("短信登录")){
                if(logParams.get("mobile")!=null){
                    String mobile = logParams.get("mobile")[0];
                    username = userService.findByMobile(mobile).getUsername()+"("+mobile+")";
                }
            }             Log log = new Log();             ##请求用户
            log.setUsername(username);
            ##日志标题
            log.setName(description);
            ##日志类型
            log.setLogType((int)getControllerMethodInfo(joinPoint).get("type"));
            ##日志请求url
            log.setRequestUrl(request.getRequestURI());
            ##请求方式
            log.setRequestType(request.getMethod());
            ##请求参数
            log.setMapToParams(logParams);
            ##请求开始时间
            Date logStartTime = beginTimeThreadLocal.get();             long beginTime = beginTimeThreadLocal.get().getTime();
            long endTime = System.currentTimeMillis();
            ##请求耗时
            Long logElapsedTime = endTime - beginTime;
            log.setCostTime(logElapsedTime.intValue());             ##调用线程保存至log表
            ThreadPoolUtil.getPool().execute(new SaveSystemLogThread(log, logService));         } catch (Exception e) {
            log.error("AOP后置通知异常", e);
        }
    }     /**
     * 保存日志至数据库
     */
    private static class SaveSystemLogThread implements Runnable {         private Log log;
        private LogService logService;         public SaveSystemLogThread(Log esLog, LogService logService) {
            this.log = esLog;
            this.logService = logService;
        }         @Override
        public void run() {             logService.save(log);
        }
    }     /**
     * 获取注解中对方法的描述信息 用于Controller层注解
     * @param joinPoint 切点
     * @return 方法描述
     * @throws Exception
     */
    public static Map<String, Object> getControllerMethodInfo(JoinPoint joinPoint) throws Exception{         Map<String, Object> map = new HashMap<String, Object>(16);
        ## 获取目标类名
        String targetName = joinPoint.getTarget().getClass().getName();
        ## 获取方法名
        String methodName = joinPoint.getSignature().getName();
        ## 获取相关参数
        Object[] arguments = joinPoint.getArgs();
        ## 生成类对象
        Class targetClass = Class.forName(targetName);
        ## 获取该类中的方法
        Method[] methods = targetClass.getMethods();         String description = "";
        Integer type = null;         for(Method method : methods) {
            if(!method.getName().equals(methodName)) {
                continue;
            }
            Class[] clazzs = method.getParameterTypes();
            if(clazzs.length != arguments.length) {
                ## 比较方法中参数个数与从切点中获取的参数个数是否相同,原因是方法可以重载
                continue;
            }
            description = method.getAnnotation(SystemLog.class).description();
            type = method.getAnnotation(SystemLog.class).type().ordinal();
            map.put("description", description);
            map.put("type", type);
        }
        return map;
    } }

流程补充:

  1. 通过 @Pointcut 定义带有 @SystemLog 注解的方法或类为切入点,可以理解成,拦截所有带该注解的方法。
  2. @Before 前置通知用于记录请求时的时间
  3. @AfterReturning 用于获取返回值,主要使用 getControllerMethodInfo() 方法,采用类反射机制获取请求参数,最后调用 LogService 保存至数据库。

额外补充:

关于 SecurityContextHolder 的使用为 Spring Security 用于获取用户,实现记录请求用户的需求,可根据自己框架情况选择,如使用 shiro 获取当前用户为 SecurityUtils.getSubject().getPrincipal(); 等等。

如果文章有错的地方欢迎指正,大家互相留言交流。习惯在微信看技术文章,想要获取更多的Java资源的同学,可以关注微信公众号:niceyoo

自定义注解-aop实现日志记录的更多相关文章

  1. 来一手 AOP 注解方式进行日志记录

    系统日志对于定位/排查问题的重要性不言而喻,相信许多开发和运维都深有体会. 通过日志追踪代码运行状况,模拟系统执行情况,并迅速定位代码/部署环境问题. 系统日志同样也是数据统计/建模的重要依据,通过分 ...

  2. spring AOP自定义注解方式实现日志管理

    今天继续实现AOP,到这里我个人认为是最灵活,可扩展的方式了,就拿日志管理来说,用Spring AOP 自定义注解形式实现日志管理.废话不多说,直接开始!!! 关于配置我还是的再说一遍. 在appli ...

  3. SpringCloud微服务实战——搭建企业级开发框架(三十九):使用Redis分布式锁(Redisson)+自定义注解+AOP实现微服务重复请求控制

      通常我们可以在前端通过防抖和节流来解决短时间内请求重复提交的问题,如果因网络问题.Nginx重试机制.微服务Feign重试机制或者用户故意绕过前端防抖和节流设置,直接频繁发起请求,都会导致系统防重 ...

  4. Spring AOP 完成日志记录

    Spring AOP 完成日志记录 http://hotstrong.iteye.com/blog/1330046

  5. Spring AOP进行日志记录

    在java开发中日志的管理有很多种.我一般会使用过滤器,或者是Spring的拦截器进行日志的处理.如果是用过滤器比较简单,只要对所有的.do提交进行拦截,然后获取action的提交路径就可以获取对每个 ...

  6. Spring AOP进行日志记录,管理

    在java开发中日志的管理有很多种.我一般会使用过滤器,或者是Spring的拦截器进行日志的处理.如果是用过滤器比较简单,只要对所有的.do提交进行拦截,然后获取action的提交路径就可以获取对每个 ...

  7. Spring AOP 自定义注解实现统一日志管理

    一.AOP的基本概念: AOP,面向切面编程,常用于日志,事务,权限等业务处理.AOP是OOP的延续,是软件开发中的一个热点,也是Spring框架中的一个重要内容(Spring核心之一),是函数式编程 ...

  8. 记一次基于springboot+aop实现日志记录实战

    1. 为什么要记录日志 好处: a. 可以对一些重要功能进行记录,方便以后跟踪是谁操作此功能的. b. 在操作某些功能时可能会发生异常,但每次出现异常我们想定位日志都要去服务器查看我们的日志.有了日志 ...

  9. 【Redis】redis异步消息队列+Spring自定义注解+AOP方式实现系统日志持久化

    说明: SSM项目中的每一个请求都需要进行日志记录操作.一般操作做的思路是:使用springAOP思想,对指定的方法进行拦截.拼装日志信息实体,然后持久化到数据库中.可是仔细想一下会发现:每次的客户端 ...

随机推荐

  1. AtCoder-arc060 (题解)

    A - 高橋君とカード / Tak and Cards (DP) 题目链接 题目大意: 有 \(n\) 个数字,要求取出一些数字,使得它们的平均数恰好为 \(x\) ,问有几种取法. 大致思路: 只要 ...

  2. CKEditor图片上传问题(默认安装情况下编辑器无法处理图片),通过Base64编码字符串解决

    准备做一个文章内容网站,网页编辑器采用CKEditor,第一次用,默认安装情况下,图片无法插入,提示没有定义上传适配器(adapter),错误码提示如下: 根据提示,在官网看到有两种途径:一使用CKE ...

  3. golang微服务框架go-micro 入门笔记2.1 micro工具之micro api

    micro api micro 功能非常强大,本文将详细阐述micro api 命令行的功能 重要的事情说3次 本文全部代码https://idea.techidea8.com/open/idea.s ...

  4. 复杂sql语句之单字段分类count计数和多字段count计数

    SELECT AF_DEPARTMENT, dept.FULLNAME, SUM(CASE AF_CLASSIFY WHEN THEN ELSE END) AS 'o_standard', (COUN ...

  5. c# sharepoint client object model 客户端如何创建中英文站点

    c# sharepoint client object model 客户端如何创建中英文站点 ClientContext ClientValidate = tools.GetContext(Onlin ...

  6. C#字符串连接问题(包含破折号和引号)

    1.需求场景: 生成字符串如下:jsonStr.Append("\"SensorTypes\":"); 解决方法: string code = @"j ...

  7. mac上使用git命令上传项目工程源码至Github/gitee

    原文连接:(http://www.studyshare.cn/blog/details/1164/0 ) 一.安装git工具 1.官网下载地址:点击下载  安装步骤略,mac安装工具双击拖动即可. 2 ...

  8. Eclipse的常用设置。

    用惯了VS,再回过去用Eclipse真是一件痛苦的事.so,在这里记录下使用过程中的一些设置以做备忘. 1.代码自动提示 在我们忘记方法名或者想偷懒时,代码自动提示很管用.不过Eclipse默认是输入 ...

  9. npm和Node.js简介

    Node.js Node.js是JavaScript的一种运行环境,是对Google V8引擎进行的封装.是一个服务器端的javascript的解释器.Node.js允许通过JavaScript和一系 ...

  10. 移动端的touch click事件的理解+点透

    移动端在touch上一共有4个事件 touchstart touchmove touchend touchcancel, touchcancel, 一般来说,它们执行的顺序为 touchstart - ...