Java 读取 Excel 数据时保持列顺序的策略

column1    column2
value1      value2
value3      value4

0 = "column2" -> value2
    "column1" -> value1
1 = "column2" -> value4
    "column1" -> value3

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

public class ExcelReader {

    /**
     * 从给定的 Excel Sheet 中读取数据，并将其存储为 List<Map<String, String>>。
     * 每个 Map 保持原始列的插入顺序。
     *
     * @param sheet 要读取的 Excel Sheet 对象。
     * @return 包含所有行数据的 List，每行数据是一个保持列顺序的 Map。
     *         如果 Sheet 为空，则返回一个空列表。
     */
    public static List<Map<String, String>> readExcelSheetOrdered(Sheet sheet) {
        Iterator<Row> rows = sheet.iterator();

        // 检查 Sheet 是否为空
        if (!rows.hasNext()) {
            return Collections.emptyList();
        }

        // 读取标题行
        Row header = rows.next();
        List<String> keys = new ArrayList<>();
        // 遍历标题单元格，获取列名。
        // 注意：这里假设列名是连续的，遇到空列名则停止。
        for (Cell cell : header) {
            String value = cell.getStringCellValue().trim(); // 获取并修剪列名
            if (!value.isEmpty()) {
                keys.add(value);
            } else {
                // 如果遇到空列名，则认为后续没有有效列，停止读取标题
                break;
            }
        }

        // 存储所有行数据的列表
        List<Map<String, String>> result = new ArrayList<>();

        // 遍历数据行
        while (rows.hasNext()) {
            Row row = rows.next();
            // 使用 LinkedHashMap 替代 HashMap，以保持列的插入顺序
            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 = getCellValueAsString(cell);
                rowMap.put(keys.get(i), value);
            }

            // 仅添加非空行（即所有值不全为空的行）
            // 使用 stream() 和 allMatch() 检查所有值是否都为空字符串
            if (!rowMap.values().stream().allMatch(String::isEmpty)) {
                result.add(rowMap);
            }
        }

        return result;
    }

    /**
     * 辅助方法：将单元格内容转换为字符串。
     * 处理不同类型的单元格数据。
     *
     * @param cell 单元格对象。
     * @return 单元格内容的字符串表示。
     */
    private static String getCellValueAsString(Cell cell) {
        if (cell == null) {
            return "";
        }
        CellType cellType = cell.getCellType();
        switch (cellType) {
            case STRING:
                return cell.getStringCellValue().trim();
            case NUMERIC:
                // 对于日期类型，需要特殊处理
                if (DateUtil.isCellDateFormatted(cell)) {
                    return cell.getDateCellValue().toString(); // 或者使用 SimpleDateFormat 格式化
                } else {
                    // 对于数字，避免科学计数法，转换为普通字符串
                    DataFormatter formatter = new DataFormatter();
                    return formatter.formatCellValue(cell);
                }
            case BOOLEAN:
                return String.valueOf(cell.getBooleanCellValue());
            case FORMULA:
                // 尝试评估公式结果
                try {
                    return String.valueOf(cell.getNumericCellValue()); // 假设公式结果是数字
                } catch (IllegalStateException e) {
                    return cell.getStringCellValue().trim(); // 否则尝试作为字符串
                }
            case BLANK:
                return "";
            default:
                return cell.toString().trim();
        }
    }

    // 示例用法 (假设您有一个 Workbook 对象)
    public static void main(String[] args) throws Exception {
        // 这是一个伪代码示例，实际使用需要加载 Excel 文件
        // Workbook workbook = new XSSFWorkbook(new FileInputStream("your_excel_file.xlsx"));
        // Sheet sheet = workbook.getSheetAt(0);
        // List<Map<String, String>> orderedData = readExcelSheetOrdered(sheet);

        // 模拟一个 Sheet 对象进行测试
        // 假设 sheet 已经包含数据
        // ... (省略创建模拟 Sheet 的复杂代码，实际项目中通过文件读取)
        // 例如：
        // Sheet mockSheet = new XSSFWorkbook().createSheet("Test Sheet");
        // Row headerRow = mockSheet.createRow(0);
        // headerRow.createCell(0).setCellValue("column1");
        // headerRow.createCell(1).setCellValue("column2");
        //
        // Row dataRow1 = mockSheet.createRow(1);
        // dataRow1.createCell(0).setCellValue("value1");
        // dataRow1.createCell(1).setCellValue("value2");
        //
        // Row dataRow2 = mockSheet.createRow(2);
        // dataRow2.createCell(0).setCellValue("value3");
        // dataRow2.createCell(1).setCellValue("value4");
        //
        // List<Map<String, String>> orderedData = readExcelSheetOrdered(mockSheet);
        // orderedData.forEach(map -> {
        //     map.entrySet().forEach(entry -> System.out.println(entry.getKey() + " -> " + entry.getValue()));
        //     System.out.println("---");
        // });
        // workbook.close();
    }
}