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); } }

代码设计技术亮点

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

3、模块核心技术能力

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

4、二次开发拓展特性

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

总结

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