当前位置：首页 > 文章列表 > 文章 > java教程 > JavaPDF操作教程：iText库使用全解析

JavaPDF操作教程：iText库使用全解析

2025-08-02 16:30:47 0浏览收藏

在Java项目中，操作PDF文件是一项常见的需求，例如生成发票、报告或处理表单数据。本文将详细介绍如何利用强大的Java库iText来实现PDF文件的创建、读取和修改等常用操作。首先，我们将介绍如何在Maven项目中添加iText依赖，并讲解如何创建一个简单的PDF文档，包括写入文字内容。接着，我们将探讨如何使用iText提取现有PDF文件中的文本内容，尤其适用于有文本层的PDF文件。最后，我们将学习如何修改现有PDF，例如添加水印，通过Canvas在每页绘制透明文字，并可自定义样式与旋转角度。通过本教程，您将能够掌握iText库的基本使用方法，为您的Java项目提供强大的PDF处理能力。

本文介绍了使用iText在Java中操作PDF文件的常用方法。1. 添加iText依赖：Maven项目可在pom.xml中引入itext7-core模块，根据需要还可添加其他模块。2. 创建PDF文档：通过PdfWriter和Document类创建空白文档并添加段落内容。3. 读取PDF文本：使用PdfReader和PdfTextExtractor提取页面文字，适用于有文本层的PDF文件。4. 修改现有PDF：如添加水印，可通过Canvas在每页绘制透明文字，并可设置样式与旋转角度。

怎样用Java操作PDF文件？iText库使用教程

操作PDF文件在很多Java项目中是常见的需求，比如生成发票、报告或者处理表单数据。iText 是一个非常流行的 Java 库，可以用来创建、读取和修改 PDF 文件。本文就来聊聊如何用 iText 来实现一些常用的操作。

添加iText依赖

要使用 iText，首先要把它引入你的项目中。如果你用的是 Maven 项目，可以在 pom.xml 中添加如下依赖：


    com.itextpdf
    itext7-core
    7.1.15

注意版本号可能会更新，建议查看官网或仓库确认最新版本。Gradle 用户可以用类似方式添加依赖。

另外，iText 从 7 版本开始分成了多个模块，如果你需要处理 PDF 表单或加密功能，可能还需要额外引入对应的模块。

创建一个简单的PDF文档

这是最基础的用法：创建一个空白 PDF 并写入一些文字。下面是核心代码示例：

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

public class CreatePdf {
    public static void main(String[] args) throws Exception {
        PdfWriter writer = new PdfWriter("hello.pdf");
        Document document = new Document(writer);
        document.add(new Paragraph("Hello, iText!"));
        document.close();
    }
}

上面这段代码做了几件事：

创建了一个 PdfWriter 实例，指向输出文件路径。
使用这个 writer 构建了一个 Document 对象。
向文档中添加了一个段落。
最后关闭了文档以确保内容写入磁盘。

这只是一个起点，你可以在这个基础上加图片、表格、样式等。

读取并提取PDF文本内容

有时候你不需要创建 PDF，而是想从已有 PDF 中提取文字内容。这时候可以用 iText 的 PdfReader 和 LocationTextExtractionStrategy：

import com.itextpdf.kernel.pdf.PdfReader;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.canvas.parser.PdfTextExtractor;

public class ReadPdf {
    public static void main(String[] args) throws Exception {
        PdfReader reader = new PdfReader("hello.pdf");
        PdfDocument pdfDoc = new PdfDocument(reader);
        int pages = pdfDoc.getNumberOfPages();

        for (int i = 1; i <= pages; i++) {
            String text = PdfTextExtractor.getTextFromPage(pdfDoc.getPage(i));
            System.out.println(text);
        }

        pdfDoc.close();
        reader.close();
    }
}

几点说明：

getTextFromPage() 返回的是页面上的所有文本内容。
如果你处理的是扫描件或图片转 PDF 的内容，这种方式可能无法提取文字，因为没有嵌入文本层。
提取出来的内容格式可能不太整齐，需要后续清洗。

修改现有PDF（例如添加水印）

修改 PDF 是比较高级的功能。比如，我们可以给每一页加上一个水印文字。主要思路是打开一个已有 PDF，在每页上绘制透明文字：

import com.itextpdf.kernel.pdf.*;
import com.itextpdf.layout.Canvas;
import com.itextpdf.layout.element.Paragraph;
import com.itextpdf.kernel.colors.ColorConstants;
import com.itextpdf.kernel.geom.PageSize;

public class AddWatermark {
    public static void main(String[] args) throws Exception {
        PdfReader reader = new PdfReader("input.pdf");
        PdfWriter writer = new PdfWriter("output_with_watermark.pdf");
        PdfDocument pdfDoc = new PdfDocument(reader, writer);

        int pageCount = pdfDoc.getNumberOfPages();
        for (int i = 1; i <= pageCount; i++) {
            PdfPage page = pdfDoc.getPage(i);
            PageSize pageSize = page.getPageSize();
            Canvas canvas = new Canvas(page, pageSize);
            canvas.setFontColor(ColorConstants.LIGHT_GRAY)
                  .setFontSize(60)
                  .showTextAligned("CONFIDENTIAL", pageSize.getWidth() / 2, pageSize.getHeight() / 2, i,
                          com.itextpdf.layout.property.TextAlignment.CENTER,
                          com.itextpdf.layout.property.VerticalAlignment.MIDDLE,
                          45); // 旋转角度
            canvas.close();
        }

        pdfDoc.close();
    }
}

关键点包括：