关注程序员7歌，一起用技术改变世界

在我们实际开发中经常会遇到Excel的导入与导出功能，而目前Excel操作工具也是数不甚数啊，但是7歌用过很多，还是觉得最近发现的tool-excel好用，让你实现一语句代码就能完成Excel功能。

首先我们提供安装依赖：

cn.gjingtools-excel1.1.0

我们先来了解一下tool-excel的注解：

1、@Excel

该注解是使用在类上，表明此类是用来绑定excel的，参数如下：

value：说明excel的文件名，优先级低于方法传入的文件名

type：说明excel的文档类型，默认为XLS

style：说明导出excel的样式

2、@ExcelField

该注解是使用在字段上，表明这是Excel的列表头，参数如下：

value：说明列表头名

pattern：说明时间的转换格式(时间才需要指定)

width：说明列表头的宽度

3、@DateValid

该注解是使用在时间字段的时间校验，表明我这个列表头下指定行数的单元格要进行数据校验，XLSX类型文档不支持，参数如下：

validClass：校验器

ClassboxLastRow：数据校验最多校验多少行，默认是正文第一行

pattern：校验的时间格式，默认yyyy-MM-dd

operatorType：操作类型，默认OperatorType.BETWEEN

expr1：表达式1，默认1970-01-01

expr2：表达式2，默认2999-01-01

showErrorBox：是否弹出错误框，默认true

showPromptBox：是否立即弹出，默认true

allowEmpty：是否允许空值，默认true

rank：提示框级别，默认Rank.WARING警告级别

errorTitle：错误框标题

errorContent：详细错误内容

4、@ExplicitValid

该注解是用来明确范围内容校验的，参数如下：

alidClass：校验器

Classcombobox：范围值，数组类型

boxLastRow：数据校验最多校验多少行，默认是该列表头下的正文第一行

showErrorBox：是否弹出错误框，默认true

rank：提示框级别，默认Rank.WARING警告级别

showPromptBox：是否立即弹出，默认true

errorTitle：错误框标题

errorContent：详细错误内容

5、@NumericValid

该注解用于数据类型的校验，使用在Excel字段上，参数如下：

validClass：校验器

ClassboxLastRow：数据校验最多校验多少行，默认是该列表头下的正文第一行

operatorType：操作类型，默认OperatorType.EQUAL

validationType：校验类型，必填

expr1：表达式1，在表达式2前面，必填

expr2：表达式2，在操作类型为BETWEEN和NOT_BETWEEN情况下必填

showErrorBox：是否弹出错误框，默认true

showPromptBox：是否立即弹出，默认true

allowEmpty：是否允许空值，默认true

rank：提示框级别，默认Rank.WARING警告级别

errorTitle：错误框标题

errorContent：详细错误内容

6、@ExcelEnumConvert

该注解是用于枚举转换，使用在枚举的Excel字段上，参数如下：

convert：实现了EnumConvert接口的类Class

那么我们来看一下tool-excel的具体使用方法：

1、Excel操作实体类：

@Excel(value = "教师评价信息",type = Type.XLS)public class TeacherEvalExcel implements Serializable {private static final long serialVersionUID = -6458620790191821524L;/*** 教师姓名*/@ExcelField("教师姓名")private String teacherName;/*** 当前任教年级*/@ExcelField("当前任教年级")private String gradeNames;/*** 任教科目*/@ExcelField("任教科目")private String courseNames;/*** 评价指标*/@ExcelField("评价指标")private String evalName;/*** 评价项目*/@ExcelField("评价项目")private String evalItemName;/*** 所属学年学期*/@ExcelField("所属学年学期")private String semesterName;/*** 录入时间*/@ExcelField("录入时间")private String inputTime;}

从上面的实体看出，我们加入了@Excel，@ExcelField就可以啦。

2、使用tool-excel实现excel导出功能

/*** 导出教师评价信息* @param pageParamVo* @return* @author zqk*/@PostMapping("/exportExcel")public void exportExcel(@RequestBody PageParamVo pageParamVo){ServletRequestAttributes servletRequestAttributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();HttpServletResponse response = servletRequestAttributes.getResponse();PageVo pager = pageParamVo.getPager();pager.setPageSize(-1L);List teacherEvalExcels = teacherEvalService.exportExcelData(new Page<>(pager.getCurrent(), pager.getSize()),pageParamVo.getContent());ExcelFactory.createWriter("教师评价息", TeacherEvalExcel.class, response, teacherEvalExcels).write();}

从上面的代码可以看出，我们实现excel导出就使用了一句代码：

ExcelFactory.createWriter("教师评价息", TeacherEvalExcel.class, response, teacherEvalExcels).write();

如果我们需要导出excel模版，那么我们在wirite()方法里面传入null即可。

3、使用tool-excel实现excel导入功能

/*** 导入教师评价信息* @param file* @return* @throws IOException* @author zqk*/@PostMapping("/importExcel")public Result importExcel(MultipartFile file) throws IOException {List users = ExcelFactory.createReader(file.getInputStream(), TeacherEval.class).read();teacherEvalService.saveTeacherEval(users);return Result.ok("导入成功");}

以上就是使用tool-excel操作excel的方法，接下来我么看看其他注解使用；

4、数据校验的使用：

在导出模板时，我们可以对用户填写的内容进行数据格式校验，如下：

/*** 对数据的前十行进行校验，必须输入大于3的数字*/@ExcelField("用户名")@NumericValid(validationType = ValidType.TEXT_LENGTH, expr1 = "3", operatorType = OperatorType.GREATER_OR_EQUAL,boxLastRow = 10)private String userName;@ExcelField(value = "创建时间",pattern = "yyyy-MM-dd")/*** 时间只能输入在2019-10-11至2019-10-30范围的时间*/@DateValid(expr1 = "2019-10-12",expr2 = "2019-10-30")private Date createTime;

好了，以上就是使用工具导出Excel数据信息，今天就给大家介绍到这里吧，大家有什么不懂

的可以私信我～～❤️❤️