【EasyExcel】EasyExcel导入合并单元格的数据

该代码示例展示了如何使用阿里巴巴的EasyExcel库处理带有合并单元格的Excel数据导入。ImportExcelListener类是一个监听器,它捕获分析事件,处理合并单元格信息,并将数据转换为所需格式。解析后的数据存储在内存中并可供进一步操作。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

以下代码可以用来处理带有合并单元格的数据导入

import cn.hutool.core.collection.CollUtil;
import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.annotation.ExcelProperty;
import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.enums.CellExtraTypeEnum;
import com.alibaba.excel.event.AnalysisEventListener;
import com.alibaba.excel.metadata.CellExtra;
import lombok.extern.slf4j.Slf4j;

import java.io.InputStream;
import java.lang.reflect.Field;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;

/**
 * 导入excel数据监听器
 */
@Slf4j
public class ImportExcelListener<T> extends AnalysisEventListener<T> {

    /**
     * 最终返回的解析数据list
     */
    private final List<T> data = new ArrayList<>();
    /**
     * 解析数据
     * key是sheetName,value是相应sheet的解析数据
     */
    private final Map<String, List<T>> dataMap = new HashMap<>();
    /**
     * 合并单元格
     * key键是sheetName,value是相应sheet的合并单元格数据
     */
    private final Map<String, List<CellExtra>> mergeMap = new HashMap<>();

    /**
     * 正文起始行
     */
    private final Integer headRowNumber;

    public ImportExcelListener(Integer headRowNumber) {
        this.headRowNumber = headRowNumber;
    }

    @Override
    public void invoke(T data, AnalysisContext context) {
        String sheetName = context.readSheetHolder().getSheetName();
        dataMap.computeIfAbsent(sheetName, k -> new ArrayList<>());
        dataMap.get(sheetName).add(data);
    }

    @Override
    public void extra(CellExtra extra, AnalysisContext context) {
        String sheetName = context.readSheetHolder().getSheetName();
        switch (extra.getType()) {
            case MERGE: // 额外信息是合并单元格
                if (extra.getRowIndex() >= headRowNumber) {
                    mergeMap.computeIfAbsent(sheetName, k -> new ArrayList<>());
                    mergeMap.get(sheetName).add(extra);
                }
                break;
            case COMMENT:
            case HYPERLINK:
            default:
        }
    }

    @Override
    public void doAfterAllAnalysed(AnalysisContext analysisContext) {
        log.info("Excel数据解析完成!");
    }

    /**
     * 获取解析数据
     */
    public List<T> getData(InputStream in, Class<T> clazz) {
        try {
            EasyExcel.read(in, clazz, this)
                    .extraRead(CellExtraTypeEnum.MERGE)
                    .headRowNumber(headRowNumber)
                    .doReadAll();
        } catch (Exception e) {
            log.error("Excel读取异常:" + e);
        }
        convertDataMapToData();
        return data;
    }

    /**
     * 将具有多个sheet数据的dataMap转变成一个data
     */
    private void convertDataMapToData() {
        Iterator<Map.Entry<String, List<T>>> iterator = dataMap.entrySet().iterator();
        while (iterator.hasNext()) {
            Map.Entry<String, List<T>> next = iterator.next();
            String sheetName = next.getKey();
            List<T> list = next.getValue();
            List<CellExtra> mergeList = mergeMap.get(sheetName);
            if (CollUtil.isNotEmpty(mergeList)) {
                list = explainMergeData(list, mergeList);
            }
            data.addAll(list);
        }
    }

    /**
     * 处理有合并单元格的数据
     *
     * @param list      解析数据
     * @param mergeList 合并单元格信息
     * @return 填充好的解析数据
     */
    private List<T> explainMergeData(List<T> list, List<CellExtra> mergeList) {
        // 循环所有合并单元格信息
        mergeList.forEach(item -> {
            Integer firstRowIndex = item.getFirstRowIndex() - headRowNumber;
            Integer lastRowIndex = item.getLastRowIndex() - headRowNumber;
            Integer firstColumnIndex = item.getFirstColumnIndex();
            Integer lastColumnIndex = item.getLastColumnIndex();
            // 获取初始值
            Object initValue = getInitValueFromList(firstRowIndex, firstColumnIndex, list);
            // 设置值
            for (int i = firstRowIndex; i <= lastRowIndex; i++) {
                for (int j = firstColumnIndex; j <= lastColumnIndex; j++) {
                    setInitValueToList(initValue, i, j, list);
                }
            }
        });
        return list;
    }

    /**
     * 获取合并单元格的初始值
     * rowIndex对应list的索引
     * columnIndex对应实体内的字段
     *
     * @param firstRowIndex    起始行
     * @param firstColumnIndex 起始列
     * @param list             列数据
     * @return 初始值
     */
    private Object getInitValueFromList(Integer firstRowIndex, Integer firstColumnIndex, List<T> list) {
        Object filedValue = null;
        T object = list.get(firstRowIndex);
        for (Field field : object.getClass().getDeclaredFields()) {
            field.setAccessible(true);
            ExcelProperty annotation = field.getAnnotation(ExcelProperty.class);
            if (annotation != null) {
                if (annotation.index() == firstColumnIndex) {
                    try {
                        filedValue = field.get(object);
                        break;
                    } catch (IllegalAccessException e) {
                        log.error("获取合并单元格的初始值异常:" + e.getMessage());
                    }
                }
            }
        }
        return filedValue;
    }

    /**
     * 设置合并单元格的值
     *
     * @param filedValue  值
     * @param rowIndex    行
     * @param columnIndex 列
     * @param list        解析数据
     */
    public void setInitValueToList(Object filedValue, Integer rowIndex, Integer columnIndex, List<T> list) {
        T object = list.get(rowIndex);
        for (Field field : object.getClass().getDeclaredFields()) {
            field.setAccessible(true);
            ExcelProperty annotation = field.getAnnotation(ExcelProperty.class);
            if (annotation != null) {
                if (annotation.index() == columnIndex) {
                    try {
                        field.set(object, filedValue);
                        break;
                    } catch (IllegalAccessException e) {
                        log.error("设置合并单元格的值异常:" + e.getMessage());
                    }
                }
            }
        }
    }
}
<think>好的,我现在需要处理用户关于EasyExcel在模板导入时处理合并单元的问题。用户想要一个示例或教程,所以我得先回忆一下EasyExcel的相关功能和使用方法。 首先,EasyExcel是阿里巴巴开源的Excel处理工具,支持读写大数据量的Excel文件,尤其在处理大文件时内存占用较低。合并单元Excel中是常见的式,但在读取时,合并的单元只有第一个单元数据,其他单元可能为空,这会导致数据读取时的缺失。因此,处理合并单元的关键在于如何正确获取合并区域的数据,并填充到对应的位置。 接下来,我需要考虑用户可能的场景。用户可能在使用模板导入数据时,模板中存在合并单元,例如表头部分合并了多个单元,或者在数据区域有合并的行或列。这时候,直接读取可能会导致后续数据处理出错,因为合并的单元除了第一个外,其他都是空的。 解决方案方面,我记得EasyExcel提供了CellExtra接口来获取合并单元的信息。通过分析这些合并区域,可以在读取数据时动态填充合并的值。具体步骤可能包括:注册一个合并单元的监听器,在读取每行数据时检查该单元是否属于某个合并区域,如果是,则从合并区域的首个单元获取值,并填充到当前单元。 然后,我需要验证这个思路是否正确。查阅EasyExcel的官方文档,发现确实有关于合并单元处理的说明。例如,使用@ExcelProperty注解来匹配表头,但合并单元需要特别处理。此外,可以通过实现CellExtraEventListener接口来捕获合并单元的信息,并在读取过程中处理这些信息。 接下来,考虑编写示例代码。可能需要创建一个读取监听器,继承AnalysisEventListener,并实现CellExtraEventListener。在读取每个单元时,检查该单元是否位于某个合并区域内,如果是,则获取合并区域的首个单元的值,并赋值给当前单元。同时,需要保存合并单元的信息,比如起始行、结束行、起始列、结束列等。 此外,用户可能需要了解如何定义模板。在模板中,合并单元应正确设置,例如表头合并,数据区域的合并需要根据实际情况处理。读取时,通过监听器动态处理这些合并区域的数据填充。 最后,要确保示例代码的准确性和可运行性。需要导入正确的EasyExcel依赖,编写正确的模型类,使用@ExcelProperty注解映射表头,并正确配置读取时的参数,如注册监听器等。 总结步骤: 1. 添加EasyExcel依赖。 2. 创建数据模型类,使用@ExcelProperty注解。 3. 创建合并单元监听器,处理合并区域信息。 4. 在读取Excel时注册监听器,并在读取过程中动态填充合并单元的值。 5. 测试代码,确保合并单元数据正确读取。 可能遇到的问题包括合并区域的信息获取不准确,或者在填充数据时逻辑错误。需要确保在读取过程中,合并单元的信息被正确捕获,并在处理每一行时检查当前单元是否属于某个合并区域,从而正确赋值。 另外,需要提醒用户注意模板的设计,确保合并单元式正确,避免复杂的合并结构导致处理困难。同时,性能方面,如果合并单元过多,可能会影响读取速度,但EasyExcel本身处理大数据量较优,所以通常问题不大。</think>关于EasyExcel处理模板导入合并单元的解决方案如下: ### 一、问题分析 在Excel模板中,合并单元会导致读取时只有首有值,后续合并区域值为空。需要使用EasyExcel合并单元监听机制动态填充数据[^1]。 ### 二、实现步骤 #### 1. 添加Maven依赖 ```xml <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>3.1.1</version> </dependency> ``` #### 2. 定义数据模型类 ```java @Data public class DemoData { @ExcelProperty("合并标题") private String mergedHeader; @ExcelProperty("数据列") private String dataColumn; } ``` #### 3. 创建合并单元监听器 ```java public class MergeStrategy implements CellExtraEventListener { private final List<CellRange> mergedRegions = new ArrayList<>(); @Override public void extra(CellExtra extra, AnalysisContext context) { if (extra.getType() == CellExtraType.MERGE) { mergedRegions.add(new CellRange( extra.getFirstRowIndex(), extra.getLastRowIndex(), extra.getFirstColumnIndex(), extra.getLastColumnIndex() )); } } public Object convertData(CellData cellData, Integer rowIndex, Integer columnIndex) { for (CellRange range : mergedRegions) { if (range.contains(rowIndex, columnIndex)) { return context.readRowHolder().getCellMap().get(range.getFirstColumn()); } } return cellData.getStringValue(); } } ``` #### 4. 使用监听器读取数据 ```java public class ReadDemo { public static void main(String[] args) { MergeStrategy mergeStrategy = new MergeStrategy(); EasyExcel.read("template.xlsx", DemoData.class, new AnalysisEventListener<DemoData>() { @Override public void invoke(DemoData data, AnalysisContext context) { // 处理业务逻辑 System.out.println(data.getMergedHeader()); } @Override public void doAfterAllAnalysed(AnalysisContext context) { // 收尾操作 } }).registerExtraListener(mergeStrategy).sheet().doRead(); } } ``` ### 三、关键点说明 1. **合并区域检测**:通过`CellExtraEventListener`捕获所有合并单元的坐标范围 2. **动态数据填充**:在`convertData`方法中根据坐标判断是否属于合并区域 3. **首值继承**:当检测到当前单元位于合并区域时,自动继承首的值 相关问题
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值