就是高效，EasyExcel这样写合并单元格

在Java开发领域，Excel文件的处理一直是高频需求，无论是数据导出、报表生成还是数据分析，Excel都扮演着至关重要的角色。然而，传统的Apache POI等库在处理大规模数据或复杂格式时，往往面临性能瓶颈和代码复杂度高的挑战。EasyExcel作为阿里巴巴开源的Excel处理工具，以其高效、简洁、易用的特点，迅速成为开发者处理Excel的首选方案。本文将深入探讨如何使用EasyExcel高效实现合并单元格功能，帮助开发者快速掌握这一关键技能。

一、EasyExcel简介与优势

EasyExcel基于Apache POI进行二次封装，但去除了POI中冗余的API，简化了Excel操作流程。其核心优势在于：

1. 内存优化：EasyExcel采用SAX模式读取Excel，避免了POI的DOM模式导致的内存溢出问题，尤其适合处理大规模数据。
2. 读写高效：通过流式处理，EasyExcel在读写Excel时速度更快，资源消耗更低。
3. API简洁：提供了更简洁的API接口，降低了学习成本，提高了开发效率。

二、合并单元格的必要性

合并单元格是Excel中常见的格式需求，尤其在生成报表或数据汇总时，合并同类项单元格可以显著提升报表的可读性和美观度。例如，在销售报表中，将同一产品的销售数据合并显示，可以直观地展示各产品的销售情况。

三、EasyExcel实现合并单元格的步骤

1. 引入EasyExcel依赖

首先，需要在项目中引入EasyExcel的依赖。以Maven项目为例，在pom.xml中添加以下依赖：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>最新版本号</version>
</dependency>

2. 定义数据模型

创建一个Java类作为Excel的数据模型，例如：

public class SalesData {
    @ExcelProperty("产品名称")
    private String productName;
    @ExcelProperty("销售数量")
    private Integer salesQuantity;
    // 其他字段...
}

3. 实现合并策略

EasyExcel通过实现CellWriteHandler接口来自定义单元格的合并逻辑。以下是一个简单的合并策略示例：

public class CustomMergeStrategy implements CellWriteHandler {
    private int mergeRowIndex;
    private int mergeColIndex;
    private int sheetIndex;
    public CustomMergeStrategy(int mergeRowIndex, int mergeColIndex, int sheetIndex) {
        this.mergeRowIndex = mergeRowIndex;
        this.mergeColIndex = mergeColIndex;
        this.sheetIndex = sheetIndex;
    }
    @Override
    public void beforeCellCreate(WriteSheet writeSheet, WriteTable writeTable, Row row, Head head, int columnIndex, int relativeRowIndex, boolean isHead) {
        // 不需要在此处实现
    }
    @Override
    public void afterCellCreate(WriteSheet writeSheet, WriteTable writeTable, Cell cell, Head head, int relativeRowIndex, boolean isHead) {
        // 不需要在此处实现
    }
    @Override
    public void afterCellDataConverted(WriteSheet writeSheet, WriteTable writeTable, CellData cellData, Cell cell, Head head, int relativeRowIndex, boolean isHead) {
        // 不需要在此处实现
    }
    @Override
    public void afterSheetCreate(WriteSheet writeSheet, WriteTable writeTable, Sheet sheet) {
        // 实现合并逻辑
        if (sheetIndex == writeSheet.getSheetNo()) {
            List<MergeRange> mergeRanges = new ArrayList<>();
            // 假设我们根据产品名称合并
            Map<String, Integer> productMap = new HashMap<>();
            // 这里需要遍历数据并确定合并范围，示例中简化处理
            // 实际应用中，应根据数据动态计算合并范围
            // 假设合并第2列（产品名称），从第2行开始
            int startRow = 1;
            int endRow = startRow;
            String lastProductName = null;
            for (int i = 1; i <= sheet.getLastRowNum(); i++) {
                Row row = sheet.getRow(i);
                if (row != null) {
                    Cell cell = row.getCell(mergeColIndex);
                    if (cell != null) {
                        String productName = cell.getStringCellValue();
                        if (lastProductName != null && lastProductName.equals(productName)) {
                            endRow = i;
                        } else {
                            if (lastProductName != null) {
                                mergeRanges.add(new MergeRange(startRow, endRow, mergeColIndex, mergeColIndex));
                            }
                            startRow = i;
                            endRow = i;
                            lastProductName = productName;
                        }
                    }
                }
            }
            // 添加最后一个合并范围
            if (lastProductName != null) {
                mergeRanges.add(new MergeRange(startRow, endRow, mergeColIndex, mergeColIndex));
            }
            // 执行合并
            for (MergeRange range : mergeRanges) {
                sheet.addMergedRegion(new CellRangeAddress(range.getStartRow(), range.getEndRow(), range.getStartCol(), range.getEndCol()));
            }
        }
    }
    // 简单的合并范围类
    private static class MergeRange {
        private int startRow;
        private int endRow;
        private int startCol;
        private int endCol;
        public MergeRange(int startRow, int endRow, int startCol, int endCol) {
            this.startRow = startRow;
            this.endRow = endRow;
            this.startCol = startCol;
            this.endCol = endCol;
        }
        // getters...
    }
}

注意：上述示例中的afterSheetCreate方法实现了一个简化的合并逻辑，实际应用中需要根据数据动态计算合并范围。更高效的做法是在数据准备阶段就确定好合并范围，并在写入Excel时直接应用。

4. 使用合并策略写入Excel

public class ExcelWriterExample {
    public static void main(String[] args) {
        String fileName = "sales_report.xlsx";
        // 准备数据
        List<SalesData> dataList = prepareData();
        // 写入Excel
        EasyExcel.write(fileName, SalesData.class)
                .registerWriteHandler(new CustomMergeStrategy(1, 0, 0)) // 合并第2列（索引0），从第2行开始
                .sheet("销售报表")
                .doWrite(dataList);
    }
    private static List<SalesData> prepareData() {
        // 模拟数据准备
        List<SalesData> dataList = new ArrayList<>();
        dataList.add(new SalesData("产品A", 100));
        dataList.add(new SalesData("产品A", 150));
        dataList.add(new SalesData("产品B", 200));
        // 其他数据...
        return dataList;
    }
}

四、优化与注意事项

1. 动态合并范围计算：在实际应用中，合并范围的计算应基于数据本身，而非硬编码。可以通过遍历数据列表，使用Map来记录每个产品名称的起始和结束行号。
2. 性能优化：对于大规模数据，合并操作可能会成为性能瓶颈。可以考虑在数据准备阶段就确定好合并范围，减少在Excel写入时的计算量。
3. 多Sheet支持：如果需要合并多个Sheet的单元格，需要在合并策略中根据sheetIndex进行区分。
4. 异常处理：在合并单元格时，应妥善处理可能出现的异常，如空指针异常、索引越界等。

五、总结

EasyExcel以其高效、简洁的特点，为Java开发者提供了处理Excel文件的强大工具。通过实现自定义的合并策略，开发者可以轻松实现合并单元格的功能，提升报表的可读性和美观度。本文详细介绍了EasyExcel实现合并单元格的步骤和注意事项，希望对开发者在实际项目中应用EasyExcel有所帮助。随着技术的不断发展，EasyExcel也将持续优化，为开发者带来更加高效、便捷的Excel处理体验。