EasyExcel 基础用法

1.使用注解导出基础格式数据

     1.1 创建数据格式基础描述类

@Data
@AllArgsConstructor
public class ExcelData{@ExcelProperty(value="第一列", index = 0)private String col1;@ExcelProperty(value="第二列", index = 1)private String col2;@ExcelProperty(value="第三列", index = 2)private String col3;@ExcelProperty(value="第四列", index = 3)private String col4;}

       常用基础注解： 

       @ExcelProperty  注解 ， value 设置标题 ，index 设置标题排序 ，位置从 0 开始

       @ContentStyle 注解，horizontalAlignment 设置风格

       @ColumnWidth 注解，设置单元格的宽度

     1.2 导出数据

        EasyExcel.write(文件路径 / 数据流(比如：response.getOutputStream()，new FileOutputStream() )).head(ExcelData.class).sheet("sheet1").doWrite(excelDataList )；

        write() 方法设置数据目标数据流 ，

        head() 方法设置标题

        sheet() 方法设置 sheet 数据页的名字

        doWrite 方法将数据写到数据流中

      1.3 导出数据示例

        ExcelData excelDate = new ExcelData(1,2,3,4);

2. 单元行合并设置

     单元格合并可以继承 AbstractRowWriteHandler 类或者实现 CellWriteHandler 类，重写两个类中的 afterRowDispose/afterCellDataWrite方法，两个方法的核心点如下：

1. 生成 CellRangeAddress 对象，该对象用于描述单元格合并方式，如

    new CellRangeAddress(1, 3, 1, 1) ，描述纵向合并单元格 ，合并 1~3 三行

    new CellRangeAddress(1, 1, 1, 3) ，描述横向合并单元格 ，合并 1~3 三列

2. 需要将生成的 CellRangeAddress 添加，如下

   writeSheetHolder.getSheet().addMergedRegionUnsafe(cellRangeAddress);

 （writeSheetHolder : 该对象是 afterRowDispose/afterCellDataWrite 方法入参，不需要关心）

   注意：重写方法后还不能实现单元格合并，需要将处理类注入，如下：

      EasyExcel.write(fileName, CityExportDTO.class) .registerWriteHandler( 你的单元格数据处理类(new YourObject())  ).sheet("Sheet1").doWrite(dataList);

3. 单excel 文件多 sheet 页数据写入

    1. 创建一个 ExcelWriter 对象  ExcelWriter writer =  EasyExcel.write(文件路径 / 数据流).build();

该代码可以理解为创建了一个 excel 文档

    2. 创建一个 WriteSheet  对象（如下），该代码可以理解为创建了一个 sheet 页（如果是多个sheet 页，多写几次创建sheet 页代码或者循环创建）

WriteSheet sheet = EasyExcel.writerSheet(index,sheetName).head().build();

    3. 将第二步中的sheet 页写入到第一步的 excel 文档中，使用 writer.write(dataList(要写入的数据), sheet (sheet 页对象) ); (多个 sheet 页多写几次代码)

    4. 将数据从内存刷入到文件中，writer.finish()

     如果写入多个 sheet 页到同一个文档中或者将数据分页都可以使用该方法，writer.finish() 方法千万不能漏掉

4. 自定义 excel 数据读取类型转换器

     实现 Converter 类重写 ConvertToJavaData 方法，如：我需要自定义String类型日期转换为 LocalDateTime 类型

import com.alibaba.excel.converters.Converter;
import com.alibaba.excel.enums.CellDataTypeEnum;
import com.alibaba.excel.metadata.GlobalConfiguration;
import com.alibaba.excel.metadata.data.ReadCellData;
import com.alibaba.excel.metadata.data.WriteCellData;
import com.alibaba.excel.metadata.property.ExcelContentProperty;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;/*** EasyExcel自定义转换器：将String类型转换为LocalDateTime类型*/
public class StringToLocalDateTimeConverter implements Converter<LocalDateTime> {// 支持的日期格式，可根据实际需求扩展private static final FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");/*** 从Excel读取数据时，将String转换为LocalDateTime*/@Overridepublic LocalDateTime convertToJavaData(ReadCellData<?> cellData, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) {String dateStr = cellData.getStringValue();if (dateStr == null || dateStr.trim().isEmpty()) {return null;}return LocalDateTime.parse(dateStr, FORMATTER);}}

    自定义类写好后需要在字段注解中注入该转换类，如下：

    @ExcelProperty(value = "创建时间", converter = StringToLocalDateTimeConverter.class)
private LocalDateTime createTime;