本文介绍了使用itext在java中操作pdf文件的常用方法。1. 添加itext依赖：maven项目可在pom.xml中引入itext7-core模块，根据需要还可添加其他模块。2. 创建pdf文档：通过pdfwriter和document类创建空白文档并添加段落内容。3. 读取pdf文本：使用pdfreader和pdftextextractor提取页面文字，适用于有文本层的pdf文件。4. 修改现有pdf：如添加水印，可通过canvas在每页绘制透明文字，并可设置样式与旋转角度。
操作PDF文件在很多Java项目中是常见的需求，比如生成发票、报告或者处理表单数据。iText 是一个非常流行的 Java 库，可以用来创建、读取和修改 PDF 文件。本文就来聊聊如何用 iText 来实现一些常用的操作。
添加iText依赖
要使用 iText，首先要把它引入你的项目中。如果你用的是 Maven 项目，可以在 pom.xml 中添加如下依赖：
com.itextpdf itext7-core 7.1.15
注意版本号可能会更新，建议查看官网或仓库确认最新版本。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();
}
}关键点包括：
- 使用
Canvas在页面上绘图。 - 设置字体颜色为浅灰色，避免遮挡原有内容。
- 设置旋转角度让水印倾斜显示。
这种方式还可以用来添加页码、签名、边框等内容。
基本上就这些。iText 功能强大但细节多，初学者可以从创建简单文档开始，逐步掌握更复杂的功能。实际开发中遇到问题时，记得查阅官方文档或社区资源。
