前言后台系统经常要和 Excel 打交道把数据整理成表格交给运营人员或者读取已有表格继续处理。Apache POI 提供了 Java 操作 Office 文件的能力本节先把最基础的 Excel 写入和读取流程走通。本文只讨论 XLSX 文件的基础读写。工作台的营业数据报表导出属于这套能力的后续应用文末只作简要说明。一、Apache POI 能做什么Apache POI 是 Java 操作 Microsoft Office 文件的开源项目其中最常用的场景是处理 Excel。Excel 有两种常见格式.xls旧版 Excel 格式.xlsx新版 Excel 格式。本节使用的是 XLSX所以代码中使用 XSSFWorkbook、XSSFSheet、XSSFRow 和 XSSFCell。它们之间的层级关系可以这样理解XSSFWorkbook 一个 Excel 工作簿 └── XSSFSheet 工作表例如“Sheet1” └── XSSFRow 一行数据 └── XSSFCell 一个单元格后续无论是自己创建表格还是打开一个已有模板本质上都是沿着这个结构定位数据。二、项目中的 POI 依赖学习笔记中的入门代码使用的是 POI 3.16。当前苍穹外卖项目在父工程 pom.xml 中统一管理的版本为 5.3.0并同时引入了下面两个依赖dependencygroupIdorg.apache.poi/groupIdartifactIdpoi/artifactIdversion${poi}/version/dependencydependencygroupIdorg.apache.poi/groupIdartifactIdpoi-ooxml/artifactIdversion${poi}/version/dependency其中poi-ooxml 用于处理 XLSX 这类 OOXML 格式文件。实际写项目时优先跟随当前工程已经声明的版本不要再额外混入笔记中的旧版本依赖。三、把数据写入 Excel 文件写入 Excel 的顺序很固定先在内存中创建工作簿再创建工作表、行和单元格最后通过输出流写到磁盘。importorg.apache.poi.xssf.usermodel.XSSFRow;importorg.apache.poi.xssf.usermodel.XSSFSheet;importorg.apache.poi.xssf.usermodel.XSSFWorkbook;importjava.io.FileOutputStream;publicclassPOITest{publicstaticvoidwrite()throwsException{try(XSSFWorkbookworkbooknewXSSFWorkbook();FileOutputStreamoutputStreamnewFileOutputStream(D:/itcast.xlsx)){XSSFSheetsheetworkbook.createSheet(itcast);XSSFRowrow1sheet.createRow(0);row1.createCell(1).setCellValue(姓名);row1.createCell(2).setCellValue(城市);XSSFRowrow2sheet.createRow(1);row2.createCell(1).setCellValue(张三);row2.createCell(2).setCellValue(北京);XSSFRowrow3sheet.createRow(2);row3.createCell(1).setCellValue(李四);row3.createCell(2).setCellValue(上海);workbook.write(outputStream);}}}这段代码中new XSSFWorkbook() 只是在内存里创建 Excel 对象还没有生成文件。createSheet(“itcast”) 创建名为 itcast 的工作表createRow(0) 创建第一行createCell(1) 创建该行的第二个单元格。最后调用 workbook.write(outputStream)工作簿中的内容才会通过 FileOutputStream 写入 D:/itcast.xlsx。运行后打开文件可以看到姓名、城市以及两行示例数据。这里推荐使用 try-with-resources。工作簿和输出流会在代码块结束后自动关闭避免文件被占用或资源泄漏。四、从 Excel 文件读取数据读取操作和写入操作正好相反先通过输入流打开文件再获取工作表、行和单元格最后读取单元格内容。importorg.apache.poi.xssf.usermodel.XSSFCell;importorg.apache.poi.xssf.usermodel.XSSFRow;importorg.apache.poi.xssf.usermodel.XSSFSheet;importorg.apache.poi.xssf.usermodel.XSSFWorkbook;importjava.io.FileInputStream;publicclassPOITest{publicstaticvoidread()throwsException{try(FileInputStreaminputStreamnewFileInputStream(D:/itcast.xlsx);XSSFWorkbookworkbooknewXSSFWorkbook(inputStream)){XSSFSheetsheetworkbook.getSheetAt(0);intlastRowNumsheet.getLastRowNum();for(inti0;ilastRowNum;i){XSSFRowrowsheet.getRow(i);XSSFCellnameCellrow.getCell(1);XSSFCellcityCellrow.getCell(2);StringnamenameCell.getStringCellValue();StringcitycityCell.getStringCellValue();System.out.println(name city);}}}}new XSSFWorkbook(inputStream) 会根据输入流加载已有的 Excel 文件。getSheetAt(0) 获取第一个工作表getLastRowNum() 获取最后一行的行号因此循环条件要写成 i lastRowNum。每次循环先取出当前行再取第 2、3 个单元格最后用 getStringCellValue() 得到文本内容。这个示例写入的全部是字符串所以可以直接按字符串读取。五、两个容易写错的细节1. 行号和列号从 0 开始POI 的行、列下标都从 0 开始createRow(0) 第 1 行 createCell(0) 第 1 列 createCell(1) 第 2 列示例把数据写到第 2、3 列所以使用的是 createCell(1) 和 createCell(2)。如果把 Excel 中看到的“第几列”直接当成 POI 的下标就会出现整体错位。2. 空行、空单元格和数据类型需要额外判断入门示例中的每一行、每个单元格都已提前写入数据读取时可以直接调用方法。真实 Excel 往往包含空行、空单元格、数字或日期这时直接调用 getStringCellValue() 可能抛出异常。处理外部上传的表格时应先判断 row 和 cell 是否为空再按单元格实际类型读取。基础练习先把“工作簿 → 工作表 → 行 → 单元格”的定位链路记清楚后续再补充类型处理会更稳。六、项目中的后续使用当前项目已经在 ReportServiceImpl 中使用 POI 读取运营数据报表模板先加载运营数据报表模板.xlsx再按工作表名取得 sheet随后定位固定行和单元格填入营业额、订单完成率、新增用户等数据最后把工作簿写到 HTTP 响应输出流。这说明报表导出并没有脱离本节基础它只是把“自己创建工作簿”换成了“读取现成模板”再按行列坐标填充数据。先掌握本节的读写操作后面理解模板报表会轻松很多。总结Apache POI 操作 XLSX 的核心结构是工作簿、工作表、行和单元格。写文件时从内存对象逐层创建后输出到磁盘读文件时从输入流加载后逐层定位并取值。记住下标从 0 开始并及时关闭工作簿和流就能完成最基础的 Excel 读写。