easyexcel合并单元格工具

### 使用 EasyExcel 实现合并单元格

#### 自定义监听器收集合并单元格信息
为了实现读取含有合并单元格的 Excel 文件，在监听器中添加了用于收集合并单元格的相关代码[^1]。

public class MergeCellListener extends AnalysisEventListener<YourDataClass> {
    private List<CellRangeAddress> mergeRegions = new ArrayList<>();

    @Override
    public void invoke(YourDataClass data, AnalysisContext context) {
        // 收集需要合并的信息逻辑...
    }

    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        // 所有数据解析完成后的处理...
    }
}

#### 基于规则配置实现简单的单元格合并效果
通过设定一些基本规则来决定哪些单元格应该被合并，可以达到预期的效果展示。此过程涉及到了对特定区域内的值进行比较以及设置相应的样式属性[^2]。

#### 动态依据单元格数值判定并执行合并操作
当向 Excel 表单内写入数据时，可以根据实际需求动态地判断相邻两行或多行间是否存在相同的内容；如果满足预设条件，则对该部分实施跨行列方向上的联合显示动作[^3]。

// 获取到工作簿对象之后立即注册处理器实例
writeWorkbook.registerWriteHandler(new CellMergeStrategy(dataList));

#### 利用注解与 RowWriteHandler 完成高效定制化方案
采用 `@Column` 注解标记实体类字段对应表格列的同时，配合实现了接口 `RowWriteHandler` 的组件来进行更灵活精准控制下的批量合并不再困难重重[^4]。

// 创建自定义合并策略类继承 AbstractRowWriteHandlerAdapter 并重写相应方法
public class CustomMergeStrategy extends AbstractRowWriteHandlerAdapter {

    @Override
    protected void afterSheetCreate(Sheet sheet) {}

    @Override
    protected void afterRowDispose(Table table, int relativeRowIndex, boolean isHead) {}
}

// 调用API创建文件流、指定模板映射关系后应用上述策略最终写出目标文档
EasyExcel.write(filePath).withTemplate(templatePath)
     .registerWriteHandler(new CustomMergeStrategy())
     .sheet()
     .doFill(dataMap);