使用EasyExcel导入Excel时，如何合并所有列后再进行数据读取？

Question

在使用 EasyExcel 导入 Excel 文件时，如何在读取数据前将所有列合并为一个字段进行处理？实际业务中可能存在某些 Excel 文件结构不规范，数据按列拆分但逻辑上属于同一内容，如何在不修改原始 Excel 的前提下，通过 EasyExcel 实现列的合并读取？常见问题包括：EasyExcel 是否支持动态列合并、如何自定义列合并逻辑、合并后如何映射到实体类或处理为统一字段等问题。掌握这些技巧可提升对非标准 Excel 文件的处理能力。

Answer 1

一、EasyExcel 列合并读取的背景与挑战

在实际业务场景中，Excel 文件的格式往往不规范，数据可能被拆分到多个列中，但逻辑上属于一个整体内容。例如，一个地址字段可能被拆分为“省”、“市”、“区”、“街道”四列，而业务系统希望将其合并为一个“完整地址”字段。

使用 EasyExcel 导入此类文件时，如何在不修改原始 Excel 文件的前提下，将多个列合并为一个字段进行处理，是开发者常遇到的挑战。

二、EasyExcel 是否支持动态列合并？

EasyExcel 本身并不直接提供“列合并”的功能，但其提供了强大的监听器机制和自定义读取逻辑的支持，允许开发者在读取 Excel 数据时动态处理每一行数据。

• EasyExcel 支持按列索引或列名读取数据
• 支持在监听器中自定义数据处理逻辑
• 可结合 Map 或自定义对象接收合并后的字段

三、如何实现列合并读取？

实现列合并的核心在于利用 EasyExcel 的 ReadListener 接口，在读取每一行数据时，手动合并多个列的值。

1. 定义一个自定义实体类或使用 Map 存储数据
2. 编写自定义监听器，继承 AnalysisEventListener
3. 在监听器中获取每一行的数据列表
4. 按列索引或列名提取多个字段值并合并
5. 将合并后的值映射到目标字段

四、示例代码：使用 Map 实现列合并

        public class MergeColumnListener extends AnalysisEventListener<Map<Integer, String>> {
            @Override
            public void invoke(Map<Integer, String> data, AnalysisContext context) {
                // 假设列0为省，列1为市，列2为区
                String province = data.get(0);
                String city = data.get(1);
                String district = data.get(2);
                String fullAddress = province + city + district;
                System.out.println("合并后的地址：" + fullAddress);
            }

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

五、自定义实体类与字段映射

如果希望将合并后的字段映射到实体类，可以使用如下方式：

列索引	原始字段	目标字段
0	省	完整地址
1	市
2	区

六、实现自定义实体类的监听器

        public class Address {
            private String fullAddress;
            // getter and setter
        }

        public class AddressMergeListener extends AnalysisEventListener<Map<Integer, String>> {
            private List<Address> addressList = new ArrayList<>();

            @Override
            public void invoke(Map<Integer, String> data, AnalysisContext context) {
                Address address = new Address();
                String fullAddress = data.get(0) + data.get(1) + data.get(2);
                address.setFullAddress(fullAddress);
                addressList.add(address);
            }

            @Override
            public void doAfterAllAnalysed(AnalysisContext context) {
                // 处理完成后的逻辑
            }
        }
    

七、动态列合并的进阶处理

在某些场景中，列的数量和结构可能不固定。此时可以结合 Excel 的表头信息动态判断需要合并的列。

• 通过 HeadMap 获取列名与索引的对应关系
• 根据列名前缀或规则判断需要合并的列
• 使用正则表达式匹配列名

八、流程图：列合并读取的整体流程

            graph TD
                A[开始读取 Excel 文件] --> B[加载表头信息]
                B --> C{判断列结构是否固定?}
                C -->|是| D[按固定列索引合并]
                C -->|否| E[动态获取列索引]
                D & E --> F[读取每一行数据]
                F --> G[合并指定列]
                G --> H[映射到实体类或 Map]
                H --> I[存储或处理数据]