- 应用场景
当存储的值和需要展示的值有对应关系,并且需要支持可配置的情况,比如01代表红色,02代表蓝色,后台只存储01,02这种数值,又需要进行前端展示的时候,用固定的表去做join查询比较复杂,还需要单独开发配置表。通过这个功能可以简化开发
最新版本可以导入导出整个字典分组
- 创建字典
在系统工具-数据字典中创建对应的字典 - 确保和framework服务连接到了同一个Redis中间件
- service module 添加依赖
<!--微服务底层公用代码-->
<dependency>
<groupId>com.hvisions</groupId>
<artifactId>hvisions-common-springboot-starter</artifactId>
<version>3.5.1</version>
</dependency>
- 编写代码(只需要在返回对象实现DictionaryObject接口,并且用@DictionaryKey来标注对应的属性和数据字典),在返回前端的时候会自动添加属性值,后端只需要手动设置value字段即可
public class LocationDTO implements DictionaryObject {
// 前端传递的值
@ApiModelProperty(value = "字典值")
private String value;
@ApiModelProperty(value = "字典显示值",readOnly = true)
@DictionaryKey(dictionaryValue = "{对应的属性编码,这里是'value'}",
dictionaryCode = "{数据字典编码,配置时候输入的字典编码}")
private String description;
}