使用POI实现Excel转PDF：完整指南与实践

引言

在企业级应用中，经常需要将Excel数据导出为PDF格式以便于存档、共享或打印。Apache POI作为处理Microsoft Office格式文件的开源库，可以轻松读取Excel内容，但生成PDF通常需要额外工具。本文将演示如何结合POI与PDF库，实现高效、准确的Excel转PDF转换。

环境准备

首先，确保项目依赖以下库：

• Apache POI：用于读取Excel文件（.xls或.xlsx）
• Apache PDFBox或iText：用于生成PDF文档
• 可选：Apache POI的OOXML模块（处理.xlsx文件）

在Maven项目的pom.xml中添加依赖：

    org.apache.poi
    poi
    5.2.3


    org.apache.poi
    poi-ooxml
    5.2.3


    org.apache.pdfbox
    pdfbox
    2.0.27

基本实现步骤

1. 读取Excel文件

使用POI的WorkbookFactory加载Excel文件，遍历工作表、行和单元格，提取数据。

2. 设计PDF布局

创建PDF文档并设置页面大小、边距、字体等样式。建议映射Excel的表格结构到PDF中的表格或文本块。

3. 数据转换与渲染

将Excel数据逐行写入PDF。处理数字、日期、公式等特殊格式，并保留基本样式（如加粗、颜色）。

代码示例

以下是一个简化的Java代码片段，演示核心逻辑：

import org.apache.poi.ss.usermodel.*;
import org.apache.pdfbox.pdmodel.*;
import org.apache.pdfbox.pdmodel.font.PDType1Font;

public class ExcelToPdfConverter {
    public void convert(String excelPath, String pdfPath) throws Exception {
        // 1. 读取Excel
        Workbook workbook = WorkbookFactory.create(new File(excelPath));
        Sheet sheet = workbook.getSheetAt(0);

        // 2. 创建PDF文档
        PDDocument document = new PDDocument();
        PDPage page = new PDPage();
        document.addPage(page);
        PDPageContentStream contentStream = new PDPageContentStream(document, page);

        // 3. 遍历Excel行并写入PDF
        float yPosition = 750f; // 初始Y坐标
        for (Row row : sheet) {
            contentStream.beginText();
            contentStream.setFont(PDType1Font.HELVETICA, 12);
            contentStream.newLineAtOffset(50, yPosition);
            for (Cell cell : row) {
                String value = cell.toString();
                contentStream.showText(value + "  "); // 简单用空格分隔
            }
            contentStream.endText();
            yPosition -= 20; // 换行
        }

        contentStream.close();
        document.save(pdfPath);
        document.close();
        workbook.close();
    }
}

优化与进阶

样式处理

提取Excel单元格的样式（字体、边框、填充色），并在PDF中使用对应的绘图方法（如矩形、线段）模拟表格。

性能优化

对于大文件，建议使用流式处理（如SXSSFWorkbook读取Excel，PDFBox的PDPageContentStream写入PDF）以减少内存占用。

错误处理

添加异常捕获，处理文件不存在、格式错误、内存溢出等情况，并提供日志记录。

常见问题与解决方案

• 中文乱码：在PDF中使用支持中文的字体（如思源黑体），并通过PDType0Font加载。
• 表格对齐：计算PDF坐标，动态调整列宽和行高。
• 公式计算：确保Excel中的公式已计算（POI默认处理），或手动触发计算。

结论

通过Apache POI与PDF库的结合，开发者可以灵活实现Excel到PDF的转换。虽然基础实现简单，但针对生产环境需考虑样式保留、性能及错误处理。建议根据项目需求选择合适工具，并参考官方文档深入优化。