来源：
https://mp.weixin.qq.com/s/TJwh1YrUmEDRCwYHcXl3Vg

有很多读者都希望我出一些详细介绍 Java 实战类项目的文章，毕竟项目实战经验还是挺重要的，不论是对于找工作还是提高个人工程能力。我自己也发现很多读者不怎么会学习开源项目，不知道如何把开源项目的一些精华为自己所用。

我们这里分析的是 eladmin[1] 这个基于 Spring Boot + Spring Security +JPA +Vue 的前后端分离的后台管理系统。

荐过这个项目。

后台首页

开源工具库

这部分简单分析一下项目使用到的一些比较有用的开源工具库：MapStruct(Java 对象映射框架)、OSHI（基于 JNA 的操作系统和硬件信息库）、Hutool（Java 工具类库）。

MapStruct

MapStruct[2] 不仅能够在 bean 之间复制属性，还能够在不同类型之间自动转换。

相比于其他常见的映射框架， Dozer、Orika、ModelMapper、JMapper，MapStruct 的性能更好。

OSHI

OSHI[5] 是一款为 Java 语言提供的基于 JNA 的（本机）操作系统和硬件信息库。

通过 OSHI ，我们不需要安装任何其他本机库，就能查看内存和 CPU 使用率、磁盘和分区使用情况、设备、传感器等信息。

OSHI 旨在提供一种跨平台的实现来检索系统信息，支持 Windows、Linux、MacOS、Unix 等主流操作系统。

使用 oshi 你可以轻松制作出项目常用的系统监控功能，如下图所示：

Hutool

Hutool[6] 一个非常实用的 Java 工具类库，对文件、流、加密解密、转码、正则、线程、XML 等 JDK 方法进行了封装。

小技巧

这部分内容会简单分析一下从这个开源项目中看到的一些亮点以及小技巧。

优化表命名

根据项目不同的 Module 作为表名的前缀，这样看起来更加直观。

巧用 AOP 简化代码

AOP(Aspect-Oriented Programming:面向切面编程) 能够将那些与业务无关，却为业务模块所共同调用的逻辑或责任（例如事务处理、日志管理、权限控制等）封装起来，便于减少系统的重复代码，降低模块间的耦合度，提高系统可拓展性和可维护性。

这个项目中就大量使用了 AOP 思想。简单举两个例子吧！

日志记录

利用 AOP 方式记录日志，只需要在 controller 的方法上使用 @Log("") 注解，就可以将用户操作记录到数据库，源码可查看 eladmin-logging这个 Module。。

@Log("新增用户")
@PostMapping(value = "/users")
public ResponseEntity create(@Validated @RequestBody User resources){
    checkLevel(resources);
    return new ResponseEntity(userService.create(resources),HttpStatus.CREATED);
}

Redis 限流

利用 AOP 方式对接口进行限流，只需要在 controller 的方法上使用@Limit("") 注解即可，源码可查看 eladmin-common这个 Module。

/**
 * 测试限流注解，下面配置说明该接口 60秒内最多只能访问 10次，保存到redis的键名为 limit_test，
 */
@AnonymousGetMapping
@ApiOperation("测试")
@Limit(key = "test", period = 60, count = 10, name = "testLimit", prefix = "limit")
public int test() {
     return ATOMIC_INTEGER.incrementAndGet();
}

基于 RBAC 的权限模块设计

系统权限控制采用 RBAC 基于角色的权限访问控制（Role-Based Access Control） 思想（一种最常见的权限管理思想，在一些对于全权限控制要求比较严格的系统会使用到）。

什么是 RBAC 呢？

简单地说：一个用户可以拥有若干角色，每一个角色有可以被分配若干权限这样，就构造成“用户-角色-权限” 的授权模型。在这种模型中，用户与角色、角色与权限之间构成了多对多的关系，如下图

RBAC

在 RBAC 中，权限与角色相关联，用户通过成为适当角色的成员而得到这些角色的权限。这就极大地简化了权限的管理。

本系统的权限设计相关的表如下（一共 5 张表，2 张用户建立表之间的联系）：

通过这个权限模型，我们可以创建不同的角色并为不同的角色分配不同的权限范围（菜单）。

自定义权限验证方式

Spring Security 提供了Spring EL表达式，允许我们在定义接口的方法上面添加注解来实现权限控制。比如下面的接口表示用户拥有 admin、menu:edit 权限中的任意一个就能能访问update接口。

但是，由于每个接口都需要给超级管理员放行，所以单纯使用这种注解的方式每次都需要重复的添加 admin 权限、

因此我们可以加入自定义权限验证方式，在验证的时候默认给拥有 admin 权限的用户放行。

源码：

// eladmin-common -> me.zhengjie.config.ElPermissionConfig
@Service(value = "el")
public class ElPermissionConfig {
 
    public Boolean check(String ...permissions){
        // 获取当前用户的所有权限
        List<String> elPermissions = SecurityUtils.getCurrentUser().getAuthorities().stream().map(GrantedAuthority::getAuthority).collect(Collectors.toList());
        // 判断当前用户的所有权限是否包含接口上定义的权限
        return elPermissions.contains("admin") || Arrays.stream(permissions).anyMatch(elPermissions::contains);
    }
}

使用方式：

@ApiOperation("查询任务执行日志")
@GetMapping(value = "/logs")
@PreAuthorize("@el.check('timing:list')")
public ResponseEntity