MySQL表设计---字典表的设计与接口实现

矫情吗；* 2023-10-08 21:42 63阅读 0赞

#### 文章目录 ####

*  1、字典表的意义
 *  2、若依的字典表结构
 *  3、ruoyi枚举类
 *  4、代码.ruoyi字典查询接口与缓存

![在这里插入图片描述][2acab2b8efba476f9d73f9e0950cf0bd.png]

--------------------

## 1、字典表的意义 ##

假设有一个职员表：

这个表有一亿条数据，现在用户要求证件类型要从"身份证"改为"居民身份证"，这样一下更新所有数据，能完成，但维护困难，由此，考虑这么实现：

<table> 
 <thead> 
  <tr> 
   <th>代号</th> 
   <th>身份证类型</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>001</td> 
   <td>身份证</td> 
  </tr> 
  <tr> 
   <td>002</td> 
   <td>暂住证</td> 
  </tr> 
 </tbody> 
</table>

加了这样一个身份证类型表后，职员表变为：

此时把"身份证"改为"居民身份证"，只需改身份证类型表的一行数据的一个字段。但此时有新的问题了，国籍、学历也是可以枚举完的字段，那再加个学历类型表？显然不行，如果这种字段有十几个，那以后查询就要进行几十个表的联结(join)操作。先看实现：

系统代码表

<table> 
 <thead> 
  <tr> 
   <th>标识</th> 
   <th><code>分类</code></th> 
   <th>内容</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>111</td> 
   <td>Country</td> 
   <td>中国</td> 
  </tr> 
  <tr> 
   <td>112</td> 
   <td>Country</td> 
   <td>美国</td> 
  </tr> 
  <tr> 
   <td>……</td> 
   <td>……</td> 
   <td>……</td> 
  </tr> 
  <tr> 
   <td>001</td> 
   <td>ID</td> 
   <td>身份证</td> 
  </tr> 
  <tr> 
   <td>002</td> 
   <td>ID</td> 
   <td>暂住证</td> 
  </tr> 
 </tbody> 
</table>

即加一个类型字段，以区分是具体哪个字段的。

## 2、若依的字典表结构 ##

基于以上一个简单的背景，来看若依框架提供的字典表结构：ruoyi有两张字典相关表，一个`字典类型表sys_dict_type`，一个`字典数据表sys_dict_data`，将字典定义和数据分开。先看字典类型表：  
![在这里插入图片描述][22b25af6b43a47f985e848f4b913e787.png]  
![在这里插入图片描述][575ec1880e3646db9d22b5d88953c64d.png]

再看字典数据表：

![在这里插入图片描述][8430698c6b1d4bff94ed8a9fb445c18e.png]  
![在这里插入图片描述][a8018ad136ca4c5ea46dcf0e28c92122.png]

*  两张表通过字典类型字段dict\_type关联
 *  字典数据表中有`顺序字段`dict\_sort，可调整枚举对应显示顺序
 *  字典数据表有键和值字段，页面显示值dict\_label，数据库中存代号dict\_value
 *  两张表都有status字段控制整条数据是否可用

--------------------

字典数据表支持`层级`也是一个要考虑的点，如下面这个需求：

![在这里插入图片描述][ad5c730234dd446fae24753d1ada3c75.png]  
此时，可以增加一个parent\_id可以在数据表中`递归查询`所有的层级数据：

![在这里插入图片描述][846fc930a4124cf8996af78bc92e0146.png]  
这个需求的实现，参考：[https://blog.csdn.net/llg\_\_\_/article/details/129683540][https_blog.csdn.net_llg_article_details_129683540]

## 3、ruoyi枚举类 ##

字典中定义好数据了，再写一个对应于dict\_type的枚举类，枚举类中定义值，方便后面代码中调用枚举值做业务处理。以ruoyi的审核状态字典为例：

![在这里插入图片描述][862432a8dc974f6ea396f866fbf51096.png]  
枚举类定义：

import brave.internal.Nullable;
    
    import java.util.HashMap;
    import java.util.Map;
    
    public enum AuditStatusEnum {
        
        BEFORE("before","待提交"),
        WAIT("wait", "待审核"),
        NO("no", "审核未通过"),
        PASS("pass","审核通过");
    
        String code;
        String name;
    
        AuditStatusEnum(String code, String name) {
        
            this.code = code;
            this.name = name;
        }
    
        private static final Map<String, AuditStatusEnum> mappings = new HashMap<>(5);
    
        static {
        
            for (AuditStatusEnum statusEnum : values()) {
        
                mappings.put(statusEnum.code, statusEnum);
            }
        }
    
        public String getCode(){
        
            return code;
        }
    
        public String getName(){
        
            return name;
        }
    
        @Nullable
        public static AuditStatusEnum resolve(@Nullable String code) {
        
            return (code != null ? mappings.get(code) : null);
        }
    }

*  values()方法作用是获取枚举成员的所有值，返回一个数组
 *  写静态代码块，以枚举值的code为键，以枚举值本身为值创建Map集合
 *  最后的静态方法resolve()则是根据枚举值的code查询枚举值
 *  这里是利用了Java类加载的时机之一：访问类的静态方法，执行静态代码块，初始化Map方便后面查询，妙！

关于Java类加载的时机，访问[这里][Link 1]。

/定义了上面的字典对应的枚举类后，写业务逻辑代码：
    
    
    if (xxDto.getAuditCode().equals(AuditStatusEnum.NO.getCode())){
        
    	return new MyException("审核未通过，不可操作！");
    }

## 4、代码.ruoyi字典查询接口与缓存 ##

定义接口，查询不同类型下的字典的key和value，给前端展示（当然前端也可以用html定义下拉框选项写死几个)

/**
     * 根据字典类型查询字典数据信息
     */
    @GetMapping(value = "/type/{dictType}")
    public AjaxResult dictType(@PathVariable String dictType) {
        
        return AjaxResult.success(dictTypeService.selectDictDataByType(dictType));
    }

service层接口：

/**
     * 根据字典类型查询字典数据
     *
     * @param dictType 字典类型
     * @return 字典数据集合信息
     */
    public List<SysDictData> selectDictDataByType(String dictType);

service接口实现类：这里是先在`字典缓存`中查，如果有，直接返回，如果缓存中没有，则调mapper层去数据库查，并把结果查询结果写进缓存备用

/**
     * 根据字典类型查询字典数据
     *
     * @param dictType 字典类型
     * @return 字典数据集合信息
     */
    @Override
    public List<SysDictData> selectDictDataByType(String dictType) {
        
        List<SysDictData> dictDatas = DictUtils.getDictCache(dictType);
        if (StringUtils.isNotNull(dictDatas)) {
        
            return dictDatas;
        }
        dictDatas = dictDataMapper.selectDictDataByType(dictType);
        if (StringUtils.isNotNull(dictDatas)) {
        
            DictUtils.setDictCache(dictType, dictDatas);
            return dictDatas;
        }
        return null;
    }

获取字典缓存的方法定义：

/**
     * 获取字典缓存
     * 
     * @param key 参数键
     * @return dictDatas 字典数据列表
     */
    public static List<SysDictData> getDictCache(String key)
    {
        
        Object cacheObj = SpringUtils.getBean(RedisService.class).getCacheObject(getCacheKey(key));
        if (StringUtils.isNotNull(cacheObj))
        {
        
            List<SysDictData> dictDatas = StringUtils.cast(cacheObj);
            return dictDatas;
        }
        return null;
    }

此时，前端调用接口，传入对应的dictType，即可拿到下拉框中的字典字段：

![在这里插入图片描述][3d9169c875f849298f14de65ea75688c.png]

[2acab2b8efba476f9d73f9e0950cf0bd.png]: https://img-blog.csdnimg.cn/2acab2b8efba476f9d73f9e0950cf0bd.png
[22b25af6b43a47f985e848f4b913e787.png]: https://img-blog.csdnimg.cn/22b25af6b43a47f985e848f4b913e787.png
[575ec1880e3646db9d22b5d88953c64d.png]: https://img-blog.csdnimg.cn/575ec1880e3646db9d22b5d88953c64d.png
[8430698c6b1d4bff94ed8a9fb445c18e.png]: https://img-blog.csdnimg.cn/8430698c6b1d4bff94ed8a9fb445c18e.png
[a8018ad136ca4c5ea46dcf0e28c92122.png]: https://img-blog.csdnimg.cn/a8018ad136ca4c5ea46dcf0e28c92122.png
[ad5c730234dd446fae24753d1ada3c75.png]: https://img-blog.csdnimg.cn/ad5c730234dd446fae24753d1ada3c75.png
[846fc930a4124cf8996af78bc92e0146.png]: https://img-blog.csdnimg.cn/846fc930a4124cf8996af78bc92e0146.png
[https_blog.csdn.net_llg_article_details_129683540]: https://blog.csdn.net/llg___/article/details/129683540
[862432a8dc974f6ea396f866fbf51096.png]: https://img-blog.csdnimg.cn/862432a8dc974f6ea396f866fbf51096.png
[Link 1]: https://www.cnblogs.com/zhixie/p/11766080.html
[3d9169c875f849298f14de65ea75688c.png]: https://img-blog.csdnimg.cn/3d9169c875f849298f14de65ea75688c.png