Spring Boot 里用 POI 与 JasperReports 处理 Excel 和 PDF 报表

2. 实体与业务代码

实体就按业务字段来，我习惯用 @Entity 直接映射表。实际项目最好加上 Lombok 省掉 Getter/Setter，不过这里还是手写保持清晰。

import javax.persistence.*;

@Entity
@Table(name = "product")
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String productId;
    private String productName;
    private double price;
    private int sales;

    // 省略 getter/setter（实际开发推荐 Lombok）
}

导入时跳过表头是基本操作，导出时最好加上自动列宽，不然打开 Excel 还要手动调整。

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.web.multipart.MultipartFile;

import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;

@Service
public class ProductService {
    @Autowired
    private ProductRepository productRepository;

    @Transactional
    public void importProducts(MultipartFile file) throws IOException {
        List<Product> products = new ArrayList<>();
        Workbook workbook = new XSSFWorkbook(file.getInputStream());
        Sheet sheet = workbook.getSheetAt(0);
        Iterator<Row> iterator = sheet.iterator();
        
        if (iterator.hasNext()) {
            iterator.next(); // 跳过标题行
        }
        
        while (iterator.hasNext()) {
            Row currentRow = iterator.next();
            Product product = new Product();
            product.setProductId(currentRow.getCell(0).getStringCellValue());
            product.setProductName(currentRow.getCell(1).getStringCellValue());
            product.setPrice(currentRow.getCell(2).getNumericCellValue());
            product.setSales((int) currentRow.getCell(3).getNumericCellValue());
            products.add(product);
        }
        productRepository.saveAll(products);
        workbook.close();
    }

    @Transactional(readOnly = true)
    public byte[] exportProducts() throws IOException {
        List<Product> products = productRepository.findAll();
        Workbook workbook = new XSSFWorkbook();
        Sheet sheet = workbook.createSheet("Products");
        
        // 表头
        Row headerRow = sheet.createRow(0);
        headerRow.createCell(0).setCellValue("Product ID");
        headerRow.createCell(1).setCellValue("Product Name");
        headerRow.createCell(2).setCellValue("Price");
        headerRow.createCell(3).setCellValue("Sales");

        int rowNum = 1;
        for (Product product : products) {
            Row row = sheet.createRow(rowNum++);
            row.createCell(0).setCellValue(product.getProductId());
            row.createCell(1).setCellValue(product.getProductName());
            row.createCell(2).setCellValue(product.getPrice());
            row.createCell(3).setCellValue(product.getSales());
        }
        
        // 自动调整列宽
        for (int i = 0; i < 4; i++) {
            sheet.autoSizeColumn(i);
        }
        
        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
        workbook.write(outputStream);
        workbook.close();
        return outputStream.toByteArray();
    }
}

Controller 部分就是简单的文件上传和下载流返回，没啥花样。

import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;

@RestController
@RequestMapping("/api/products")
public class ProductController {
    @Autowired
    private ProductService productService;

    @PostMapping("/import")
    public ResponseEntity<String> importProducts(@RequestParam("file") MultipartFile file) {
        try {
            productService.importProducts(file);
            return ResponseEntity.ok("数据导入成功");
        } catch (IOException e) {
            return ResponseEntity.status(500).body("数据导入失败：" + e.getMessage());
        }
    }

    @GetMapping("/export")
    public ResponseEntity<byte[]> exportProducts() throws IOException {
        byte[] bytes = productService.exportProducts();
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.parseMediaType(
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"));
        headers.setContentDispositionFormData("attachment", "products.xlsx");
        return ResponseEntity.ok().headers(headers).body(bytes);
    }
}

二、用 JasperReports 生成 PDF 报表

Excel 适合处理数据，但正经的报表还是得 PDF。JasperReports 用模板把数据和格式分离，改样式不用动代码，对频繁调整的报告很友好。

1. 依赖配置

在之前的 pom.xml 基础上加上 JasperReports 相关依赖。

<dependencies>
    <!-- 其他依赖 ... -->
    <!-- JasperReports -->
    <dependency>
        <groupId>net.sf.jasperreports</groupId>
        <artifactId>jasperreports</artifactId>
        <version>6.17.0</version>
    </dependency>
    <dependency>
        <groupId>net.sf.jasperreports</groupId>
        <artifactId>jasperreports-fonts</artifactId>
        <version>6.17.0</version>
    </dependency>
</dependencies>

2. 报表服务

流程很固定：加载编译好的 .jasper 模板，塞参数和数据源，填充后导出 PDF 字节数组。

import net.sf.jasperreports.engine.*;
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.util.HashMap;
import java.util.Map;

@Service
public class ReportService {
    @Autowired
    private ProductRepository productRepository;

    public byte[] generateProductReport() throws JRException {
        var products = productRepository.findAll();
        
        // 加载 Jasper 模板（放在 resources/reports 下）
        InputStream templateStream =
            getClass().getResourceAsStream("/reports/product-report.jasper");
        JasperReport jasperReport =
            (JasperReport) JRLoader.loadObject(templateStream);
        
        // 参数
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("Title", "产品销售报表");
        
        // 数据源
        JRBeanCollectionDataSource dataSource =
            new JRBeanCollectionDataSource(products);
        
        // 填充
        JasperPrint jasperPrint =
            JasperFillManager.fillReport(jasperReport, parameters, dataSource);
        
        // 导出 PDF
        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
        JasperExportManager.exportReportToPdfStream(jasperPrint, outputStream);
        return outputStream.toByteArray();
    }
}

同样，Controller 里加一个 /report 接口返回 PDF 流就行，和 Excel 下载差不多。

三、取舍与注意点

这套方案的两个库各管一块，虽然多引入依赖，但比强行用一个解决所有问题要稳妥。实际用下来有几个容易踩的坑：

• 异常处理：POI 解析时如果单元格类型不匹配会直接抛异常，导入接口最好提前校验或给一个友好的错误提示。
• 大文件内存：XSSFWorkbook 会把整个文件读进内存，如果导入几万行数据同时还有复杂计算，记得设置 JVM 堆内存或者改用 SXSSFWorkbook。
• 字符编码：POI 导出中文列宽有时算不准，可以适当手动加宽；JasperReports 模板里注意中文字体，不然 PDF 里可能变成乱码。

这些都不是什么高深问题，但生产环境碰上一次就够折腾。提前处理好，后面能省不少事。