easyexcel 导入数据 表头不固定

### 使用 EasyExcel 实现表头动态或不固定 Excel 数据导入

对于处理表头不固定的 Excel 文件导入，EasyExcel 提供了一种灵活的方式来进行操作。这不仅需要考虑不同数据结构的变化，还必须确保在导入过程中保持数据的准确性和完整性[^1]。

#### 添加 Maven 依赖
要使用 EasyExcel 和 FastJSON 进行开发，需先在项目的 `pom.xml` 中添加相应的依赖：

<!-- easyexcel -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.3.2</version>
</dependency>

<!-- fastjson -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>2.0.26</version>
</dependency>

#### 创建自定义监听器
为了支持动态表头，在读取 Excel 文件时可以创建一个继承于 `AnalysisEventListener<T>` 的类作为事件监听器。该监听器负责解析每一行的数据并将其转换成 Java 对象实例。这里 T 表示目标对象类型。

public class DynamicHeadListener extends AnalysisEventListener<Map<Integer, String>> {
    
    private List<List<String>> dataList = new ArrayList<>();

    @Override
    public void invoke(Map<Integer, String> data, AnalysisContext context) {
        // 将每行记录加入到列表中保存起来
        List<String> rowList = new ArrayList<>();
        for (int key : data.keySet()) {
            rowList.add(data.get(key));
        }
        dataList.add(rowList);
    }

    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        System.out.println("所有数据解析完成！");
    }

    public List<List<String>> getData() {
        return this.dataList;
    }
}

此段代码实现了对 Excel 文档内各单元格内容按列索引存储至 Map 结构中的逻辑，并最终收集所有的行信息形成二维数组形式的结果集。

#### 执行导入过程
最后一步就是调用 EasyExcel API 来启动实际的文件读入流程。下面给出一段简单的例子展示如何利用上述组件加载具有不确定头部布局的工作簿：

String fileName = "path/to/your/excel/file.xlsx";
DynamicHeadListener listener = new DynamicHeadListener();
// 设置只读模式以及指定监听器用于接收回调通知
EasyExcel.read(fileName).sheet().headRowNumber(0).doRead(listener);

// 获取解析后的全部数据
List<List<String>> resultData = listener.getData();

for(List<String> rowData : resultData){
    System.out.println(Arrays.toString(rowData.toArray()));
}

这段程序会遍历整个工作表并将其中的内容逐行打印出来。值得注意的是，通过调整参数 `.headRowNumber()` 可以控制从哪一行开始视为有效数据区域；如果希望跳过某些特定数量的标题栏，则应相应设置这个值大于零即可。