Java中如何提取Excel指定工作表并转换为byte[]格式返回
核心实现逻辑
- 无法直接将单个
Sheet对象转为字节数组,需先创建一个全新的空工作簿,把目标工作表完整复制到新工作簿中 - 将新工作簿写入字节输出流,最终转换为
byte[]返回 - 需额外补充页码合法性校验、资源自动关闭逻辑,避免参数越界和内存泄漏
完整服务层代码
public byte[] getExcelByPageNumber(Integer pageNumber) throws IOException { // 注意:如果前端传入的页码是从1开始计数,需要先执行 pageNumber = pageNumber - 1 try ( // 读取原始工作簿 Workbook originWorkbook = WorkbookFactory.create(loader.getResource("classpath:file.xls").getInputStream()); // 创建新的空工作簿 Workbook newWorkbook = WorkbookFactory.create(true); // 字节输出流存储新工作簿内容 ByteArrayOutputStream baos = new ByteArrayOutputStream() ) { // 校验页码合法性 int maxPage = originWorkbook.getNumberOfSheets() - 1; if (pageNumber < 0 || pageNumber > maxPage) { throw new IllegalArgumentException("页码非法,有效范围为 0-" + maxPage); } // 读取原始目标工作表 Sheet originSheet = originWorkbook.getSheetAt(pageNumber); // 在新工作簿创建同名工作表 Sheet newSheet = newWorkbook.createSheet(originSheet.getSheetName()); // 完整复制工作表内容、样式、格式 SheetCopier copier = originSheet.createSheetCopier(newSheet); copier.copySheet(); // 将新工作簿写入字节流 newWorkbook.write(baos); return baos.toByteArray(); } }
控制器优化(适配前端下载场景)
如果需要支持前端直接下载文件,可以补充响应头配置:
@GetMapping(value = "/getSinglePage/{pageNumber}") private ResponseEntity<byte[]> getExcelByPageNumber(@PathVariable Integer pageNumber) throws IOException { byte[] excelBytes = service.getExcelByPageNumber(pageNumber); HttpHeaders headers = new HttpHeaders(); // 设置响应类型为二进制流 headers.setContentType(MediaType.APPLICATION_OCTET_STREAM); // 设置下载文件名 headers.setContentDispositionFormData("attachment", "第" + pageNumber + "页.xls"); return new ResponseEntity<>(excelBytes, headers, HttpStatus.OK); }
注意事项
- Apache POI默认工作表页码从0开始计数,如果业务里页码从1开始,需在使用前对
pageNumber做减1处理 - 代码同时兼容.xls和.xlsx格式,
WorkbookFactory会自动匹配对应类型的工作簿实现 - 建议使用POI 4.1.2及以上稳定版本,避免版本兼容问题
内容的提问来源于stack exchange,提问作者Bhumika
相关产品推荐
相关产品推荐

