EzCloud 系统数据字典模块源码解析：全局枚举统一管理、多租户隔离、业务下拉复用实现

前言

企业级多租户系统开发过程中，业务存在大量固定选项：订单类型、维修故障分类、客户等级、审批状态、物料规格等。常规开发习惯是硬编码枚举写在代码里，极易出现问题：修改分类需要改代码重启服务、各个业务模块枚举重复定义、多租户需要个性化选项时无法区分、前端下拉框需要前后端反复对齐字段。EzCloud 搭建独立数据字典通用模块，统一管理全系统所有分类选项，支持后台可视化新增、修改分类项，所有业务下拉选择全部调用字典数据，无需重复定义枚举，同时支持租户自定义字典，适配不同企业个性化选型需求。

1、数据字典模块工程分层结构

模块三层分层解耦，和全业务解耦适配：

dict-base：字典分类、字典项基础数据表维护，管理大类编码、名称、状态排序
dict-query：字典缓存、租户过滤查询逻辑，本地缓存减少数据库频繁查询
dict-ref：业务引用适配层，提供统一工具类，给 ERP、维保、CRM、OA 提供字典取值、翻译接口进销存单据、售后报修、客户档案、审批流程内所有下拉选项，全部调用字典接口，不再各自维护枚举。项目完整源码、各业务模块示例、配套开发文档存放地址：https://gitee.com/tan-tianming/ez-cloud

2、核心源码：带租户隔离的字典查询与字段翻译

java

复制代码

@Service
public class DictDataServiceImpl implements DictDataService {

    @Autowired
    private DictTypeMapper dictTypeMapper;
    @Autowired
    private DictDataMapper dictDataMapper;
    @Autowired
    private RedisTemplate<String, Object> redisTemplate;

    @Override
    public List<DictDataVO> getDictList(String dictCode, Long tenantId) {
        // 优先读取Redis缓存，提升查询效率
        String cacheKey = "dict:" + tenantId + ":" + dictCode;
        List<DictDataVO> cacheList = (List<DictDataVO>) redisTemplate.opsForValue().get(cacheKey);
        if (CollUtil.isNotEmpty(cacheList)) {
            return cacheList;
        }
        // 数据库查询，区分公共字典、租户私有字典
        LambdaQueryWrapper<DictDataDO> wrapper = Wrappers.lambdaQuery();
        wrapper.eq(DictDataDO::getDictCode, dictCode);
        wrapper.and(w -> w.eq(DictDataDO::getTenantId, tenantId).or(DictDataDO::getIsPublic, true));
        wrapper.orderByAsc(DictDataDO::getSort);
        List<DictDataDO> dataList = dictDataMapper.selectList(wrapper);
        List<DictDataVO> result = BeanUtil.copyToList(dataList, DictDataVO.class);
        // 写入缓存
        redisTemplate.opsForValue().set(cacheKey, result, 1, TimeUnit.HOURS);
        return result;
    }

    @Override
    public String translateDict(String dictCode, String value, Long tenantId) {
        List<DictDataVO> list = getDictList(dictCode, tenantId);
        return list.stream()
                .filter(item -> item.getValue().equals(value))
                .map(DictDataVO::getLabel)
                .findFirst()
                .orElse(value);
    }
}

代码设计技术亮点

区分公共全局字典、租户私有字典；公共选项全企业通用，每家企业可新增独有的字典项，适配个性化分类；
Redis 做缓存优化，高频下拉查询不用频繁查库，保障前端页面加载速度；
提供通用翻译工具方法，后端打印日志、导出 Excel 可一键把编码转为中文名称，不用手写大量判断逻辑；
字典改动自动清理对应缓存，修改后实时生效，不用重启服务。

3、模块核心技术能力

可视化后台维护：所有分类文字、编码、排序、启用状态页面直接编辑，不用修改 Java 代码；
前端统一适配：前端通过字典编码一键获取下拉列表，ERP、维保、CRM 共用一套前端字典请求逻辑；
数据翻译全覆盖：日志打印、Excel 导出、报表展示自动翻译编码，阅读更直观；
字典启停管控：可禁用无效选项，实现软删除，历史旧单据数据不受影响。

4、二次开发拓展特性

新增业务下拉选项无需新建枚举类，后台新增字典即可完成全链路适配；
插件化独立模块，无自定义分类需求可直接移除，不影响其他业务模块；
支持字典批量导入导出，新项目初始化可以批量批量预置分类；
适配多租户 SaaS，不同企业同一字典编码可以配置不一样的选项，互不干扰。

总结

EzCloud 数据字典模块统一收拢全系统分类枚举能力，解决硬编码枚举维护麻烦、多租户无法个性化、前后端联调繁琐的开发痛点。依靠缓存加速、租户区分、通用翻译能力，极大降低全业务的重复开发量，是企业级多租户系统必备基础模块。