Java实现Word文档转PDF:完整方案与代码示例

概述

在企业级Java应用中,经常需要将Word文档(.doc或.docx)转换为PDF格式,以便于分发、归档或打印。本文将介绍几种常见的实现方式,并分析各自的优缺点。

方法一:Apache POI + iText

Apache POI可用于读取Word文档内容,iText用于生成PDF。此方法适合简单文本和表格,对复杂布局支持较差。

Maven依赖

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext7-core</artifactId>
    <version>7.2.5</version>
</dependency>

代码示例

import org.apache.poi.xwpf.usermodel.*;
import com.itextpdf.kernel.pdf.*;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;

import java.io.*;

public class WordToPdfWithPOI {
    public static void main(String[] args) throws Exception {
        String wordPath = "input.docx";
        String pdfPath = "output.pdf";
        
        // 读取Word文档
        XWPFDocument doc = new XWPFDocument(new FileInputStream(wordPath));
        PdfWriter writer = new PdfWriter(new FileOutputStream(pdfPath));
        PdfDocument pdfDoc = new PdfDocument(writer);
        Document pdfDocument = new Document(pdfDoc);
        
        // 遍历段落
        for (XWPFParagraph para : doc.getParagraphs()) {
            pdfDocument.add(new Paragraph(para.getText()));
        }
        // 遍历表格(简化处理)
        for (XWPFTable table : doc.getTables()) {
            // 此处省略表格转换逻辑
        }
        pdfDocument.close();
        doc.close();
    }
}

缺点:格式丢失严重,图片、样式等无法保留。

方法二:LibreOffice命令行转换(推荐)

利用LibreOffice的headless模式,通过Java调用命令行实现高质量转换。

前提条件

  • 安装LibreOffice并配置环境变量
  • Java Runtime.exec()执行命令

代码示例

import java.io.*;

public class WordToPdfWithLibreOffice {
    public static void main(String[] args) throws Exception {
        String inputPath = "/path/to/input.docx";
        String outputDir = "/path/to/output/";
        
        ProcessBuilder pb = new ProcessBuilder(
            "soffice", "--headless", "--convert-to", "pdf",
            "--outdir", outputDir, inputPath
        );
        Process process = pb.start();
        int exitCode = process.waitFor();
        if (exitCode == 0) {
            System.out.println("转换成功!");
        } else {
            System.out.println("转换失败");
        }
    }
}

优点:支持复杂格式,保真度高,免费开源。

方法三:Aspose.Words(商业方案)

Aspose.Words for Java提供API直接转换,无需安装其他软件。

Maven依赖

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-words</artifactId>
    <version>24.1</version>
</dependency>

代码示例

import com.aspose.words.*;

public class WordToPdfWithAspose {
    public static void main(String[] args) throws Exception {
        Document doc = new Document("input.docx");
        doc.save("output.pdf", SaveFormat.PDF);
    }
}

优点:API简洁,转换质量高。缺点:需要付费授权。

总结

根据项目需求选择合适方案:

  • 简单文本:Apache POI + iText
  • 高保真且免费:LibreOffice命令行
  • 商业环境且预算充足:Aspose.Words
注意LibreOffice方案在多线程环境下建议使用连接池管理进程。