字典管理
2026/3/16大约 3 分钟使用手册使用与管理界面操作操作说明
概述
在常规的系统开发中,是离不开 字典 的使用的。常规的系统设计会将字典类型的数据设计成 字典表,在通过关联查询给用户提供更直观、更易理解的信息展示。除此以外,特别是在 Java 编程语言中,会使用定义枚举类型来定义 字典。
这两种方式都各有利弊:
- 使用
字典表:就需要与实际业务的 SQL 进行强关联,不容易做成通用性。而且,频繁的查询会增加数据的压力,而且不便于实际代码使用。 - 使用枚举:使用枚举类型字典,可以很好的与代码融合,甚至作为参数进行前后端传输。但这种方式不好与 SQL 进行融合。
如果深入思考一下,其实 字典 终极用途就是为了 更人性化的显示信息同时支持动态的管理。不管是使用 SQL 关联查询的方式还是 Java 枚举的方式,都是为了给用户更直观的信息展示,而不是单纯展示关联的 id 或者 code。
因此,Dante Cloud 选择了 Java 枚举的方式来做 字典,同时提供了聚合管理方式来支持字典管理。这样做的好处有以下几点:
- Java 枚举可以很好的和 Java 代码融合,不管是作为分类还是类型判断都很方便。
- 使用枚举聚合的机制,实现了 Java 枚举的完全动态管理,无需手动录入数据。详见:【枚举字典聚合】
- 利用 JPA 实体支持枚举属性以及支持使用枚举作为查询参数的特性,将 Java 枚举与实际 SQL 查询进行关联,而无需单独设计
字典表进行关联查询。 - 提供统一的接口,前端使用字典时
随用随取,并采用前端缓存避免反复查询后端。既提高的数据使用效率又避免大量查询或者缓存数据影响性能。
[一]字典管理
在系统前端提供了 字典 统一管理界面。

注意
- Dante Cloud 字典主要用于前端下拉框或者表格等数据的转换显示,所有查询过或者使用到的字典数据均缓存于前端。因此,使用字典管理变更过字典信息,是无法实时显示的,需要用户退出系统重新登录后才会显示最新的信息。
- 对于系统自动聚合的字典分类下的数据,只能进行修改。如果在该分类下新增条目,与后端枚举不对应,会出现异常。如果仅在前端删除该分类下的条目,后端枚举没有同步修改,系统重新启动后还会将已删除条目补充进来。原理详见:【枚举字典聚合】
