EasyExcel 動態合併單元格詳解

Excel 是一種非常常見的文件格式，在工作中也是經常遇到。而 EasyExcel 是一個非常好用的 Java 操作 Excel 的工具，我們可以用它來快速完成對 Excel 的讀寫操作，同時也支持動態合併單元格功能，本文將詳細闡述 EasyExcel 動態合併單元格的使用方法。

一、準備工作

首先，我們需要在項目的 pom.xml 文件中引入 easyexcel 的依賴：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>2.2.6</version>
</dependency>

然後，我們需要創建一個 Excel 的實體類，這個實體類對應著 Excel 文件中的每一行數據。例如，我們要操作以下這個 Excel 文件：

姓名   學科   成績
小明   語文   90
小明   數學   95
小明   英語   88
小紅   語文   85
小紅   數學   92
小紅   英語   90

我們可以定義一個 ExcelEntity 類：

public class ExcelEntity {
    private String name;
    private String subject;
    private Integer score;
    
    //getters and setters
}

二、基礎操作

讀取 Excel 文件

使用 EasyExcel 讀取 Excel 文件非常簡單，只需要定義一個 AnalysisEventListener 類，並重寫其中的 invoke() 方法即可：

public class ExcelListener extends AnalysisEventListener<ExcelEntity> {
    @Override
    public void invoke(ExcelEntity data, AnalysisContext context) {
        //TODO 對讀取到的數據進行處理
    }
    
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        //TODO 所有數據解析完成後的操作
    }
}

public class ExcelUtil {
    public static void readExcel(String fileName) {
        try (InputStream inputStream = new FileInputStream(fileName)) {
            EasyExcel.read(inputStream, ExcelEntity.class, new ExcelListener()).sheet().doRead();
        } catch (Exception e) {
            //TODO 異常處理
        }
    }
}

其中，fileName 代表 Excel 文件的路徑。

寫入 Excel 文件

使用 EasyExcel 寫入 Excel 文件同樣也非常簡單，只需要定義一個 WriteHandler 類，並重寫其中的 invoke() 方法即可：

public class ExcelHandler implements WriteHandler {
    @Override
    public void sheet(int sheetNo, Sheet sheet) {
        //TODO 對當前 sheet 進行操作
    }

    @Override
    public void row(int rowNum, Row row) {
        //TODO 對當前 row 進行操作
    }

    @Override
    public void cell(int cellNum, Cell cell) {
        //TODO 對當前 cell 進行操作
    }
    
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        //TODO 所有數據解析完成後的操作
    }
}

public class ExcelUtil {
    public static void writeExcel(String fileName, List<ExcelEntity> list) {
        try (OutputStream outputStream = new FileOutputStream(fileName)) {
            EasyExcel.write(outputStream, ExcelEntity.class).sheet().doWrite(list);
        } catch (Exception e) {
            //TODO 異常處理
        }
    }
}

其中，fileName 代表要寫入 Excel 文件的路徑，list 代表要寫入的數據列表。

三、動態合併單元格

上述基礎操作可以幫助我們完成對 Excel 文件的讀寫操作，但是有時我們需要對 Excel 中的數據進行更加靈活的處理，例如，我們需要動態地對相同名稱的行進行合併。

EasyExcel 提供了抽象類 AbstractMergeStrategy，我們可以在自定義的類中繼承這個類，然後重寫其中的 merge() 方法實現動態合併單元格的功能。例如，我們要對上述 Excel 文件中的相同名稱的行進行合併，可以定義以下這個類：

public class ExcelMergeStrategy extends AbstractMergeStrategy {
    private int rowIndex = -1;
    private String lastName;

    @Override
    protected void merge(Sheet sheet, Cell cell, Head head, Integer relativeRowIndex) {
        if (head.getRowIndex() == 0 || !head.getHeadName().equals("姓名")) {
            return;
        }

        //獲取當前行的數據
        List<Object> currentRowData = sheet.getRow(relativeRowIndex);

        //獲取當前行姓名的值
        String name = currentRowData.get(0).toString();
        if (!name.equals(lastName)) {
            if (rowIndex != -1) {
                sheet.addMergedRegion(new CellRangeAddress(rowIndex, relativeRowIndex - 1, 0, 0));
            }
            rowIndex = relativeRowIndex;
            lastName = name;
        }

        if (relativeRowIndex == sheet.getLastRowNum()) {
            sheet.addMergedRegion(new CellRangeAddress(rowIndex, relativeRowIndex, 0, 0));
        }
    }
}

public class ExcelUtil {
    public static void readExcel(String fileName) {
        try (InputStream inputStream = new FileInputStream(fileName)) {
            EasyExcel.read(inputStream, ExcelEntity.class, new ExcelListener()).sheet().registerReadHandler(new ExcelMergeStrategy()).doRead();
        } catch (Exception e) {
            //TODO 異常處理
        }
    }
}

其中，我們重寫的 merge() 方法中，每次讀取一個單元格的時候都會被調用一次。我們可以判斷當前行的姓名的值是否和上一行相等，如果相等，則不需要合併單元格；如果不相等，則需要將上一組相同名稱的行進行合併。

最後，在讀取 Excel 文件的時候，我們需要將自定義的單元格合併策略類作為參數傳入到 registerReadHandler() 方法中。

四、總結

EasyExcel 是一個非常好用的 Java 操作 Excel 工具，可以幫助我們快速完成對 Excel 文件的讀寫操作。同時，它也支持動態合併單元格的功能，可以對 Excel 中的數據進行更加靈活的處理。希望本文對讀者們有所幫助。