若依Cloud框架（RuoYi-Cloud）是一款基于Spring Boot 2.0构建的微服务权限管理系统。它旨在为开发者提供一个易于理解、快速上手、功能完备且文档详尽的后端开发平台，用于快速搭建企业级的分布式系统。

主要特点 

---

易读易懂：代码结构清晰，遵循良好的编程规范，便于阅读和维护。
界面简洁美观：提供了优雅的前端UI设计，采用现代化的Web开发技术，如Bootstrap、Thymeleaf（可能针对后端模板渲染）和Vue.js（可能用于部分前端交互或单页应用），为用户提供良好的用户体验。
文档齐全：官方提供了详细的用户手册和技术文档，帮助开发者快速理解和配置系统，以及进行二次开发。
轻量级依赖：核心依赖仅包括Spring Boot、MyBatis（数据访问层）、Shiro（安全框架）等基础技术栈，没有引入其他重型或复杂的第三方库，确保系统的简洁性和稳定性。
微服务架构：基于Spring Cloud Alibaba实现微服务化设计，支持服务注册与发现、配置中心、熔断限流、API网关、分布式事务等微服务治理能力。

@Log是自定义操作日志记录注解

在controller中标记了@Log注解的方法，会在方法执行完或者抛出异常后异步的将用户的操作记录存储到数据库中

步骤

1. 注解

我们先来看一下@Log注解，在com/ruoyi/common/annotation包下

@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;
 
    /**
     * 是否保存响应的参数
     */
    public boolean isSaveResponseData() default true;
}

一个可以标记在方法或者参数上的注解，有5个属性。每个属性若依都写了注释：

• title： 表示的是业务模块
• businessType: 表示功能，增删改查导入导出等等
• operatorType：表示操作人类别，是后台用户或者手机端用户。
• isSaveRequestData：是否保存request和参数和值
• isSaveResponseData：是否保存response和参数和值

2. 切面

下面看一下@Log注解的切面LogAspect，它在com/ruoyi/framework/aspectj包下

@Aspect
@Component
public class LogAspect
{
    private static final Logger log = LoggerFactory.getLogger(LogAspect.class);
 
    /**
     * 处理完请求后执行
     *
     * @param joinPoint 切点
     */
    @AfterReturning(pointcut = "@annotation(controllerLog)", returning = "jsonResult")
    public void doAfterReturning(JoinPoint joinPoint, Log controllerLog, Object jsonResult)
    {
        handleLog(joinPoint, controllerLog, null, jsonResult);
    }
 
    /**
     * 拦截异常操作
     * 
     * @param joinPoint 切点
     * @param e 异常
     */
    @AfterThrowing(value = "@annotation(controllerLog)", throwing = "e")
    public void doAfterThrowing(JoinPoint joinPoint, Log controllerLog, Exception e)
    {
        handleLog(joinPoint, controllerLog, e, null);
    }
 
    protected void handleLog(final JoinPoint joinPoint, Log controllerLog, final Exception e, Object jsonResult)
    {
        ......
    }
 
    ......
}

首先忽略掉一些具体的处理细节，这里使用了Spring五种通知里的两种：返回通知与异常通知。也就是说，加了@Log注解方法在方法执行完或者抛出异常后，都会进行日志的记录操作。

具体记录日志的方法在handleLog()方法中：

protected void handleLog(final JoinPoint joinPoint, Log controllerLog, final Exception e, Object jsonResult)
    {
        try
        {
            // 获取当前的用户
            LoginUser loginUser = SecurityUtils.getLoginUser();
 
            // *========数据库日志=========*//
            SysOperLog operLog = new SysOperLog();
            operLog.setStatus(BusinessStatus.SUCCESS.ordinal());
            // 请求的地址
            String ip = IpUtils.getIpAddr(ServletUtils.getRequest());
            operLog.setOperIp(ip);
            operLog.setOperUrl(ServletUtils.getRequest().getRequestURI());
            if (loginUser != null)
            {
                operLog.setOperName(loginUser.getUsername());
            }
            // 如果异常不为空，说明报错。设置状态为失败，设置错误信息为异常信息
            if (e != null)
            {
                operLog.setStatus(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, jsonResult);
            // 保存数据库
            AsyncManager.me().execute(AsyncFactory.recordOper(operLog));
        }
        catch (Exception exp)
        {
            // 记录本地异常日志
            log.error("==前置通知异常==");
            log.error("异常信息:{}", exp.getMessage());
            exp.printStackTrace();
        }
    }

1. 若依提供的用于存储操作日志的表名为sys_oper_log，对应的实体类就是SysOperLog
2. 若依通过自己写的一些工具类来获取用户的信息，如用户名、IP等。点开这些工具类我们发现其实使用的就是Spring或者SpringSecurity的一些常用的类，如RequestServletContext、SecurityContextHolder等，感兴趣的同学可以自行查看
3. 通过连接点JoinPoint获取目标的所属类和方法名
4. 处理注解参数和请求参数
5. 异步将日志存储到数据库

前三步就不说了，这里说一下第四步和第五步

处理请求参数

跟着源码一路点下来，看见获取请求参数的方法为setRequestValue

private void setRequestValue(JoinPoint joinPoint, SysOperLog operLog) throws Exception
{
    String requestMethod = operLog.getRequestMethod();
    if (HttpMethod.PUT.name().equals(requestMethod) || HttpMethod.POST.name().equals(requestMethod))
    {
        // 去被拦截的方法中提取参数。遍历参数，去掉文件对象、HttpServletRequest等参数
        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));
    }
}

若依对请求方式进行了判断，如果是put或者post方法，就去被拦截的方法中提取参数，并过滤掉文件对象、HttpServletRequest等参数。如果是其他请求方式就直接提取地址栏中的参数，我也写了相应注释。

异步存储日志

为了不影响业务的处理速度，若依写了一个异步的任务AsyncManager来存储日志，位于com/ruoyi/framework/manager包下。

public class AsyncManager
{
    // 操作延迟10毫秒
    private final int OPERATE_DELAY_TIME = 10;
 
    // 异步操作任务调度线程池
    private ScheduledExecutorService executor = SpringUtils.getBean("scheduledExecutorService");
 
    // 单例模式
    private AsyncManager(){}
 
    private static AsyncManager me = new AsyncManager();
 
    public static AsyncManager me()
    {
        return me;
    }
 
    // 执行任务
    public void execute(TimerTask task)
    {
        executor.schedule(task, OPERATE_DELAY_TIME, TimeUnit.MILLISECONDS);
    }
 
    // 停止任务线程池
    public void shutdown()
    {
        Threads.shutdownAndAwaitTermination(executor);
    }
}

我们发现，若依使用Java提供的ScheduledExecutorService来执行定时任务。由于AsyncManager并没有注册到Spring容器中，所有它没办法注入scheduledExecutorService，所以若依使用了一个工具类SpringUtils.getBean()从Spring容器中获取它。scheduledExecutorService这个容器在com/ruoyi/framework/config/ThreadPoolConfig.java中：

/**
 * 执行周期性或定时任务
 */
@Bean(name = "scheduledExecutorService")
protected ScheduledExecutorService scheduledExecutorService()
{
    return new ScheduledThreadPoolExecutor(corePoolSize,
            new BasicThreadFactory.Builder().namingPattern("schedule-pool-%d").daemon(true).build(),
            new ThreadPoolExecutor.CallerRunsPolicy())
    {
        @Override
        protected void afterExecute(Runnable r, Throwable t)
        {
            super.afterExecute(r, t);
            Threads.printException(r, t);
        }
    };
}

两个小细节

---

1. 根据IP查找地址

若依通过一个接口去查找IP所在的地址，具体的方法在com.ruoyi.common.utils.ip.AddressUtils中

2. getBean

若依使用ConfigurableListableBeanFactory的getBean()方法去获取Bean，其实这个接口继承自BeanFactory,使用的也是BeanFactory的getBean()方法

总结

---

• 标记了@Log注解的方法，在执行后或者抛出异常后会异步的将操作记录（IP、模块、请求方法、请求参数等）存到数据库中。
• 了解了他的写法之后，我们可以随意的改造它。比如我们还想存一些我们自己个性化需求的内容，再比如我们可以把日志存储到ElasticSearch中，再借助一些ETL工具，实现日志的可视化等等。