iText7中文教程：第一章 - 初识PDF文档构建基础

2025-06-05 12:38:12作者：宣利权Counsellor

前言：iText的起源与设计理念

在2000年初期，PDF文档的创建主要依赖于Adobe Illustrator等桌面应用程序，这种手动操作方式难以满足自动化批量生成PDF的需求。iText的诞生正是为了解决两大核心问题：

自动化生成需求：面对需要基于用户输入和数据库查询结果动态生成大量PDF文档的场景
开发友好性：降低PDF生成的技术门槛，让开发者无需深入理解PDF规范也能轻松使用

iText7延续了这一设计理念，通过提供高级抽象构建块，使开发者能够以更直观的方式创建PDF文档。

第一个iText7程序：Hello World

让我们从最基础的示例开始，了解iText7的核心组件：

PdfWriter writer = new PdfWriter(dest);
PdfDocument pdf = new PdfDocument(writer);
Document document = new Document(pdf);
document.add(new Paragraph("Hello World!"));
document.close();

代码解析

PdfWriter：负责将PDF内容写入指定路径或输出流
- 可接受文件路径字符串或各种输出流（如ServletOutputStream、ByteArrayOutputStream等）
PdfDocument：管理PDF文档结构和内容
- 跟踪页面和内容布局
- 处理PDF底层细节
Document：高级抽象层
- 提供开发者友好的API
- 隐藏PDF实现的复杂性
Paragraph：文本段落构建块
- 最基本的文本容器
- 支持样式和格式设置
关闭文档：完成PDF生成
- 必须显式关闭以确保资源释放和文件完整性

进阶示例：格式化文本与列表

让我们看一个更复杂的例子，展示如何设置字体和创建列表：

// 创建Times New Roman字体
PdfFont font = PdfFontFactory.createFont(FontConstants.TIMES_ROMAN);

// 添加标题段落
document.add(new Paragraph("iText功能特点:").setFont(font));

// 创建带项目符号的列表
List featureList = new List()
    .setSymbolIndent(12)  // 缩进12单位
    .setListSymbol("•")  // 使用圆点符号
    .setFont(font);

// 添加列表项
featureList.add(new ListItem("支持多种字体设置"))
    .add(new ListItem("灵活的段落布局"))
    .add(new ListItem("丰富的列表样式"))
    .add(new ListItem("强大的表格功能"))
    .add(new ListItem("完善的图像处理"));

document.add(featureList);

关键点说明

字体管理：
- 默认使用Helvetica字体
- 通过PdfFontFactory创建特定字体
- 支持设置字体样式（常规、加粗、斜体等）
列表控制：
- setSymbolIndent()控制项目符号缩进
- setListSymbol()自定义项目符号
- 支持有序列表和无序列表
链式调用：
- iText7 API设计支持方法链
- 使代码更简洁易读

图像处理：在PDF中嵌入图片

iText7提供了灵活的图片处理能力：

// 加载图片资源
Image logo = new Image(ImageDataFactory.create("logo.png"));
Image chart = new Image(ImageDataFactory.create("chart.png"));

// 创建图文混排段落
Paragraph content = new Paragraph("我们的产品")
    .add(logo)
    .add("性能表现如下：")
    .add(chart);

document.add(content);

图像处理要点

图像工厂：
- ImageDataFactory自动检测并处理多种图像格式
- 支持JPG、PNG、GIF、BMP等常见格式
图文混排：
- 图像可作为段落的一部分
- 自动处理文本环绕和布局
图像缩放：
- 支持按比例缩放
- 可设置固定尺寸

表格处理：展示结构化数据

表格是PDF文档中展示结构化数据的重要方式：

// 创建表格（定义列宽比例）
Table dataTable = new Table(new float[]{3, 1, 2, 2});

// 设置表格宽度为页面宽度100%
dataTable.setWidthPercent(100);

// 添加表头
dataTable.addHeaderCell(new Cell().add(new Paragraph("产品名称").setFont(boldFont)));
dataTable.addHeaderCell(new Cell().add(new Paragraph("库存").setFont(boldFont)));
dataTable.addHeaderCell(new Cell().add(new Paragraph("单价").setFont(boldFont)));
dataTable.addHeaderCell(new Cell().add(new Paragraph("总价").setFont(boldFont)));

// 添加数据行
for (Product product : productList) {
    dataTable.addCell(new Cell().add(new Paragraph(product.getName())));
    dataTable.addCell(new Cell().add(new Paragraph(String.valueOf(product.getStock()))));
    dataTable.addCell(new Cell().add(new Paragraph(product.getUnitPrice().toString())));
    dataTable.addCell(new Cell().add(new Paragraph(product.getTotalValue().toString())));
}

document.add(dataTable);

表格功能亮点

灵活列宽：
- 通过浮点数组定义列宽比例
- 支持百分比和绝对值设置
自动分页：
- 大型表格自动跨页
- 表头自动重复显示
单元格控制：
- 支持合并单元格
- 可设置边框样式和背景色

页面设置与布局控制

iText7提供了精细的页面控制能力：

// 创建横向A4页面
Document document = new Document(pdfDoc, PageSize.A4.rotate());

// 设置页边距（单位：点，1英寸=72点）
document.setMargins(36, 72, 36, 72); // 上、右、下、左

// 设置页面背景色
Rectangle background = new Rectangle(document.getPageEffectiveArea());
background.setBackgroundColor(new DeviceRgb(240, 240, 240));
document.add(new Div().setHeight(PageSize.A4.getHeight()).setBackground(background));