【JAVA开发笔记】实战演练，如何用EasyExcel导出表格，并且自定义合并单元格

1. 前言

2. EasyExcel简介

3. EasyExcel简单导出案例讲解

3.1 EasyExcel依赖引入

3.2 测试类创建

3.3 Excel导出实现

4. EasyExcel合并单元案例讲解

4.1 实现自定义合并策略

4.2 使用自定义合并策略

5. 总结

1. 前言

项目上，需将一个列表数据导出Excel表格，并将指定列相同数据自动合并单元格，琢磨学习了下easyexcel实现效果如下：

如上图所示，指定A、B两列相同行自动合并。

2. EasyExcel简介

EasyExcel是一个基于Java的、快速、简洁、解决大文件内存溢出的Excel处理工具。他能让你在不用考虑性能、内存的等因素的情况下，快速完成Excel的读、写等功能。
EasyExcel相比其他Excel解析框架（Apache poi和jxl），拥有更好的内存消耗管理算法。特别是对07版Excel的解决，EasyExcel重写了底层解析逻辑，一个3M的Excel解析只需要几M内存，但是用poi解析可能需要100M左右的内存。EasyExcel提高了读取性能，64M内存20秒读取75M的Excel，还有更快的极速模式，但是消耗的内存会更多一些。
EasyExcel支持自定义策略合并单元格，可以方便快捷填充数据到模板中，有活跃的中文社区支持，完善的测试用例可以覆盖大部分业务场景的使用。

3. EasyExcel简单导出案例讲解

本章节实现效果如下：

3.1 EasyExcel依赖引入

注意文中还需引入Lombok注解

        <dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></dependency><dependency><groupId>com.alibaba</groupId><artifactId>easyexcel</artifactId><version>3.2.1</version></dependency>

3.2 测试类创建

@ContentRowHeight(50) //内容行高

@HeadRowHeight(15) //表头行高

@ColumnWidth(20) //列宽度

@ContentStyle(horizontalAlignment = HorizontalAlignmentEnum.CENTER, verticalAlignment = VerticalAlignmentEnum.CENTER) // 内容样式，本处设置是水平和垂直居中

@ExcelProperty("国家/地区") //表头信息

import com.alibaba.excel.annotation.ExcelProperty;
import com.alibaba.excel.annotation.write.style.ColumnWidth;
import com.alibaba.excel.annotation.write.style.ContentRowHeight;
import com.alibaba.excel.annotation.write.style.ContentStyle;
import com.alibaba.excel.annotation.write.style.HeadRowHeight;
import com.alibaba.excel.enums.poi.HorizontalAlignmentEnum;
import com.alibaba.excel.enums.poi.VerticalAlignmentEnum;
import lombok.Builder;
import lombok.EqualsAndHashCode;
import lombok.Getter;
import lombok.Setter;/*** @Author: lxy* @CreateTime: 2024-06-11* @Description: 测试类*/
@Getter
@Setter
@Builder
@EqualsAndHashCode
@HeadRowHeight(50) // 表头行高
@ContentRowHeight(15) // 内容行高
@ColumnWidth(20) // 列宽度
public class TestEntity {@ContentStyle(horizontalAlignment = HorizontalAlignmentEnum.CENTER, verticalAlignment = VerticalAlignmentEnum.CENTER) // 内容样式@ExcelProperty("国家/地区")private String row1;@ContentStyle(horizontalAlignment = HorizontalAlignmentEnum.CENTER, verticalAlignment = VerticalAlignmentEnum.CENTER) // 内容样式@ExcelProperty("省份/州/自治区/特别行政区")private String row2;@ContentStyle(horizontalAlignment = HorizontalAlignmentEnum.CENTER, verticalAlignment = VerticalAlignmentEnum.CENTER) // 内容样式@ExcelProperty("城市/县/市辖区")private String row3;
}

3.3 Excel导出实现

使用EasyExcel导出简单Excel代码示例如下：

    @Testpublic void simplyWriteExcel() {// 数据就初始化List<TestEntity> resultList = new ArrayList<>();resultList.add(TestEntity.builder().row1("中国").row2("广东省").row3("深圳市").build());resultList.add(TestEntity.builder().row1("中国").row2("广东省").row3("广州市").build());resultList.add(TestEntity.builder().row1("中国").row2("新疆维吾尔自治区").row3("乌鲁木齐市").build());resultList.add(TestEntity.builder().row1("中国").row2("新疆维吾尔自治区").row3("喀什地区").build());resultList.add(TestEntity.builder().row1("中国").row2("香港特别行政区").row3("香港岛").build());resultList.add(TestEntity.builder().row1("中国").row2("香港特别行政区").row3("九龙半岛").build());resultList.add(TestEntity.builder().row1("美国").row2("加利福尼亚州").row3("洛杉矶市").build());resultList.add(TestEntity.builder().row1("美国").row2("加利福尼亚州").row3("旧金山县").build());resultList.add(TestEntity.builder().row1("美国").row2("德克萨斯州").row3("休斯敦市").build());resultList.add(TestEntity.builder().row1("美国").row2("德克萨斯州").row3("达拉斯县").build());resultList.add(TestEntity.builder().row1("美国").row2("纽约州").row3("纽约市").build());resultList.add(TestEntity.builder().row1("美国").row2("纽约州").row3("布法罗县").build());// 设置文件名称String fileName = "C:\\Users\\Lixy\\Desktop\\test01.xlsx";// 1、指定写出文件名称以及用哪个class去写// 2、设置文件流自动关闭// 3、输出写出Excel的sheet名称（自定义）// 4、指定写出的数据EasyExcel.write(fileName, TestEntity.class).autoCloseStream(Boolean.TRUE).sheet("Sheet1").doWrite(resultList);}

4. EasyExcel合并单元案例讲解

注：EasyExcel依赖和测试类，与章节3保持一致，本章节不再做讲解

本章节实现效果如下：

4.1 实现自定义合并策略

CellWriteHandler 是 EasyExcel 中的一个接口，它允许开发者在写入单元格时执行自定义逻辑，如设置单元格样式、合并单元格等。

下面是一个的 CellWriteHandler 示例，实现了如何判断上下行数据相同，并对数据进行合并单元格：

import com.alibaba.excel.metadata.Head;
import com.alibaba.excel.metadata.data.WriteCellData;
import com.alibaba.excel.write.handler.CellWriteHandler;
import com.alibaba.excel.write.metadata.holder.WriteSheetHolder;
import com.alibaba.excel.write.metadata.holder.WriteTableHolder;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.CellType;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.ss.usermodel.Sheet;
import org.apache.poi.ss.util.CellRangeAddress;import java.util.List;/*** @Author: lxy* @CreateTime: 2024-06-12* @Description: EasyExcel单元格合并处理器*/
public class ExcelMergeHandler implements CellWriteHandler {private int[] mergeColumnIndex;private int mergeRowIndex;public ExcelMergeHandler() {}/*** 构造函数** @param mergeRowIndex     合并开始的行索引* @param mergeColumnIndex  要合并的列索引数组*/public ExcelMergeHandler(int mergeRowIndex, int[] mergeColumnIndex) {this.mergeRowIndex = mergeRowIndex;this.mergeColumnIndex = mergeColumnIndex;}@Overridepublic void afterCellDispose(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, List<WriteCellData<?>> cellDataList, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) {// 当前行索引int curRowIndex = cell.getRowIndex();// 当前列索引int curColIndex = cell.getColumnIndex();// 如果当前行大于合并开始行if (curRowIndex > mergeRowIndex) {// 当前列在需要合并的列中for (int columnIndex : mergeColumnIndex) {if (curColIndex == columnIndex) {// 进行合并操作mergeWithPrevRow(writeSheetHolder, cell, curRowIndex, curColIndex);break;}}}}/*** 当前单元格向上合并** @param writeSheetHolder 当前工作表持有者* @param cell             当前单元格* @param curRowIndex      当前行索引* @param curColIndex      当前列索引*/private void mergeWithPrevRow(WriteSheetHolder writeSheetHolder, Cell cell, int curRowIndex, int curColIndex) {// 获取当前行的当前列的数据和上一行的当前列列数据，通过上一行数据是否相同进行合并Object curData = cell.getCellTypeEnum() == CellType.STRING ? cell.getStringCellValue() : cell.getNumericCellValue();// 获取前一个单元格的数据Cell preCell = cell.getSheet().getRow(curRowIndex - 1).getCell(curColIndex);Object preData = preCell.getCellTypeEnum() == CellType.STRING ? preCell.getStringCellValue() : preCell.getNumericCellValue();// 判断当前单元格和前一个单元格的数据以及主键是否相同if (curData.equals(preData)) {// 获取工作表Sheet sheet = writeSheetHolder.getSheet();// 获取已合并的区域List<CellRangeAddress> mergeRegions = sheet.getMergedRegions();boolean isMerged = false;// 检查前一个单元格是否已经被合并for (int i = 0; i < mergeRegions.size() && !isMerged; i++) {CellRangeAddress cellRangeAddr = mergeRegions.get(i);// 若上一个单元格已经被合并，则先移出原有的合并单元，再重新添加合并单元if (cellRangeAddr.isInRange(curRowIndex - 1, curColIndex)) {sheet.removeMergedRegion(i);cellRangeAddr.setLastRow(curRowIndex);sheet.addMergedRegion(cellRangeAddr);isMerged = true;}}// 如果前一个单元格未被合并，则新增合并区域if (!isMerged) {CellRangeAddress cellRangeAddress = new CellRangeAddress(curRowIndex - 1, curRowIndex, curColIndex, curColIndex);sheet.addMergedRegion(cellRangeAddress);}}}@Overridepublic void beforeCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Row row, Head head, Integer integer, Integer integer1, Boolean aBoolean) {}@Overridepublic void afterCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Cell cell, Head head, Integer integer, Boolean aBoolean) {}
}

4.2 使用自定义合并策略

要使用 CellWriteHandler，通常需要实现其定义的方法，并在创建 ExcelWriter 时通过 registerWriteHandler 方法将其注册到 EasyExcel 的上下文中，这样，当 EasyExcel 写入单元格时，就会调用这些自定义的处理器方法。

在创建 ExcelWriter 并写入数据时，可以如下注册这个处理器：

    @Testpublic void writeExcel() {// 需要合并的列int[] mergeColumnIndex = {0,1};// 需要从第几行开始合并int mergeRowIndex = 1;// 数据就初始化List<TestEntity> resultList = new ArrayList<>();resultList.add(TestEntity.builder().row1("中国").row2("广东省").row3("深圳市").build());resultList.add(TestEntity.builder().row1("中国").row2("广东省").row3("广州市").build());resultList.add(TestEntity.builder().row1("中国").row2("新疆维吾尔自治区").row3("乌鲁木齐市").build());resultList.add(TestEntity.builder().row1("中国").row2("新疆维吾尔自治区").row3("喀什地区").build());resultList.add(TestEntity.builder().row1("中国").row2("香港特别行政区").row3("香港岛").build());resultList.add(TestEntity.builder().row1("中国").row2("香港特别行政区").row3("九龙半岛").build());resultList.add(TestEntity.builder().row1("美国").row2("加利福尼亚州").row3("洛杉矶市").build());resultList.add(TestEntity.builder().row1("美国").row2("加利福尼亚州").row3("旧金山县").build());resultList.add(TestEntity.builder().row1("美国").row2("德克萨斯州").row3("休斯敦市").build());resultList.add(TestEntity.builder().row1("美国").row2("德克萨斯州").row3("达拉斯县").build());resultList.add(TestEntity.builder().row1("美国").row2("纽约州").row3("纽约市").build());resultList.add(TestEntity.builder().row1("美国").row2("纽约州").row3("布法罗县").build());// 设置文件名称String fileName = "C:\\Users\\Lixy\\Desktop\\test02.xlsx";// 1、指定写出文件名称以及用哪个class去写// 2、设置文件流自动关闭// 3、设置自定义的写入处理逻辑，注册ExcelMergeHandler示例// 4、输出写出Excel的sheet名称（自定义）// 5、指定写出的数据EasyExcel.write(fileName, TestEntity.class).autoCloseStream(Boolean.TRUE).registerWriteHandler(new ExcelMergeHandler(mergeRowIndex, mergeColumnIndex)).sheet("Sheet1").doWrite(resultList);}