Java中读取Excel数据并保持列顺序：使用LinkedHashMap

import org.apache.poi.ss.usermodel.*;
import java.util.*;
import java.util.stream.Collectors;

public class ExcelReaderWithOrder {

    /**
     * 从Excel工作表中读取数据，并以List<Map<String, String>>的形式返回，
     * 其中Map内部的键值对顺序与Excel列的物理顺序保持一致。
     *
     * @param sheet 要读取的Excel工作表对象
     * @return 包含Excel数据的List，每个Map代表一行，键为列名，值为单元格内容
     */
    public static List<Map<String, String>> readExcelSheet(Sheet sheet) {
        Iterator<Row> rows = sheet.iterator();

        // 如果工作表为空，则返回空列表
        if (!rows.hasNext()) {
            return Collections.emptyList();
        }

        // 读取第一行作为表头，提取列名
        Row header = rows.next();
        List<String> keys = new ArrayList<>();
        for (Cell cell : header) {
            String value = cell.getStringCellValue();
            // 仅添加非空的列名，遇到空列名则停止，假定后续无有效列
            if (!value.isEmpty()) {
                keys.add(value);
            } else {
                break;
            }
        }

        List<Map<String, String>> result = new ArrayList<>();

        // 遍历剩余的行数据
        while (rows.hasNext()) {
            Row row = rows.next();
            // 关键改动：使用LinkedHashMap来保证列的插入顺序
            Map<String, String> rowMap = new LinkedHashMap<>(); 

            // 遍历表头定义的列，填充当前行的数据
            for (int i = 0; i < keys.size(); ++i) {
                // 获取单元格，如果单元格不存在则创建为空白单元格
                Cell cell = row.getCell(i, Row.MissingCellPolicy.CREATE_NULL_AS_BLANK);
                String value;
                // 将单元格内容转换为字符串
                value = cell.toString(); 
                rowMap.put(keys.get(i), value);
            }

            // 仅添加非空行到结果列表
            // 判断条件：如果所有值都不是空字符串，则认为该行有效
            if (!rowMap.values().stream().allMatch(String::isEmpty)) {
                result.add(rowMap);
            }
        }

        return result;
    }

    public static void main(String[] args) {
        // 示例用法：假设你有一个Workbook对象
        // Workbook workbook = new XSSFWorkbook("your_excel_file.xlsx");
        // Sheet sheet = workbook.getSheetAt(0); // 获取第一个工作表
        // List<Map<String, String>> data = readExcelSheet(sheet);
        // System.out.println(data);

        // 模拟一个Sheet对象和数据进行测试
        // 实际应用中需要引入Apache POI库并加载真实的Excel文件
        // 这里仅为演示LinkedHashMap效果
        System.out.println("--- 模拟Excel数据读取 ---");
        // 模拟表头
        List<String> mockHeaders = Arrays.asList("column 1", "column2");
        // 模拟数据行
        List<List<String>> mockRows = new ArrayList<>();
        mockRows.add(Arrays.asList("value1", "value2"));
        mockRows.add(Arrays.asList("value3", "value4"));

        // 手动构建预期结果，以验证LinkedHashMap的顺序
        List<Map<String, String>> expectedOutput = new ArrayList<>();
        Map<String, String> row1 = new LinkedHashMap<>();
        row1.put("column 1", "value1");
        row1.put("column2", "value2");
        expectedOutput.add(row1);

        Map<String, String> row2 = new LinkedHashMap<>();
        row2.put("column 1", "value3");
        row2.put("column2", "value4");
        expectedOutput.add(row2);

        System.out.println("预期输出 (LinkedHashMap):");
        expectedOutput.forEach(map -> {
            map.forEach((key, value) -> System.out.println("  " + key + " -> " + value));
        });
        System.out.println("\n实际模拟代码运行效果 (如果使用LinkedHashMap，效果将与预期一致):");
        // 在实际的readExcelSheet方法中，如果将HashMap改为LinkedHashMap，
        // 那么输出的Map内部顺序将是"column 1", "column2"
        // 这里的main方法只是演示，readExcelSheet需要真实的POI Sheet对象
    }
}