iText 7 for Java: 创建和编辑 PDF 的完整指南

iText 7 是一个功能强大的开源 (AGPL) Java 库，用于以编程方式创建、操作和渲染 PDF 文档。它是广受欢迎的 iText 5 库的继承者，并提供了完全重新设计的模块化架构，专注于性能、灵活性和易用性。iText 7 使开发人员能够解决广泛的任务：从生成简单的发票和报告，到创建带有数字签名、表单和元数据的复杂、具有法律效力的文档。

为什么需要 iText 7？在当今世界，PDF 是用于交换文档的通用格式，可确保在任何设备上显示不变。手动创建 PDF 文件既耗时又低效，尤其是在处理大量数据时。iText 7 自动化了这一过程，为 Java 开发人员提供了对文档每个方面的完全控制：从添加文本和图像到创建交互式表单和管理访问权限。它在文档管理系统、电子商务、银行业务以及任何需要生成或处理 PDF 的应用程序中都是不可或缺的。

该库支持所有最新的 PDF 规范，包括 PDF 2.0。它还提供用于 HTML 转换 (pdfHTML)、光学字符识别 (pdfOCR)、创建 SVG (pdfSVG) 和图像处理 (pdfImage) 的附加模块 (add-ons)。需要注意的是，iText 7 采用双重许可：AGPL（要求公开您的应用程序源代码）和商业许可（用于专有用途）。

安装

要将 iText 7 安装到您的 Java 项目中，请使用 Maven 或 Gradle 构建系统。以下是将依赖项添加到 pom.xml 文件 (Maven) 的精确命令。

<!-- pom.xml -->\n<dependencies>\n    <!-- iText 7 核心模块 -->\n    <dependency>\n        <groupId>com.itextpdf</groupId>\n        <artifactId>itext7-core</artifactId>\n        <version>8.0.4</version> <!-- 请在 Maven Central 上查看最新版本 -->\n        <type>pom</type>\n    </dependency>\n</dependencies>

对于 Gradle (build.gradle)：

implementation 'com.itextpdf:itext7-core:8.0.4'

如果您只需要特定模块（例如 kernel、layout、io），您可以单独添加它们：

<dependency>\n    <groupId>com.itextpdf</groupId>\n    <artifactId>kernel</artifactId>\n    <version>8.0.4</version>\n</dependency>\n<dependency>\n    <groupId>com.itextpdf</groupId>\n    <artifactId>layout</artifactId>\n    <version>8.0.4</version>\n</dependency>

快速入门：最小工作示例

以下代码创建一个包含文本 "Hello, World!" 的简单 PDF 文档，并将其保存到文件 HelloWorld.pdf。

import com.itextpdf.kernel.pdf.PdfDocument;\nimport com.itextpdf.kernel.pdf.PdfWriter;\nimport com.itextpdf.layout.Document;\nimport com.itextpdf.layout.element.Paragraph;\n\nimport java.io.FileNotFoundException;\n\npublic class HelloWorld {\n    public static void main(String[] args) throws FileNotFoundException {\n        // 1. 创建 PdfWriter，它将数据写入文件\n        PdfWriter writer = new PdfWriter("HelloWorld.pdf");\n        \n        // 2. 创建 PdfDocument — 代表 PDF 文档本身的对象\n        PdfDocument pdf = new PdfDocument(writer);\n        \n        // 3. 创建 Document — 用于添加