1. 部门的缓存刷新机制

src/main/java/cn/iocoder/dashboard/modules/system/dal/mysql/dao/dept/SysDeptMapper.java

@@ -7,6 +7,7 @@ import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
 import com.baomidou.mybatisplus.core.mapper.BaseMapper;
 import org.apache.ibatis.annotations.Mapper;
 
+import java.util.Date;
 import java.util.List;
 
 @Mapper
@@ -30,4 +31,9 @@ public interface SysDeptMapper extends BaseMapper<SysDeptDO> {
         return selectCount(new QueryWrapper<SysDeptDO>().eq("parent_id", parentId));
     }
 
+    default boolean selectExistsByUpdateTimeAfter(Date maxUpdateTime) {
+        return selectOne(new QueryWrapper<SysDeptDO>().select("id")
+                .gt("update_time", maxUpdateTime).last("LIMIT 1")) != null;
+    }
+
 }

src/main/java/cn/iocoder/dashboard/modules/system/mq/consumer/dept/SysDeptRefreshConsumer.java

@@ -0,0 +1,29 @@
+package cn.iocoder.dashboard.modules.system.mq.consumer.dept;
+
+import cn.iocoder.dashboard.framework.redis.core.pubsub.AbstractChannelMessageListener;
+import cn.iocoder.dashboard.modules.system.mq.message.dept.SysDeptRefreshMessage;
+import cn.iocoder.dashboard.modules.system.service.dept.SysDeptService;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import javax.annotation.Resource;
+
+/**
+ * 针对 {@link SysDeptRefreshMessage} 的消费者
+ *
+ * @author 芋道源码
+ */
+@Component
+@Slf4j
+public class SysDeptRefreshConsumer extends AbstractChannelMessageListener<SysDeptRefreshMessage> {
+
+    @Resource
+    private SysDeptService deptService;
+
+    @Override
+    public void onMessage(SysDeptRefreshMessage message) {
+        log.info("[onMessage][收到 Dept 刷新消息]");
+        deptService.initLocalCache();
+    }
+
+}

src/main/java/cn/iocoder/dashboard/modules/system/mq/message/dept/SysDeptRefreshMessage.java

@@ -0,0 +1,17 @@
+package cn.iocoder.dashboard.modules.system.mq.message.dept;
+
+import cn.iocoder.dashboard.framework.redis.core.pubsub.ChannelMessage;
+import lombok.Data;
+
+/**
+ * 部门数据刷新 Message
+ */
+@Data
+public class SysDeptRefreshMessage implements ChannelMessage {
+
+    @Override
+    public String getChannel() {
+        return "system.dept.refresh";
+    }
+
+}

src/main/java/cn/iocoder/dashboard/modules/system/mq/producer/dept/SysDeptProducer.java

@@ -0,0 +1,27 @@
+package cn.iocoder.dashboard.modules.system.mq.producer.dept;
+
+import cn.iocoder.dashboard.framework.redis.core.util.RedisMessageUtils;
+import cn.iocoder.dashboard.modules.system.mq.message.dept.SysDeptRefreshMessage;
+import org.springframework.data.redis.core.StringRedisTemplate;
+import org.springframework.stereotype.Component;
+
+import javax.annotation.Resource;
+
+/**
+ * Dept 部门相关消息的 Producer
+ */
+@Component
+public class SysDeptProducer {
+
+    @Resource
+    private StringRedisTemplate stringRedisTemplate;
+
+    /**
+     * 发送 {@link SysDeptRefreshMessage} 消息
+     */
+    public void sendMenuRefreshMessage() {
+        SysDeptRefreshMessage message = new SysDeptRefreshMessage();
+        RedisMessageUtils.sendChannelMessage(stringRedisTemplate, message);
+    }
+
+}

src/main/java/cn/iocoder/dashboard/modules/system/service/dept/SysDeptService.java

@@ -20,16 +20,9 @@ import java.util.Map;
 public interface SysDeptService {
 
     /**
-     * 初始化
+     * 初始化部门的本地缓存
      */
-    void init();
-
-    /**
-     * 获得所有部门列表
-     *
-     * @return 部门列表
-     */
-    List<SysDeptDO> listDepts();
+    void initLocalCache();
 
     /**
      * 获得指定编号的部门列表

src/main/java/cn/iocoder/dashboard/modules/system/service/dept/impl/SysDeptServiceImpl.java

@@ -3,6 +3,7 @@ package cn.iocoder.dashboard.modules.system.service.dept.impl;
 import cn.hutool.core.collection.CollUtil;
 import cn.iocoder.dashboard.common.enums.CommonStatusEnum;
 import cn.iocoder.dashboard.common.exception.util.ServiceExceptionUtil;
+import cn.iocoder.dashboard.framework.mybatis.core.dataobject.BaseDO;
 import cn.iocoder.dashboard.modules.system.controller.dept.vo.dept.SysDeptCreateReqVO;
 import cn.iocoder.dashboard.modules.system.controller.dept.vo.dept.SysDeptListReqVO;
 import cn.iocoder.dashboard.modules.system.controller.dept.vo.dept.SysDeptUpdateReqVO;
@@ -10,19 +11,18 @@ import cn.iocoder.dashboard.modules.system.convert.dept.SysDeptConvert;
 import cn.iocoder.dashboard.modules.system.dal.mysql.dao.dept.SysDeptMapper;
 import cn.iocoder.dashboard.modules.system.dal.mysql.dataobject.dept.SysDeptDO;
 import cn.iocoder.dashboard.modules.system.enums.dept.DeptIdEnum;
+import cn.iocoder.dashboard.modules.system.mq.producer.dept.SysDeptProducer;
 import cn.iocoder.dashboard.modules.system.service.dept.SysDeptService;
 import com.google.common.collect.ImmutableMap;
 import com.google.common.collect.ImmutableMultimap;
 import com.google.common.collect.Multimap;
 import lombok.extern.slf4j.Slf4j;
+import org.springframework.scheduling.annotation.Scheduled;
 import org.springframework.stereotype.Service;
 
 import javax.annotation.PostConstruct;
 import javax.annotation.Resource;
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
+import java.util.*;
 
 import static cn.iocoder.dashboard.modules.system.enums.SysErrorCodeConstants.*;
 
@@ -35,6 +35,12 @@ import static cn.iocoder.dashboard.modules.system.enums.SysErrorCodeConstants.*;
 @Slf4j
 public class SysDeptServiceImpl implements SysDeptService {
 
+    /**
+     * 定时执行 {@link #schedulePeriodicRefresh()} 的周期
+     * 因为已经通过 Redis Pub/Sub 机制，所以频率不需要高
+     */
+    private static final long SCHEDULER_PERIOD = 5 * 60 * 1000L;
+
     /**
      * 部门缓存
      * key：部门编号 {@link SysDeptDO#getId()}
@@ -50,30 +56,64 @@ public class SysDeptServiceImpl implements SysDeptService {
      * 这里声明 volatile 修饰的原因是，每次刷新时，直接修改指向
      */
     private volatile Multimap<Long, SysDeptDO> parentDeptCache;
+    /**
+     * 缓存部门的最大更新时间，用于后续的增量轮询，判断是否有更新
+     */
+    private volatile Date maxUpdateTime;
 
     @Resource
     private SysDeptMapper deptMapper;
 
+    @Resource
+    private SysDeptProducer deptProducer;
+
     @Override
     @PostConstruct
-    public void init() {
-        // 从数据库中读取
-        List<SysDeptDO> sysDeptDOList = deptMapper.selectList();
+    public synchronized void initLocalCache() {
+        // 获取部门列表，如果有更新
+        List<SysDeptDO> deptList = this.loadDeptIfUpdate(maxUpdateTime);
+        if (CollUtil.isEmpty(deptList)) {
+            return;
+        }
+
         // 构建缓存
         ImmutableMap.Builder<Long, SysDeptDO> builder = ImmutableMap.builder();
         ImmutableMultimap.Builder<Long, SysDeptDO> parentBuilder = ImmutableMultimap.builder();
-        sysDeptDOList.forEach(sysRoleDO -> {
+        deptList.forEach(sysRoleDO -> {
             builder.put(sysRoleDO.getId(), sysRoleDO);
             parentBuilder.put(sysRoleDO.getParentId(), sysRoleDO);
         });
         // 设置缓存
         deptCache = builder.build();
         parentDeptCache = parentBuilder.build();
-        log.info("[init][初始化 Dept 数量为 {}]", sysDeptDOList.size());
+        assert deptList.size() > 0; // 断言，避免告警
+        maxUpdateTime = deptList.stream().max(Comparator.comparing(BaseDO::getUpdateTime)).get().getUpdateTime();
+        log.info("[init][初始化 Dept 数量为 {}]", deptList.size());
     }
 
-    @Override
-    public List<SysDeptDO> listDepts() {
+    @Scheduled(fixedDelay = SCHEDULER_PERIOD, initialDelay = SCHEDULER_PERIOD)
+    public void schedulePeriodicRefresh() {
+        initLocalCache();
+    }
+
+    /**
+     * 如果部门发生变化，从数据库中获取最新的全量部门。
+     * 如果未发生变化，则返回空
+     *
+     * @param maxUpdateTime 当前部门的最大更新时间
+     * @return 部门列表
+     */
+    private List<SysDeptDO> loadDeptIfUpdate(Date maxUpdateTime) {
+        // 第一步，判断是否要更新。
+        if (maxUpdateTime == null) { // 如果更新时间为空，说明 DB 一定有新数据
+            log.info("[loadMenuIfUpdate][首次加载全量部门]");
+        } else { // 判断数据库中是否有更新的部门
+            if (!deptMapper.selectExistsByUpdateTimeAfter(maxUpdateTime)) {
+                return null;
+            }
+            log.info("[loadMenuIfUpdate][增量加载全量部门]");
+        }
+        // 第二步，如果有更新，则从数据库加载所有部门
         return deptMapper.selectList();
     }
 
@@ -134,6 +174,8 @@ public class SysDeptServiceImpl implements SysDeptService {
         // 插入部门
         SysDeptDO dept = SysDeptConvert.INSTANCE.convert(reqVO);
         deptMapper.insert(dept);
+        // 发送消息
+        deptProducer.sendMenuRefreshMessage();
         return dept.getId();
     }
 
@@ -144,6 +186,8 @@ public class SysDeptServiceImpl implements SysDeptService {
         // 更新部门
         SysDeptDO updateObj = SysDeptConvert.INSTANCE.convert(reqVO);
         deptMapper.updateById(updateObj);
+        // 发送消息
+        deptProducer.sendMenuRefreshMessage();
     }
 
     @Override
@@ -156,6 +200,8 @@ public class SysDeptServiceImpl implements SysDeptService {
         }
         // 删除部门
         deptMapper.deleteById(id);
+        // 发送消息
+        deptProducer.sendMenuRefreshMessage();
     }
 
     private void checkCreateOrUpdate(Long id, Long parentId, String name) {

src/main/java/cn/iocoder/dashboard/modules/system/service/dict/impl/SysDictDataServiceImpl.java

@@ -82,7 +82,7 @@ public class SysDictDataServiceImpl implements SysDictDataService {
 
     @Override
     @PostConstruct
-    public void initLocalCache() {
+    public synchronized void initLocalCache() {
         // 获取字典数据列表，如果有更新
         List<SysDictDataDO> dataList = this.loadDictDataIfUpdate(maxUpdateTime);
         if (CollUtil.isEmpty(dataList)) {

src/main/java/cn/iocoder/dashboard/modules/system/service/permission/impl/SysMenuServiceImpl.java

@@ -21,6 +21,9 @@ import com.google.common.collect.Multimap;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.scheduling.annotation.Scheduled;
 import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.transaction.support.TransactionSynchronization;
+import org.springframework.transaction.support.TransactionSynchronizationManager;
 
 import javax.annotation.PostConstruct;
 import javax.annotation.Resource;
@@ -169,6 +172,8 @@ public class SysMenuServiceImpl implements SysMenuService {
         SysMenuDO menu = SysMenuConvert.INSTANCE.convert(reqVO);
         initMenuProperty(menu);
         menuMapper.insert(menu);
+        // 发送刷新消息
+        menuProducer.sendMenuRefreshMessage();
         // 返回
         return menu.getId();
     }
@@ -196,6 +201,7 @@ public class SysMenuServiceImpl implements SysMenuService {
      *
      * @param menuId 菜单编号
      */
+    @Transactional
     public void deleteMenu(Long menuId) {
         // 校验更新的菜单是否存在
         if (menuMapper.selectById(menuId) == null) {
@@ -213,6 +219,15 @@ public class SysMenuServiceImpl implements SysMenuService {
         menuMapper.deleteById(menuId);
         // 删除授予给角色的权限
         permissionService.processMenuDeleted(menuId);
+        // 发送刷新消息. 注意，需要事务提交后，在进行发送消息。不然 db 还未提交，结果缓存先刷新了
+        TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() {
+
+            @Override
+            public void afterCommit() {
+                menuProducer.sendMenuRefreshMessage();
+            }
+
+        });
     }
 
     @Override