怎样用Java操作PDF文件？iText库使用教程-java教程-PHP中文网

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

蓮花仙者

发布： 2025-07-07 17:14:02

原创

648人浏览过

本文介绍了使用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 中添加如下依赖：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext7-core</artifactId>
    <version>7.1.15</version>
</dependency>

登录后复制

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

立即学习“Java免费学习笔记（深入）”；

另外，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();
    }
}

登录后复制

关键点包括：