Java PDF操作指南：iText与PDFBox实战对比

1. Java操作PDF的常见场景与工具选型

PDF作为跨平台文档格式，在企业级应用中有着广泛的使用场景。Java开发者经常需要处理PDF文档的生成、编辑和内容提取等需求。从发票生成、报表导出到合同签署，PDF操作几乎成为Java后台开发的标配技能。

目前主流的Java PDF操作库主要有以下几个：

• iText ：功能最全面的开源库，支持PDF生成、编辑、加密等全套操作，AGPL/commercial双协议
• Apache PDFBox ：Apache旗下的开源项目，专注PDF内容提取和基础操作
• OpenPDF ：iText分支版本，LGPL协议更友好
• Flying Saucer ：适合HTML转PDF场景
• JasperReports ：报表工具内置PDF导出功能

对于数据写入场景，iText和PDFBox是最常用的选择。iText在生成复杂PDF时更具优势，而PDFBox在已有PDF修改方面更轻量。我们以iText 7为例进行演示，这是目前最新的商业友好版本。

2. 基础环境准备与依赖配置

2.1 Maven依赖配置

使用iText 7需要添加以下依赖到pom.xml：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext7-core</artifactId>
    <version>7.2.5</version>
    <type>pom</type>
</dependency>

如果需要处理中文等亚洲字符，还需添加额外的字体模块：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>font-asian</artifactId>
    <version>7.2.5</version>
</dependency>

2.2 字体资源准备

处理中文内容时，必须明确指定支持中文的字体。推荐将字体文件(.ttf)放在resources/fonts目录下。常用开源字体如：

• 思源黑体(Source Han Sans)
• 阿里巴巴普惠体
• 文泉驿系列字体

注意：直接使用系统字体可能导致部署环境缺少对应字体而出错，建议将字体文件随项目一起打包。

3. 基础文本写入实现

3.1 创建PDF文档基础框架

以下是创建PDF并写入文本的最小实现：

import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;

public class BasicPdfWriter {
    public static void main(String[] args) throws Exception {
        // 1. 创建PdfWriter指向输出文件
        PdfWriter writer = new PdfWriter("output.pdf");
        
        // 2. 创建PdfDocument对象
        PdfDocument pdf = new PdfDocument(writer);
        
        // 3. 创建Document对象用于添加内容
        Document document = new Document(pdf);
        
        // 4. 添加段落内容
        document.add(new Paragraph("Hello PDF World!"));
        
        // 5. 关闭文档
        document.close();
    }
}

3.2 中文内容处理

处理中文需要特别注意字体设置：

// 加载字体(假设resources/fonts下有SourceHanSans.ttf)
PdfFont font = PdfFontFactory.createFont(