1.常用类
EasyExcel 入口类,用于构建各种对象,开始各种操作
ExcelReaderBuilder 构建出一个ReadWorkbook对象,即一个工作簿对象,对应的是一个Excel文件
ExcelWriterBuilder 构建出一个 WriteWorkbook对象,即一个工作簿对象,对应的是一个Excel文件
ExcelReaderSheetBuilder 构建出一个ReadSheet对象,即一个工作表对象,对应的Excel文件中的每个sheet,一个工作簿可以 有多个工作表
ExcelWriterSheetBuilder 构建出一个WriteSheet对象,即一个工作表对象,对应的Excel文件中的每个sheet,一个工作簿可以 有多个工作表
ReadListener 在每一行读取完毕之后都会调用ReadListener来处理数据,我们可以把调用service的代码可以写在invoke方法的内部
WriteHandler 在每一个操作包括创建单元格,创建表格等都会调用writeHandler来处理数据,对使用者透明不可见
所有配置都是继承的 workbook的配置会被sheet继承,所以在使用EasyExcel设置参数的时候,在EasyExcel…sheet()方法之前作用域都是整个workBook的所有sheet,之后针对单个sheet
2.常用注解
@ExcelProperty
作用在成员变量上,把实体类中属性和excel 表中列关联起来
属性:
属性名 | 含义 |
---|---|
index | 对应excel表中的列数 |
value | 对应excel表中的列头 |
converter | 成员变量转换器 |
效果:index属性可以指定当前字段对应excel中的哪一列,可以根据列名value去匹配,也可以不写。如果不使用该注解,成员变量从上到下的顺序,对应表格中从左到右的顺序。
要么全部不写,要么全部使用index,要么用value去匹配,不要混着使用
@ExcelIgnore
标注在成员变量上,默认所有字段都会和excel进行匹配,除了被该注解注释的字段
@DateTimeFormat
标注在成员变量上,日期转换,代码中用String类型的成员变量去接受excel中日期格式的数据会调用这个注解,
3.通用参数
ReadWorkbook,ReadSheet 都会有的参数,如果为空,默认使用上级。
● converter 转换器,默认加载了很多转换器。也可以自定义。
● readListener 监听器,在读取数据的过程中会不断的调用监听器。
● headRowNumber 需要读的表格有几行头数据。默认有一行头,也就是认为第二行开始起为数据。
● head 与clazz二选一。读取文件头对应的列表,会根据列表匹配数据,建议使用class。
● clazz 与head二选一。读取文件的头对应的class,也可以使用注解。如果两个都不指定,则会读取全部数据。
● autoTrim 字符串、表头等数据自动trim
● password 读的时候是否需要使用密码