当前位置：首页 > news >正文

EasyExcel 基础用法

news 2025/9/6 6:50:35

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;