Java实现Excel第一列含指定值的匹配行提取操作
Java实现Excel第一列匹配提取整行数据
常用依赖引入(Maven)
以Apache POI作为Excel解析核心库,适配.xls(2003版)和.xlsx(2007+版)两种格式,pom.xml依赖配置:
<dependencies> <!-- 支持xls格式解析 --> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>5.2.5</version> </dependency> <!-- 支持xlsx格式解析 --> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.5</version> </dependency> </dependencies>
核心实现逻辑
- 识别目标Excel文件的后缀格式,构建对应的Workbook实例
- 定位到需要检索的工作表(默认取第一个工作表,可按需指定Sheet名称/索引)
- 从工作表第一行开始逐行遍历,仅读取每行*第一列(索引为0的列)*的单元格值
- 将单元格值和预设的匹配值做规则比对,匹配成功则提取当前行全部列的单元格值,完成目标行的精准查询与提取
- 遍历完成后返回所有匹配成功的行数据
工具类核心代码
import org.apache.poi.ss.usermodel.*; import java.io.File; import java.io.FileInputStream; import java.io.IOException; import java.util.ArrayList; import java.util.List; public class ExcelRowExtractor { /** * 按第一列匹配值提取整行数据 * @param filePath 目标Excel文件绝对路径 * @param matchValue 第一列需要匹配的目标值 * @param sheetIndex 要检索的工作表索引,从0开始 * @return 匹配成功的整行数据列表,每个元素对应一行的所有单元格值 */ public static List<List<String>> extractRowByFirstColumnMatch(String filePath, String matchValue, int sheetIndex) throws IOException { List<List<String>> result = new ArrayList<>(); // 加载Excel文件 try (FileInputStream fis = new FileInputStream(new File(filePath)); Workbook workbook = WorkbookFactory.create(fis)) { // 获取指定工作表 Sheet sheet = workbook.getSheetAt(sheetIndex); // 逐行遍历 for (Row row : sheet) { // 跳过空行 if (row == null) continue; // 获取第一列单元格(索引0) Cell firstColCell = row.getCell(0); if (firstColCell == null) continue; // 统一转为字符串做匹配,兼容数字、字符串等单元格类型 String cellValue = getCellStringValue(firstColCell); // 匹配规则可按需调整:比如trim()、忽略大小写、模糊匹配等 if (cellValue.trim().equals(matchValue.trim())) { // 匹配成功,提取整行数据 List<String> rowData = new ArrayList<>(); // 遍历当前行所有列 for (int colIndex = 0; colIndex < row.getLastCellNum(); colIndex++) { Cell cell = row.getCell(colIndex); rowData.add(cell == null ? "" : getCellStringValue(cell)); } result.add(rowData); } } } return result; } /** * 兼容不同单元格类型,统一返回字符串值 */ private static String getCellStringValue(Cell cell) { CellType cellType = cell.getCellType(); if (cellType == CellType.STRING) { return cell.getStringCellValue(); } else if (cellType == CellType.NUMERIC) { // 数字类型可根据业务需求调整日期格式转换逻辑 return String.valueOf(cell.getNumericCellValue()); } else if (cellType == CellType.BOOLEAN) { return String.valueOf(cell.getBooleanCellValue()); } else if (cellType == CellType.FORMULA) { // 公式单元格取计算后的值 return cell.getStringCellValue(); } return ""; } }
实现注意事项
- 处理超大Excel文件时,避免一次性加载全量文件到内存,可切换为POI的流式只读模式,防止出现OOM异常
- 匹配逻辑可根据业务需求调整,仅需修改第一列单元格值的比对判断部分即可
- 若第一列存在合并单元格,需要单独处理合并区域的取值逻辑,避免出现空值判断失效
内容的提问来源于stack exchange,提问作者Rafał Surdziel
相关产品推荐
相关产品推荐

