Apache POI 解析复杂的excel表格

本文介绍: 一篇文章教你如何使用 apache POI框架解析工作中遇到的复杂的Exc el 文件，内含完整项目代码以及测试文件。

最近接到一个需求，让我解析Exc el表。这要是简单常规的Exc el表，那我还能摸一摸鱼给他整出来，主要是给我的Exc el表长得跟下图中的Exc el表一样复杂难搞，这可把我难倒了。于是开启了我的百度之旅，有可能是我不会百度或者理解能力太差，反正就是我的问题。愣是找不到一篇文章能让我这种智力不足的人弄明白该如何去解析这种复杂的Exc el表格。于是我决定按照自己的思维去解析这种复杂的Exc el表格，希望能得到小伙伴们的认可。

图片来源：https://blog.csdn.net/weixin _42803027/ar ti cle/de tail s/110189928

在这里插入图片描述

这里我使用到是XSSF接口，毕竟除了能解析 xlsx格式的Ex cel以外，也可以兼容解析 x ls格式的Ex cel。详细的使用可以常考上面的两篇文章，第一篇是讲HSSF的用法，第二篇是讲XSSF的用法。两者的用法非常相似，建议两篇文章结合使用。为了消除接下来的代码阅读障碍，这里将简单讲解一下案例中使用到的方法。

// 创建一个关联输入流的工作簿
Workbook workbook = WorkbookFactory.create(file.getInputStream());
// 根据工作表下标获取指定工作表
Sheet sheet = workbook.getSheetAt(sheetIndex);
// 获取工作表中的行，此处为第一行
Row row = sheet.getRow(0);
// 获取工作表中第一行的第一列单元格
Cell cell = row.getCell(0);
// 获取单元格的属性值，由于cell有相应的单元格类型以及对应的值也有其数据类型，所以获取值的路途可能比较麻烦点。这里简单获取它的值一下，接下来会有一个专门的函数去获取它的值。
cell.getStringCellValue();

// 获取sheet工作表中所有的合并单元格的个数
int sheetMergerCount = sheet.getNumMergedRegions();
// 根据下标获取工作表中指定的合并单元格
CellRangeAddress cra = sheet.getMergedRegion(i);

Excel中的工作簿、工作表、行、单元格中的关系：

为了加深对Excel的了解，这里将结合图片详细讲解一下。

/**
 * 获取cell单元格中的值
 * @param cell
 * @return
 */
private Object getValue(Cell cell) {
    Object value = null;
    if (cell == null) {
        return null;
    } else if (cell.getCellType().equals(CellType.FORMULA)) {   // 单元格的数据属于公式类
        switch (cell.getCachedFormulaResultType()) {
            case STRING:
                // 字符串类型
                value = cell.getStringCellValue();
                break;
            case NUMERIC:
                // double类型
                value = cell.getNumericCellValue();
                break;
            case BOOLEAN:
                // boolean类型
                value = cell.getBooleanCellValue();
                break;
            default:
                // 字符串类型
                value = cell.getCellFormula();
        }
    } else if (cell.getCellType().equals(CellType.NUMERIC)) {   // 单元格的数据属于数字类
        if (DateUtil.isCellDateFormatted(cell)) {
            value = cell.getDateCellValue();
        } else {
            value = new BigDecimal(cell.toString());
        }
    } else {
        value = StringUtils.isBlank(cell.toString()) ? null : cell.toString();
    }
    return value;
}

/**
 * 判断cellRow行、cellCol列对应的单元格是否为合并单元格
 * @param sheet	工作表
 * @param cellRow	cell对应的行号
 * @param cellCol	cell对应的列号
 * @return
 */
private MergedRegion getMergerCellRegionRow(Sheet sheet, int cellRow, int cellCol) {
    // 获取sheet工作表中所有的合并单元格的个数
    int sheetMergerCount = sheet.getNumMergedRegions();
    for (int i = 0; i < sheetMergerCount; i++) {
        // 获取指定合并单元格
        CellRangeAddress cra = sheet.getMergedRegion(i);
        int firstRow = cra.getFirstRow(); // 合并单元格CELL起始行
        int firstCol = cra.getFirstColumn(); // 合并单元格CELL起始列
        int lastRow = cra.getLastRow(); // 合并单元格CELL结束行
        int lastCol = cra.getLastColumn(); // 合并单元格CELL结束列
        // 判断cellRow行、cellCol列对应的单元格是否在该合并单元格的范围中
        if (cellRow >= firstRow &amp;&amp; cellRow <= lastRow) {
            if (cellCol >= firstCol &amp;&amp; cellCol <= lastCol) {
                return new MergedRegion(firstRow, lastRow, firstCol, lastCol);
            }
        }
    }
    return null;
}

// 解析复杂excel表，并将目标值的位置存储起来
private void readExcelMixMergedRegion(Sheet sheet) {
    System.out.println("======= 解析Excel文件start =======");
    // 获取工作表中的行数
    int numberOfRows = sheet.getPhysicalNumberOfRows();
    for (int i = 0; i < numberOfRows; i++) {
        Row row = sheet.getRow(i);
        // 遍历每行的列（即遍历所有单元格）
        for (int j = 0; j < row.getPhysicalNumberOfCells(); j++) {
            System.out.printf("(%d-%d)", i, j);
            int rowIndex = i, columnIndex = j;
            // 判断行号为i，列号为j的单元格是否为合并单元格，不为合并单元格返回null，若为合并单元格返回MergedRegion对象
            MergedRegion mergedRegion = getMergerCellRegionRow(sheet, i, j);
            Cell cell = null;
            if (mergedRegion != null) { // 若为合并单元格,需要进行进一步处理
                // 若当前的行号和列号是合并单元格的第一行、第一列,就获取单元格（合并单元格只有其第一行、第一列的位置有值）
                if (i == mergedRegion.getFirstRow() &amp;&amp; j == mergedRegion.getFirstColumn()) {
                    cell = row.getCell(j);  // 获取单元格
                    j = mergedRegion.getLastColumn();  // 将列下标移到当前行的下一个单元格列下标，减少不必要的扫描
                }else{  // 若为合并单元格的非第一行，则直接将列下标移到当前行的下一个单元格列下标，并进行接下来的扫描
                    j = mergedRegion.getLastColumn();   //
                    continue;
                }
            } else {    // 若不为合并单元格,直接获取单元格
                cell = row.getCell(j);
            }
            Object val = getValue(cell);    // 获取单元格的值
            if (val==null) {    // 若单元格的值为null，说明该单元格为目标单元格，需要存储它的位置
                TargetRegion targetRegion = new TargetRegion(rowIndex, columnIndex);
                targetRegions.add(targetRegion);
            }
            System.out.println(val==null?null:val.toString());
        }
    }
    System.out.println("======= 解析Excel文件end =======");
}

/**
 * 根据存储的目标值位置去获取相应的value值
 * @param sheet
 * @param paramsValueList   存储目标值容器
 */
private void getTargetCellsValue(Sheet sheet,List<Object> paramsValueList) {
    System.out.println("======= 读取目标值start =======");
    targetRegions.forEach(item -> {
        int row = item.getRow();
        int column = item.getColumn();
        System.out.print("("+row+","+column+") ");
        Object val = getValue(sheet.getRow(row).getCell(column));
        paramsValueList.add(val);
        System.out.println(val==null?null:val.toString());
    });
    System.out.println("======= 读取目标值end =======");
}