拿来即用 Java 企业级工具类全家桶-58-Excel表格读取工具类 目录一、工具类功能二、所需环境三、方法概览按需调用四、调用示例直观体验五、工具类源码可直接复制一、工具类功能基于阿里 EasyExcel 的表格读取工具类接住「按 sheet 名读单表、读全部 sheet、大文件逐行流式消费」三类需求行数据映射成标注 ExcelProperty 的实体。拿回来的是填好的实体列表、按 sheet 名分组的有序 Map或实际交付的行数。表头行数与是否丢弃整行空白都可指定结果一律不为 nullsheet 名首尾空白先裁再匹配。面向中小体量表格的整体读取与单表流式导入不做公式计算、样式解析与超大文件分片。二、所需环境JDK 17或以上 Spring Boot 3.x或以上dependencygroupIdcom.alibaba/groupIdartifactIdeasyexcel/artifactIdversion4.0.3/version/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactId/dependencydependencygroupIdorg.projectlombok/groupIdartifactIdlombok/artifactIdscopeprovided/scope/dependency三、方法概览按需调用序号方法入参返回用途1readBySheetName(String, String, int, Class)表格文件路径 工作表名 表头行数 映射实体类型List按名称读单个 sheet保留空行2readBySheetName(File, String, int, Class, boolean)表格文件 工作表名 表头行数 映射实体类型 是否丢弃空行List读单个 sheet可选丢弃整行空白3readAllSheets(String, int, Class)表格文件路径 表头行数 映射实体类型MapString,List一次读全部 sheet保留空行4readAllSheets(File, int, Class, boolean)表格文件 表头行数 映射实体类型 是否丢弃空行MapString,List读全部 sheet可选丢弃整行空白5readAllSheets(Path, int, Class)表格文件路径 表头行数 映射实体类型MapString,ListPath 入口读全部 sheet保留空行6readBySheetName(File, String, int, Class, boolean, Consumer? super T)表格文件 工作表名 表头行数 映射实体类型 是否丢弃空行 行消费者int逐行流式消费单个 sheet返回交付行数四、调用示例直观体验调用示例直接复制进 IDE 右键 Run 就能看到调用工具类各方法的输出结果。21:00:30.201[main]INFO--「EasyExcelReadUtils方法1readBySheetName(String,String,int,ClassT)」返回数据列表-[OrderRow{orderNoORD-1,amount100.50,remark正常},OrderRow{orderNonull,amountnull,remarknull},OrderRow{orderNoORD-2,amount200.00,remarknull}]21:00:30.223[main]INFO--「EasyExcelReadUtils方法2readBySheetName(File,String,int,ClassT,boolean)」丢弃映射列全空的行-[OrderRow{orderNoORD-1,amount100.50,remark正常},OrderRow{orderNoORD-2,amount200.00,remarknull}]21:00:30.239[main]INFO--「EasyExcelReadUtils方法3readAllSheets(String,int,ClassT)」返回按 sheet 分组-{6月订单[OrderRow{orderNoORD-1,amount100.50,remark正常},OrderRow{orderNonull,amountnull,remarknull},OrderRow{orderNoORD-2,amount200.00,remarknull}],退货[OrderRow{orderNoRET-9,amount-50.00,remark退款}]}21:00:30.253[main]INFO--「EasyExcelReadUtils方法4readAllSheets(File,int,ClassT,boolean)」丢弃空行后的分组-{6月订单[OrderRow{orderNoORD-1,amount100.50,remark正常},OrderRow{orderNoORD-2,amount200.00,remarknull}],退货[OrderRow{orderNoRET-9,amount-50.00,remark退款}]}21:00:30.266[main]INFO--「EasyExcelReadUtils方法5readAllSheets(Path,int,ClassT)」返回按 sheet 分组-{6月订单[OrderRow{orderNoORD-1,amount100.50,remark正常},OrderRow{orderNonull,amountnull,remarknull},OrderRow{orderNoORD-2,amount200.00,remarknull}],退货[OrderRow{orderNoRET-9,amount-50.00,remark退款}]}21:00:30.281[main]INFO--「EasyExcelReadUtils方法6readBySheetName(File,String,int,ClassT,boolean,Consumer?superT)」返回交付行数-2,逐行取到订单号-[ORD-1,ORD-2]21:00:30.293[main]ERROR--「异常信息获取演示」找不到 sheet-未找到名为[不存在]的 sheet当前文件包含:[6月订单,退货]21:00:30.293[main]ERROR--「异常信息获取演示」文件不存在-Excel文件不存在:没有这个.xlsx21:00:30.293[main]ERROR--「异常信息获取演示」表头行数非法-headRowNumber 必须大于等于1进程已结束退出代码为0packagecom.example.order.api;importcom.alibaba.excel.EasyExcel;importcom.alibaba.excel.ExcelWriter;importcom.alibaba.excel.annotation.ExcelProperty;importcom.alibaba.excel.write.metadata.WriteSheet;importcom.example.common.utils.EasyExcelReadUtils;importlombok.extern.slf4j.Slf4j;importjava.io.File;importjava.io.IOException;importjava.math.BigDecimal;importjava.nio.file.Files;importjava.nio.file.Path;importjava.util.ArrayList;importjava.util.Comparator;importjava.util.List;importjava.util.Map;/** * 调用示例整个文件复制进 IDE右键 Run 就能看效果。 * * pEasyExcel 读写不依赖外部服务也不需要 Spring 容器示例在系统临时目录里现造一个含两张 * sheet 的 xlsx跑完自删不依赖任何外部样表。表头写四列、实体只映射前三列中间那行「映射列全空」 * 的数据才会被解析器交付下来从而看出 skipBlankRows 开与关的差别。 * 日志用 Lombok 的 {code Slf4j} SLF4J 占位符没装 Lombok 就把 {code log} 换成项目自己的 Logger。 */Slf4jpublicclassEasyExcelReadUtilsDemo{/** 示例用的行实体实际换成你自己的字段用 ExcelProperty 标注表头 */publicstaticclassOrderRow{ExcelProperty(订单号)privateStringorderNo;ExcelProperty(金额)privateBigDecimalamount;ExcelProperty(备注)privateStringremark;publicOrderRow(){}publicStringgetOrderNo(){returnorderNo;}publicvoidsetOrderNo(StringorderNo){this.orderNoorderNo;}publicBigDecimalgetAmount(){returnamount;}publicvoidsetAmount(BigDecimalamount){this.amountamount;}publicStringgetRemark(){returnremark;}publicvoidsetRemark(Stringremark){this.remarkremark;}OverridepublicStringtoString(){returnOrderRow{orderNoorderNo, amountamount, remarkremark};}}/** 样表表头四列实体只映射前三列第四列是业务侧不关心的流水号 */privatestaticfinalListStringHEADList.of(订单号,金额,备注,流水号);publicstaticvoidmain(String[]args)throwsIOException{PathdirFiles.createTempDirectory(easyexcel-demo);Filesampledir.resolve(订单.xlsx).toFile();try{writeSample(sample);// 一、按名称读取单个 sheet ListOrderRowbyNameEasyExcelReadUtils.readBySheetName(sample.getPath(),6月订单,1,OrderRow.class);log.info(「EasyExcelReadUtils 方法1 readBySheetName(String, String, int, ClassT)」返回数据列表 - {},byName);ListOrderRowskipBlankEasyExcelReadUtils.readBySheetName(sample,6月订单,1,OrderRow.class,true);log.info(「EasyExcelReadUtils 方法2 readBySheetName(File, String, int, ClassT, boolean)」丢弃映射列全空的行 - {},skipBlank);// 二、一次读取全部 sheet MapString,ListOrderRowallByNameEasyExcelReadUtils.readAllSheets(sample.getPath(),1,OrderRow.class);log.info(「EasyExcelReadUtils 方法3 readAllSheets(String, int, ClassT)」返回按 sheet 分组 - {},allByName);MapString,ListOrderRowallSkipBlankEasyExcelReadUtils.readAllSheets(sample,1,OrderRow.class,true);log.info(「EasyExcelReadUtils 方法4 readAllSheets(File, int, ClassT, boolean)」丢弃空行后的分组 - {},allSkipBlank);MapString,ListOrderRowallByPathEasyExcelReadUtils.readAllSheets(sample.toPath(),1,OrderRow.class);log.info(「EasyExcelReadUtils 方法5 readAllSheets(Path, int, ClassT)」返回按 sheet 分组 - {},allByPath);// 三、逐行流式消费 ListStringorderNosnewArrayList();intdeliveredEasyExcelReadUtils.readBySheetName(sample,6月订单,1,OrderRow.class,true,row-orderNos.add(row.getOrderNo()));log.info(「EasyExcelReadUtils 方法6 readBySheetName(File, String, int, ClassT, boolean, Consumer? super T)」返回交付行数 - {}, 逐行取到订单号 - {},delivered,orderNos);// 四、catch异常信息 // 1. sheet 名找不到报错会列出文件内全部 sheet 名try{EasyExcelReadUtils.readBySheetName(sample,不存在,1,OrderRow.class,false);}catch(IllegalArgumentExceptione){log.error(「异常信息获取演示」找不到 sheet - {},e.getMessage());}// 2. 文件不存在try{EasyExcelReadUtils.readBySheetName(newFile(没有这个.xlsx),6月订单,1,OrderRow.class,false);}catch(IllegalArgumentExceptione){log.error(「异常信息获取演示」文件不存在 - {},e.getMessage());}// 3. 表头行数小于 1try{EasyExcelReadUtils.readBySheetName(sample,6月订单,0,OrderRow.class,false);}catch(IllegalArgumentExceptione){log.error(「异常信息获取演示」表头行数非法 - {},e.getMessage());}}finally{deleteQuietly(dir);}}/** 在临时目录里现造 xlsx两张 sheet「6月订单」中间夹一行映射列全空的数据用来演示 skipBlankRows */privatestaticvoidwriteSample(Filesample){WriteSheetjuneEasyExcel.writerSheet(0,6月订单).build();WriteSheetrefundEasyExcel.writerSheet(1,退货).build();try(ExcelWriterwriterEasyExcel.write(sample).build()){writer.write(List.of(HEAD,List.of(ORD-1,100.50,正常,A01),List.of(,,,A02),List.of(ORD-2,200.00,,A03)),june);writer.write(List.of(HEAD,List.of(RET-9,-50.00,退款,B01)),refund);}}/** 递归删除临时目录与其中的样表先删文件后删目录 */privatestaticvoiddeleteQuietly(Pathdir){try(varpathsFiles.walk(dir)){paths.sorted(Comparator.reverseOrder()).forEach(path-{try{Files.deleteIfExists(path);}catch(IOExceptionignored){// 临时文件删不掉也不影响示例结论}});}catch(IOExceptionignored){// 目录已不存在或被占用忽略}}}五、工具类源码可直接复制拿来即用 58-Excel表格读取工具类java企业级代码.zip 工具类已调试通过复制粘贴即可使用省时省力 可保存到自己网盘永久有效觉得对您有帮助麻烦点点关注啦您的关注是我创作的最大动力~