Excel导出模板自动生成规则,避免用户反复修改

一句话总结

Excel 导出、导入时,根据注解自动添加单元格验证规则,避免用户因填写错误的枚举字段而反复修改 Excel

需求背景

对于 Java Web 项目,总是不可避免的出现 Excel 导入、导出的需求,而 Excel 导入导出时,枚举字段和枚举值的映射是非常常见的一种情况

例如:下面这张示例中的性别列

数据库表结构:

e701c351c0820fa945c1f82b9d978b2a.png

Excel 中用户需要输入:男,女,未知

beaf3816cc2c8bae41529951ed90c58d.png

常见的 Excel 框架都已经覆盖了枚举映射的功能,例如:EasyPOI

但是这种操作方式对于用户来说,并不是很方便,试想一下:假如用户在性别列输入了:男性,最终的结果一般就是程序抛出异常,用户得到提示:性别输入有误,贴心的开发者可能会加上:请输入 男 女 未知,做的更好一些的 可能在列头添加标签提示:该列仅能输入 男 女 未知,但是这种弱限制也无法从根本上解决问题

9de62d26fa0b00850905b02f7f4d060b.png

更好一点的解决方案是:利用 Excel 的数据验证功能,把单元格加上规则校验,让用户只能输入正确的枚举值,避免因一次输入错误而反复返工,浪费用户的时间和好心情

e4f21f0e2dd4b4c1254cf3ac1a0cc3fd.png

当用户输入了非枚举值之后,Excel 会提示用户输入不合规,禁止用户保存

a90b2da82080c7b646a48b759b05f845.png

这样的交互就能从源头保证用户输入正确的值

那这么友好的设计,在 Java 中如何能方便且可扩展性更强的实现呢?

需求实现

我这边的实现是基于 EasyPOI + 注解(EasyPOI 转换映射关系注解复用) + 反射 实现的,解决了以上需求痛点的同时,可以满足代码一处修改,多个功能都生效的目的

代码仓库

https://github.com/keatsCoder/excel

实体类

@Excel 注解中的 replace 属性,该属性是 EasyPOI 用来做字段映射的,我这里复用他做 Excel 验证的可选项,另外一个就是 orderNum 属性,用该值来自动获取某个字段在 Excel 中的列的位置

@Data

public class Human extends BaseEnt

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值