一、 数据字典介绍

何为数据字典？数据字典就是管理系统常用的分类数据或者一些固定数据，例如：省市区三级联动数据、民族数据、行业数据、学历数据等，由于该系统大量使用这种数据，所以我们要做一个数据管理方便管理系统数据，一般系统基本都会做数据管理。

1、页面效果

2 表设计

3 数据分析

parent_id：
上级id，通过id与parent_id构建上下级关系，例如：我们要获取所有行业数据，那么只需要查询parent_id=20000的数据
name：名称，例如：填写用户信息，我们要select标签选择民族，“汉族”就是数据字典的名称
value：值，例如：填写用户信息，我们要select标签选择民族，“1”（汉族的标识）就是数据字典的值
dict_code：编码，编码是我们自定义的，全局唯一，例如：我们要获取行业数据，我们可以通过parent_id获取，但是parent_id是不确定的，所以我们可以根据编码来获取行业数据
说明：系统中会使用省市区三级联动数据，该数据我们来自“国家统计局”官方数据，地址：http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/2019/index.html

4 根据页面效果分析数据接口

数据字典是树形展示，由于数据众多，我们使用“树形数据与懒加载”的方式展现数据列表，其他就是对数据的新增、修改与删除操作，因此需要提供的接口如下：

1. 根据上级id获取下级数据（构造树形数据），参考文档：https://element.eleme.cn/#/zh-CN/component/table，页面搜索：树形数据与懒加载
2. 导入接口
3. 导出接口

接下来我们封装服务器端数据接口，接口测试通过后再做页面渲染

5 数据字典开发

6 搭建service-cmn模块

6.1 搭建service-cmn模块

搭建过程参考service-hosp模块

1.2 修改配置

修改pom.xml

| <?xml version=”1.0”encoding=”UTF-8”?><project xmlns=”http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd”>
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.atguigu.yygh</groupId>
<artifactId>service</artifactId>
<version>1.0</version>
</parent>

<version>1.0</version>
<artifactId>service-cmn</artifactId>
<packaging>jar</packaging>
<name>service-cmn</name>
<description>service-cmn</description>

<dependencies>
</dependencies>

<build>
<finalName>service-cmn</finalName>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>

</project> | | —- |

1、添加配置文件application.properties

1.3 启动类

7 数据字典列表

根据element组件要求，返回列表数据必须包含hasChildren字典，如图：
https://element.eleme.cn/#/zh-CN/component/table

2.1 数据字典列表接口

2.1.1 model模块添加数据字典实体

在model模块查看实体：com.atguigu.yygh.model.cmn.Dict

| @Data
@ApiModel(description = “数据字典”)@TableName(“dict”)public class Dict extends BaseEntity {

**private static final long _serialVersionUID _**= 1L;

@ApiModelProperty(value = **"上级id"**)<br />    @TableField(**"parent_id"**)<br />    **private **Long **parentId**;

@ApiModelProperty(value = **"名称"**)<br />    @TableField(**"name"**)<br />    **private **String **name**;

@ApiModelProperty(value = **"值"**)<br />    @TableField(**"value"**)<br />    **private **String **value**;

@ApiModelProperty(value = **"编码"**)<br />    @TableField(**"dict_code"**)<br />    **private **String **dictCode**;

@ApiModelProperty(value = **"是否包含子节点"**)<br />    @TableField(exist = **false**)<br />    **private boolean hasChildren**;<br />} |

| —- |

说明：hasChildren为树形组件所需字典，标识为数据库表不存在该字段

2.1.2 添加数据字典mapper

添加com.atguigu.yygh.cmn.mapper.DictMapper

2.1.3 添加数据字典service

1、添加com.atguigu.yygh.cmn.service.DictService

2、添加com.atguigu.yygh.cmn.service.impl.DictServiceImpl接口实现

2.1.4 添加数据字典controller

添加com.atguigu.yygh.cmn.controller.DictController

2.2 数据字典列表前端

2.2.1 添加路由

在 src/router/index.js 文件添加路由

说明：列表与查看都添加了

2.2.2 定义api

创建文件 src/api/cmn/dict.js

2.2.2 方法调用

2.2.3 表格渲染

8 EasyExcel介绍

Java解析、生成Excel比较有名的框架有Apache poi、jxl。但他们都存在一个严重的问题就是非常的耗内存，poi有一套SAX模式的API可以一定程度的解决一些内存溢出的问题，但POI还是有一些缺陷，比如07版Excel解压缩以及解压后存储都是在内存中完成的，内存消耗依然很大。easyexcel重写了poi对07版Excel的解析，能够原本一个3M的excel用POI sax依然需要100M左右内存降低到几M，并且再大的excel不会出现内存溢出，03版依赖POI的sax模式。在上层做了模型转换的封装，让使用者更加简单方便。
EasyExcel是一个基于Java的简单、省内存的读写Excel的开源项目。在尽可能节约内存的情况下支持读写百M的Excel。
文档地址：https://alibaba-easyexcel.github.io/index.html
github地址：https://github.com/alibaba/easyexcel

3.1 导出示例

示例链接：https://alibaba-easyexcel.github.io/quickstart/write.html

3.2 导入示例

示例链接：https://alibaba-easyexcel.github.io/quickstart/read.html

3.3 EasyExcel集成

3.3.1 添加依赖

1，添加依赖

说明：我们已经在yygh-parent中的pom.xml中添加了所有依赖管理

1. 导入导出需要定义对象，对象上需要引用easyexcel标签，所以model模块需要引入，scope：provided | <dependency>
   <groupId>com.alibaba</groupId>
   <artifactId>easyexcel</artifactId>
   <scope>provided </scope>
   </dependency> | | —- |

1. 导入导出我们会把它封装成工具类，放在common-util中，所有模块公用，所以该模块也得引入 | <dependency>
   <groupId>com.alibaba</groupId>
   <artifactId>easyexcel</artifactId>
   </dependency> | | —- |

9 数据字典导出

4.1 导出接口封装

4.1.1 在model模块添加导出实体

在model模块查看实体：com.atguigu.yygh.vo.cmn.DictEeVo

| package com.atguigu.yygh.vo.cmn;_@Datapublic class DictEeVo {
@ExcelProperty(value = “id”,index = 0)private Long id;
@ExcelProperty(value = “上级id”,index = 1)private Long parentId;
@ExcelProperty(value = “名称”,index = 2)private String name;
@ExcelProperty(value = “值”,index = 3)private String value;
@ExcelProperty(value = “编码”,index = 4)private String dictCode;

} | | —- |

4.1.2 在service-cmn模块添加service方法

1、在DictService类添加接口

2、在DictServiceImpl类添加接口实现类

| @Overridepublic void exportData(HttpServletResponse response) {try {
response.setContentType(“application/vnd.ms-excel”);
response.setCharacterEncoding(“utf-8”);// 这里URLEncoder.encode可以防止中文乱码 当然和easyexcel没有关系_String fileName = URLEncoder._encode(“数据字典”, “UTF-8”);
response.setHeader(“Content-disposition”, “attachment;filename=”+ fileName + “.xlsx”);

  List<Dict> dictList = **dictMapper**.selectList(**null**);<br />      List<DictEeVo> dictVoList = **new **ArrayList<>(dictList.size());**for**(Dict dict : dictList) {<br />         DictEeVo dictVo = **new **DictEeVo();<br />         BeanUtils._copyBean_(dict, dictVo, DictEeVo.**class**);<br />         dictVoList.add(dictVo);<br />      }

  EasyExcel._write_(response.getOutputStream(), DictEeVo.**class**).sheet(**"数据字典"**).doWrite(dictVoList);<br />   } **catch **(IOException e) {<br />      e.printStackTrace();<br />   }<br />} |

| —- |

说明：直接复制示例代码中的“web中的写”，改造即可

4.1.3 在service-cmn模块添加controller方法

在DictController类添加方法

4.1.4 测试

直接通过浏览器导出数据：http://localhost:8202/admin/cmn/dict/exportData

4.2 导出前端实现

4.2.1 列表页面添加导出按钮

src/views/cmn/dict/list.vue

4.2.2 添加导出方法

4.2.1 测试

10 数据字典导入

5.1 导入接口封装

5.1.1 创建回调监听器

| public class DictListener extends AnalysisEventListener {

**private **DictMapper **dictMapper**;<br />    **public **DictListener(DictMapper dictMapper) {<br />        **this**.**dictMapper **= dictMapper;<br />    }

_//一行一行读取<br />    _@Override<br />    **public void **invoke(DictEeVo dictEeVo, AnalysisContext analysisContext) {<br />        _//调用方法添加数据库<br />        _Dict dict = **new **Dict();<br />        BeanUtils._copyProperties_(dictEeVo,dict);<br />        **dictMapper**.insert(dict);<br />    }<br />    @Override<br />    **public void **doAfterAllAnalysed(AnalysisContext analysisContext) {

}<br />} |

| —- |

5.1.2 在service-cmn模块添加service方法

5.1.3 在service-cmn模块添加controller方法

在DictController类添加方法

5.2 导入前端实现

5.2.1 列表页面添加导入按钮

src/views/cmn/dict/list.vue

说明：按钮位置与导出并列

5.2.2 添加导入弹出层

| <el-dialog title=”导入”:visible.sync=”dialogImportVisible”width=”480px”>
<el-form label-position=”right”label-width=”170px”>

<el-form-item label=”文件”>
**el-upload:multiple="**false**":on-success="**onUploadSuccess**":action="**'http://localhost:8202/admin/cmn/dict/importData'**"class="upload-demo"**
<el-button size=”small”type=”primary”>点击上传</el-button>
<div slot=”tip”class=”el-upload__tip”>只能上传xls文件，且不超过500kb</div>
</el-upload>
</el-form-item>

</el-form>
<div slot=”footer”class=”dialog-footer”>
<el-button @click=”dialogImportVisible = false“>
取消
</el-button>
</div>
</el-dialog> | | —- |

5.2.3 添加弹出可见模型

5.2.4 添加方法

11 Spring Cache + Redis 缓存数据

Spring Cache 是一个非常优秀的缓存组件。自Spring 3.1起，提供了类似于@Transactional注解事务的注解Cache支持，且提供了Cache抽象，方便切换各种底层Cache（如：redis）
使用Spring Cache的好处：
1，提供基本的Cache抽象，方便切换各种底层Cache；
2，通过注解Cache可以实现类似于事务一样，缓存逻辑透明的应用到我们的业务代码上，且只需要更少的代码就可以完成；
3，提供事务回滚时也自动回滚缓存；
4，支持比较复杂的缓存逻辑；

1、项目集成Spring Cache + Redis

因为缓存也是公共使用，所有的service模块都有可能使用缓存，所以我们把依赖与部分配置加在service-util模块，这样其他service模块都可以使用了

11.1 service-util添加依赖

在service-util模块的pom.xml添加依赖

11.2 service-util添加配置类

创建com.atguigu.yygh.common.config.RedisConfig

| package com.atguigu.yygh.common.config;@Configuration
@EnableCachingpublic class RedisConfig {
/
自定义key规则
_@return*/@Beanpublic KeyGenerator keyGenerator() {return new KeyGenerator() {@Overridepublic Object generate(Object target, Method method, Object… params) {
StringBuilder sb = new StringBuilder();
sb.append(target.getClass().getName());
sb.append(method.getName());for (Object obj : params) {
sb.append(obj.toString());
}return sb.toString();
}
};
}
_/
设置RedisTemplate规则
**@param _redisConnectionFactory* @return*/@Beanpublic RedisTemplate redisTemplate(RedisConnectionFactory redisConnectionFactory) {
RedisTemplate redisTemplate = new RedisTemplate<>();
redisTemplate.setConnectionFactory(redisConnectionFactory);
Jackson2JsonRedisSerializer jackson2JsonRedisSerializer = new Jackson2JsonRedisSerializer(Object.class);
_//解决查询缓存转换异常的问题_ObjectMapper om = new ObjectMapper();_// 指定要序列化的域，field,get和set,以及修饰符范围，ANY是都有包括private和public_om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);_// 指定序列化输入的类型，类必须是非final修饰的，final修饰的类，比如String,Integer等会跑出异常_om.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL);
jackson2JsonRedisSerializer.setObjectMapper(om);
_//序列号key value_redisTemplate.setKeySerializer(new StringRedisSerializer());
redisTemplate.setValueSerializer(jackson2JsonRedisSerializer);
redisTemplate.setHashKeySerializer(new **StringRedisSerializer());
redisTemplate.setHashValueSerializer(jackson2JsonRedisSerializer);

    redisTemplate.afterPropertiesSet();**return **redisTemplate;<br />    }<br />_/**<br />     * 设置CacheManager缓存规则<br />     * _**_@param __factory_**_* _**_@return_**_*/_@Bean**public **CacheManager cacheManager(RedisConnectionFactory factory) {<br />        RedisSerializer<String> redisSerializer = **new **StringRedisSerializer();<br />        Jackson2JsonRedisSerializer jackson2JsonRedisSerializer = **new **Jackson2JsonRedisSerializer(Object.**class**);<br />_//解决查询缓存转换异常的问题_ObjectMapper om = **new **ObjectMapper();<br />        om.setVisibility(PropertyAccessor.**_ALL_**, JsonAutoDetect.Visibility.**_ANY_**);<br />        om.enableDefaultTyping(ObjectMapper.DefaultTyping.**_NON_FINAL_**);<br />        jackson2JsonRedisSerializer.setObjectMapper(om);<br />_// 配置序列化（解决乱码的问题）,过期时间600秒_RedisCacheConfiguration config = RedisCacheConfiguration._defaultCacheConfig_()<br />                .entryTtl(Duration._ofSeconds_(600))<br />                .serializeKeysWith(RedisSerializationContext.SerializationPair._fromSerializer_(redisSerializer))<br />                .serializeValuesWith(RedisSerializationContext.SerializationPair._fromSerializer_(jackson2JsonRedisSerializer))<br />                .disableCachingNullValues();

    RedisCacheManager cacheManager = RedisCacheManager._builder_(factory)<br />                .cacheDefaults(config)<br />                .build();**return **cacheManager;<br />    }<br />} |

| —- |

说明：
@EnableCaching：标记注解 @EnableCaching，开启缓存，并配置Redis缓存管理器。@EnableCaching 注释触发后置处理器, 检查每一个Spring bean 的 public 方法是否存在缓存注解。如果找到这样的一个注释, 自动创建一个代理拦截方法调用和处理相应的缓存行为。

11.3 service-cmn添加redis配置

12 使用Spring Cache

2.1 常用缓存标签

2.1.2 缓存@Cacheable

根据方法对其返回结果进行缓存，下次请求时，如果缓存存在，则直接读取缓存数据返回；如果缓存不存在，则执行方法，并把返回的结果存入缓存中。一般用在查询方法上。
查看源码，属性值如下：

2.1.2 缓存@CachePut

使用该注解标志的方法，每次都会执行，并将结果存入指定的缓存中。其他方法可以直接从响应的缓存中读取缓存数据，而不需要再去查询数据库。一般用在新增方法上。
查看源码，属性值如下：

2.1.3 缓存@CacheEvict

使用该注解标志的方法，会清空指定的缓存。一般用在更新或者删除方法上
查看源码，属性值如下：

2.2 数据字典应用

改造com.atguigu.yygh.cmn.service.impl.DictServiceImpl类方法