iText7中文教程：第六章 - 重用现有PDF文档的高级操作技巧

iText7中文教程：第六章 - 重用现有PDF文档的高级操作技巧

itext7-in-mandarin iText7文档的汉化版本 项目地址: https://gitcode.com/gh_mirrors/it/itext7-in-mandarin

前言

在PDF文档处理过程中，经常需要对现有PDF进行二次加工。本章将深入探讨iText7中重用现有PDF文档的高级技巧，包括页面缩放、平铺、合并以及表单处理等核心功能。这些技术在实际业务场景中有着广泛应用，如报表生成、合同合并、表单处理等。

一、PDF页面缩放技术

1.1 基础缩放原理

PDF页面缩放是通过坐标变换实现的数学操作。iText7提供了AffineTransform类来处理缩放变换，其核心是计算源页面与目标页面的尺寸比例。

AffineTransform transformationMatrix = AffineTransform.getScaleInstance(
    targetWidth / sourceWidth,
    targetHeight / sourceHeight);

1.2 实际应用示例

假设我们有一个16.54×11.69英寸的PDF页面，需要实现三种缩放效果：

1. 缩小版：A4横向(11.69×8.26英寸)
2. 原尺寸：保持原始大小
3. 放大版：A2横向(23.39×16.53英寸)

关键技术点：

• 使用copyAsFormXObject创建页面副本
• 通过concatMatrix应用变换矩阵
• 使用addXObject将变换后的内容添加到新页面

二、PDF页面平铺技术

2.1 平铺概念解析

平铺(Tiling)是将单个PDF页面分割显示在多个页面上的技术。例如，将A3页面平铺到4个A4页面上，每个A4页面显示原A3页面的四分之一内容。

2.2 实现步骤

1. 计算平铺比例因子
2. 确定每个平铺块的偏移量
3. 创建多个目标页面
4. 将源页面内容按偏移量添加到各目标页面

关键代码片段：

// 计算变换矩阵
AffineTransform transformationMatrix = AffineTransform.getScaleInstance(
    tileSize.getWidth() / orig.getWidth() * 2f,
    tileSize.getHeight() / orig.getHeight() * 2f);

// 添加不同偏移量的平铺块
canvas.addXObject(pageCopy, 0, -orig.getHeight() / 2f);  // 第一块
canvas.addXObject(pageCopy, -orig.getWidth() / 2f, -orig.getHeight() / 2f); // 第二块

三、N-up页面布局技术

3.1 N-up概念

N-up是平铺的逆向操作，将多个页面内容合并显示在单个页面上。常见应用包括将4页A5内容合并到1页A4上。

3.2 实现要点

1. 计算每个子页面的缩放比例
2. 确定各子页面在目标页面上的位置
3. 应用变换并添加内容

示例代码：

// 计算缩放比例(将4页放在1页上)
AffineTransform transformationMatrix = AffineTransform.getScaleInstance(
    nUpPageSize.getWidth() / orig.getWidth() / 2f,
    nUpPageSize.getHeight() / orig.getHeight() / 2f);

// 在四个位置添加内容
canvas.addXObject(pageCopy, 0, orig.getHeight()); // 左上
canvas.addXObject(pageCopy, orig.getWidth(), orig.getHeight()); // 右上
canvas.addXObject(pageCopy, 0, 0); // 左下
canvas.addXObject(pageCopy, orig.getWidth(), 0); // 右下

四、PDF文档合并技术

4.1 简单合并

使用PdfMerger类可以轻松合并多个PDF：

PdfMerger merger = new PdfMerger(pdf);
merger.merge(sourcePdf1, 1, sourcePdf1.getNumberOfPages());
merger.merge(sourcePdf2, 1, sourcePdf2.getNumberOfPages());

4.2 选择性合并

可以只合并特定页面：

merger.merge(sourcePdf1, Arrays.asList(1, 5, 7)); // 合并第1,5,7页

4.3 高级合并示例

创建带目录(TOC)的合并文档：

1. 创建命名目的地(Named Destinations)
2. 添加目录条目
3. 设置跳转动作

关键技术：

// 创建命名目的地
pdfDoc.addNameDestination("p1", new PdfArray()
    .add(page.getPdfObject())
    .add(PdfName.XYZ)
    .add(new PdfNumber(0))
    .add(new PdfNumber(page.getMediaBox().getHeight()))
    .add(new PdfNumber(1)));

// 添加带跳转动作的目录项
Paragraph p = new Paragraph("Chapter 1");
p.setProperty(Property.ACTION, PdfAction.createGoTo("p1"));

五、PDF表单合并技术

5.1 表单合并的特殊性

PDF表单与普通PDF不同，一个PDF文档只能包含一个表单。合并多个表单时需要特殊处理。

5.2 表单合并实现

使用PdfPageFormCopier确保表单字段正确合并：

sourcePdf.copyPagesTo(1, sourcePdf.getNumberOfPages(), 
    destPdf, new PdfPageFormCopier());

5.3 表单字段重命名

合并相同表单时，必须重命名字段以避免冲突：

PdfAcroForm form = PdfAcroForm.getAcroForm(sourcePdf, true);
form.renameField("name", "name_" + i); // 为每个副本添加唯一后缀

六、最佳实践与注意事项

1. 资源管理：始终记得关闭PdfDocument对象，避免内存泄漏
2. 坐标系统：PDF坐标系原点在左下角，Y轴向上
3. 表单处理：合并表单时要特别注意字段命名唯一性
4. 性能考虑：处理大文档时考虑内存使用，可分批处理

结语

本章详细介绍了iText7中重用现有PDF文档的各种高级技术。掌握这些技术可以满足实际业务中复杂的PDF处理需求，如生成报告、合并合同、处理表单等。建议读者通过实际项目练习这些技术，以深入理解其应用场景和实现细节。

itext7-in-mandarin iText7文档的汉化版本 项目地址: https://gitcode.com/gh_mirrors/it/itext7-in-mandarin