EasyPDI是对 Apche POI库的封装，可以通过一些简单的操作就可以进行Excel文件的导入导出，这这个库中还封装了一些独特的功能：
- 基于注解的导入导出,修改注解就可以修改Excel
- 支持常用的样式自定义
- 基于map可以灵活定义的表头字段
- 支持一堆多的导出,导入
- 支持模板的导出,一些常见的标签,自定义标签
- 支持HTML/Excel转换,如果模板还不能满足用户的变态需求,请用这个功能
- 支持word的导出,支持图片,Excel
一直以来，使用EasyPOI做了不少导入导出的需求，但是每次做完都是临时去看官方文档现学现用，正巧最近朋友遇到这么个需求，用到了EasyPOI来完成导入，我也正好整理整理EasyPOI的导入用法。
SpringBoot封装了对EasyPOI的starter，可以直接引用，也可以单独引入
单独引入：
EasyPOI是通过注解来表明需要导入导出的类、字段，一个实体类代表的是表格里的一行，实体类里面的字段代表着一行里面的一列。现在注解一共有5个，分别是：
- @Excel 作用到类字段上面,是对Excel一列的一个描述
- @ExcelCollection 表示一个集合,主要针对一对多的导出,比如一个老师对应多个科目,科目就可以用集合表示
- @ExcelEntity 表示一个继续深入导出的实体,但他没有太多的实际意义,只是告诉系统这个对象里面同样有导出的字段
- @ExcelIgnore 和名字一样表示这个字段被忽略跳过这个导导出
- @ExcelTarget 这个是作用于最外层的对象,描述这个对象的id,以便支持一个对象可以针对不同导出做出不同处理
船艇导出实体类
Excel注解
以上示例中类字段使用了Excel注解来标注，来表示在导出该对象时显示的字段名以及所属单元格的格式，该注解有许多的值可以设置，如下表：
ExcelCollcetions注解
该注解是表明该字段是一个集合，会让多条数据以对象的一个字段来显示（多条数据也就意味着多行数据）
ExcelEntity注解
标记是不是导出excel 标记为实体类,一遍是一个内部属性类,标记是否继续穿透,可以自定义内部id
沿用船艇实体类，在服务类代码中完成表格的导出；
在EasyPOI中分别针对导入和导出定义了工具类，分别是 和 2个类，针对这2个类可以进行导入导出操作。
数据导出成Excel表格需要完成几个步骤：
- 准备好数据源
- 设置好导出Excel的文件格式以及sheet名
- 返回输出流
数据源从数据库中获取，将获取到的数据转化成被Excel注解标注的类，数据源就准备好了；然后通过 提供的方法来构建 对象，最后将文件流写入到response中即可。
使用示例：
根据以上的步骤，数据导出成Excel文件也就完成了。
导出效果：
需要注意的是，如果导出对象中存在一对多的情况，也就是有字段是集合类型的，那么该类其他字段的Excel注解需要加上一个值， = true，如果不设置的话，同一个对象的字段就不会纵向合并。
表格的数据导入与数据导出的步骤是一样的，通过工具类来实现数据导入。但是要注意的是文件表格的列名格式要和代码中被注解标注类的字段要保持一致，字段不一致的就不会解析成对象。
导入文件需要进行以下这几个步骤：
- 新建 ImportParams 对象，用于设置导入文件时的一些信息
- 获取文件，读取该文件
- 最终获得结果List
下面是示例：
数据导入时的数据校验
在数据导入时，会进行字段的校验，如果校验不通过则解析失败并且提示返回错误的行数以及消息。EasyPOI已经提供了这个功能选项， EasyPOI 支持 ，所以直接使用就可以了，因为要将错误信息以及错误行号返回，需要用到 EasyPOI 的高级用法，实现 与 接口，负责设置行号， 负责设置错误信息。
实现数据导入的数据校验要进行以下步骤：
- 新建的ImportParms对象需要开启校验功能
- 实体类加入 注解，开启校验功能
- 导入的解析类对象需要实现 和 接口
- 数据校验
- 返回校验结果以及错误提示
在上面的导入数据示例中，新建了一个对象，如果需要开启校验功能，需要多加一行代码：
开启校验功能后，在实体类中需要实现 和 接口，重写接口方法
如果使用到了 @Pattern 注解，则字段类型必须是 String 类型，否则会抛出异常
如果开启数据校验，那么数据导入的方式也将改变，原本是调用 类的 方法实现导入，现在需要切换到另外一个方法来实现导入，通过 方法导入，该方法所需参数与未开启校验导入是一致的，这两者的区别是返回值。
该方法的返回值是 类型的，代码如下：
进行校验之后，会将校验成功的结果放入 字段中，校验失败的放入 字段中，并且设置 值；
校验过程中，如果校验失败，那么就会将失败所在的行以及错误信息写入到该对象的 字段和 字段中，这2个字段是实现了接口而拥有的。
示例代码：
以上就是校验的代码情况，但是这部分只能进行基本部分的校验，但是对ExcelCollection标注集合里的对象却校验不了。
对Excel集合里的对象进行校验
EasyPOI对被ExcelColleciton注解所标注的集合对象校验不了，那么我们就可以自己手动开始校验，使用 框架的校验功能进行手动校验。这里需要封装工具类，示例代码如下：
以上工具类方法会返回一个Set集合，该集合存放这 对象，该对象可以根据方法 来获取校验失败的字段，根据 方法获取错误信息。
示例代码：
根据以上代码之后就可以校验集合对象的数据，可以满足导入导出的Excel表格需求。
版权声明：
本文来源网络，所有图片文章版权属于原作者，如有侵权，联系删除。
本文网址：https://www.bianchenghao6.com/java-jiao-cheng/6736.html