博主是在2018年中就接触了 RuoYi 项目 这个项目，对于当时国内的开源后台管理系统来说，RuoYi 算是一个完成度较高，易读易懂、界面简洁美观的前后端不分离项目。

对于当时刚入行还在写 jsp 模板的博主来说，RuoYi 项目在后台基础功能、模块划分、易用性和页面美观度上，对比同期用 Java 开源的前后端不分离后台项目整体上是高了一个等级的。并且项目 commit 频繁，代码质量不断提高、bug不断修复，使得这个项目在今天来说任然是具有学习价值的。

(资料图)

本文博主尽量用一个理性视角带领大家由浅入深看 RuoYi 项目v4.7.6版本的优秀设计。

一、快速了解

RuoYi 项目是一个基于 SpringBoot + Mybatis + Shiro开发的轻量级 Java 快速开发框架，它包含基础的后台管理功能以及权限控制。项目作者对于 RuoYi 项目的定调是这样的：

RuoYi是一款基于SpringBoot+Bootstrap的极速后台开发框架。RuoYi 是一个 Java EE 企业级快速开发平台，基于经典技术组合（Spring Boot、Apache Shiro、MyBatis、Thymeleaf、Bootstrap）。内置模块如：部门管理、角色用户、菜单及按钮授权、数据权限、系统参数、日志管理、通知公告等。在线定时任务配置；支持集群，支持多数据源，支持分布式事务。

二、多模块设计

如果想快速了解一个项目的设计理念那直接下载这个项目，查看项目结构即可略知一二。这里参考官网给出的项目结构：

com.ruoyi     ├── ruoyi-common            // 工具类│       └── annotation                    // 自定义注解│       └── config                        // 全局配置│       └── constant                      // 通用常量│       └── core                          // 核心控制│       └── enums                         // 通用枚举│       └── exception                     // 通用异常│       └── json                          // JSON数据处理│       └── utils                         // 通用类处理│       └── xss                           // XSS过滤处理├── ruoyi-framework         // 框架核心│       └── aspectj                       // 注解实现│       └── config                        // 系统配置│       └── datasource                    // 数据权限│       └── interceptor                   // 拦截器│       └── manager                       // 异步处理│       └── shiro                         // 权限控制│       └── web                           // 前端控制├── ruoyi-generator   // 代码生成（不用可移除）├── ruoyi-quartz      // 定时任务（不用可移除）├── ruoyi-system      // 系统代码├── ruoyi-admin       // 后台服务├── ruoyi-xxxxxx      // 其他模块

由上可知，RuoYi 前后端不分离项目按照模块划分成了七个模块

最后再列出项目 ruoyi-admin的模块依赖图，简单讲解下各个模块间的依赖关系

看完了 RuoYi 的项目结构与模块依赖关系，大家可以看看自己日常开发业务后台的项目结构。或多或少，大家都可能遇到过那种一把梭所以代码都全部放在同一个 Maven 模块的项目。对比 RuoYi 的项目结构，相信大家都会觉得多模块设计是比单模块更优的设计。

拆分出ruoyi-common模块后，其他插件模块可以只引用ruoyi-common的通用代码就能完成插件功能开发。拆分出ruoyi-framework模块后，项目中的核心配置代码全部放在ruoyi-framework中与ruoyi-admin分离，防止对ruoyi-admin的修改影响到项目核心配置。博主认为合理的模块拆分可以减少模块间的耦合与改动模块所带来的影响范围。

通过多模块设计将项目划分成 common -> system -> framework -> admin由低到高的核心模块以及插件形式的 common -> ruoyi-generator|ruoyi-quartz模块。模块之间尽量松耦合，方便模块升级、增减模块。

三、优雅的操作日志记录

在 RuoYi 项目中通过 com.ruoyi.framework.aspectj.LogAspect日志切面，以自定义日志注解作为切点来记录日志信息，这样可以避免在接口中进行重复的操作日志记录代码编写，以及日志记录发生异常也不影响接口返回。

自定义日志注解如下：

/**  * 自定义操作日志记录注解  *  * @author ruoyi  */  @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;      /**      * 排除指定的请求参数      */      public String[] excludeParamNames() default {};  }

可以看到 LogAspect注解类中定义了模块名称、业务操作类型（新增、修改、删除、导出等业务操作）、操作人类别（其他、后台、手机等）、是否保存请求的参数、是否保存响应的参数、排除指定的请求参数等六个属性。我们在使用自定义注解时，通常只用根据接口作用指定模块名称和业务操作类型就可以，日志注解使用如下：

@Log(title = "参数管理", businessType = BusinessType.INSERT)  @PostMapping("/add")  @ResponseBody  public AjaxResult addSave(@Validated SysConfig config) {...}

自定义日志注解切面代码如下：

/**  * 操作日志记录处理  *  * @author ruoyi  */  @Aspect  @Component  public class LogAspect {      private static final Logger log = LoggerFactory.getLogger(LogAspect.class);      /** 排除敏感属性字段 */      public static final String[] EXCLUDE_PROPERTIES = { "password", "oldPassword" ... };      /** 计算操作消耗时间 */      private static final ThreadLocal TIME_THREADLOCAL = new NamedThreadLocal("Cost Time");      /**      * 处理请求前执行      */      @Before(value = "@annotation(controllerLog)")      public void boBefore(JoinPoint joinPoint, Log controllerLog) {      TIME_THREADLOCAL.set(System.currentTimeMillis());      }      /**      * 处理完请求后执行      *      * @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)          ...    } }

通过 aop 切面对使用了日志注解的方法进行三个方面的切入：

在使用了日志切面后，操作日志记录的逻辑与后台各功能接口的业务逻辑相分离，减少了日志记录代码的的重复编写，后期修改日志记录逻辑只用修改切面代码，提高了操作日志记录的可维护性，也避免了日志记录发生异常时影响业务接口，使用线程池插入日志记录还可以缩短接口响应时长。可以看到通过切面完成日志记录有这么多好处。

其实 RuoYi 中不仅仅只有日志记录使用了切面处理，像是日常开发中数据过滤权限、多数据源切换等也都使用了切面处理。使用切面可以让我们集中处理单一逻辑、方便增添关注点、减少重复代码、对控制层零侵入性以及提高可维护性。

四、总结

本文目前从模块设计、操作日志记录等两个方面对 RuoYi 项目进行了讲解。如果大家也使用过 RuoYi 项目。

标签：