使用Apache POI无反射、不依赖单元格索引的Excel通用解析方案咨询

可行实现方案 #

核心思路是基于表头名称做动态映射，完全规避硬编码单元格索引，不需要依赖反射，改造成本极低，后续列顺序调整、增删列都不需要大幅修改代码。
具体实现逻辑如下：

• 第一步：提前维护DTO字段和Excel表头名称的对应关系，建议用枚举或者常量Map统一维护，后续规则改动只需要修改这一处
• 第二步：读取Excel的表头行（一般是第0行），遍历表头单元格生成「表头名称→列索引」的映射Map，自动适配列的实际位置
• 第三步：遍历数据行时，先从映射Map中获取对应字段的列索引，再读取单元格内容赋值给DTO即可

代码示例

首先定义字段和表头的映射关系：

// DTO字段和Excel表头的映射枚举，所有规则统一维护
public enum DtoExcelHeaderMapping {
    FIELD_X("字段X对应的表头文本", DTO::setFieldX),
    FIELD_Y("字段Y对应的表头文本", DTO::setFieldY);

    public final String headerName;
    public final BiConsumer<DTO, String> setter;

    DtoExcelHeaderMapping(String headerName, BiConsumer<DTO, String> setter) {
        this.headerName = headerName;
        this.setter = setter;
    }
}

改造后的解析方法：

public List<DTO> jsonConverter(Workbook workbook, Sheet sheet, String filename)
        throws ParseException {
    List<DTO> listOfDTOs = new ArrayList<>();
    // 读取表头生成索引映射
    Row headerRow = sheet.getRow(0);
    if (headerRow == null) {
        return listOfDTOs;
    }
    Map<String, Integer> headerIndexMap = new HashMap<>();
    for (int i = 0; i < headerRow.getPhysicalNumberOfCells(); i++) {
        String headerValue = getCellValueAsStringBasedOnCellType(workbook, headerRow.getCell(i)).trim();
        // 如果表头存在大小写不统一的情况，可以统一转小写/大写再存入，匹配时也做同样处理
        headerIndexMap.put(headerValue, i);
    }

    // 遍历数据行解析
    for (int index = 1; index <= sheet.getLastRowNum(); index++) {
        Row row = sheet.getRow(index);
        if (row == null) {
            continue;
        }
        DTO dto = new DTO();
        // 按映射规则批量赋值，无需硬编码索引
        for (DtoExcelHeaderMapping mapping : DtoExcelHeaderMapping.values()) {
            Integer colIndex = headerIndexMap.get(mapping.headerName);
            if (colIndex != null) {
                String cellValue = getCellValueAsStringBasedOnCellType(workbook, 
                        row.getCell(colIndex, Row.MissingCellPolicy.CREATE_NULL_AS_BLANK));
                mapping.setter.accept(dto, cellValue);
            }
        }
        listOfDTOs.add(dto);
    }
    return listOfDTOs;
}

// 原有单元格取值方法无需改动
public String getCellValueAsStringBasedOnCellType(Workbook workbook, Cell cell) {
    DataFormatter formatter = new DataFormatter();
    if (cell != null && cell.getCellType() == CellType.FORMULA) {
        FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();
        return formatter.formatCellValue(cell, evaluator);
    }
    return formatter.formatCellValue(cell);
}

方案优势

• 完全不使用反射，符合安全规范要求
• 列顺序调整时无需修改任何代码，程序会自动根据表头匹配对应索引
• 新增列时仅需要在枚举中加一行映射规则，无需修改原有解析逻辑
• 删除列时仅需要删除对应枚举项，不会影响其他字段的解析

内容的提问来源于stack exchange，提问作者anonymous