### iText 手札知识点详解
#### 一、iText简介
iText 是一款非常流行的开源 Java 库，用于创建、操作 PDF 文件。它支持多种操作系统，并且可以在没有 Adobe Acrobat 的环境中工作。iText 提供了丰富的 API 来处理 PDF 文档的各种需求。
#### 二、创建基本的 PDF 文件
在文档开头部分给出了一个简单的例子，展示了如何使用 iText 创建一个带有表格的基本 PDF 文件：
```java
// 设置页面大小为 A4 并定义边距
Rectangle page = PageSize.A4;
Document doc = new Document(page, 30f, 30f, 30f, 30f);
// 通过指定文件路径创建 PDF 输出流
PdfWriter.getInstance(doc, new FileOutputStream("H:/work/cfi/JavaSource/aacmm/pm/query/engMonthlyRep.pdf"));
// 添加表格
doc.add(table_all);
// 流方式输出 PDF
ByteArrayOutputStream buffer = new ByteArrayOutputStream();
PdfWriter writer = PdfWriter.getInstance(doc, buffer);
doc.open();
doc.add(table_all);
doc.close();
```
这段代码首先定义了一个 A4 大小的页面，并设置了页面的边距。接着，通过 `FileOutputStream` 指定输出文件路径来创建 PDF。另外一种方式是使用 `ByteArrayOutputStream` 将 PDF 内容写入字节数组，这种方式适用于网络传输等场景。
#### 三、表格操作
iText 提供了强大的表格功能，可以轻松创建和管理复杂的表格数据。
```java
doc.open();
PdfPTable table = new PdfPTable(5); // 创建 5 列的表格
table.setWidthPercentage(100f); // 设置表格宽度占页面宽度的百分比
PdfPCell cell = new PdfPCell(new Paragraph("基本信息", PDFUtil.FontGB(13)));
cell.setColspan(5); // 单元格跨越 5 列
cell.setBorder(0); // 设置边框为 0
cell.setMinimumHeight(20f); // 设置最小高度
table.addCell(cell);
doc.add(table);
doc.close();
```
这里创建了一个 5 列的表格，并添加了一个标题单元格。`PdfPTable` 类提供了丰富的属性设置方法，如 `setWidthPercentage()` 用来设置表格的宽度比例，`setColspan()` 用来设置单元格跨过的列数。
#### 四、图片处理
iText 还支持在 PDF 文件中添加图片，并提供了多种方式进行图片处理。
```java
Document document = new Document();
PdfWriter.getInstance(document, new FileOutputStream("imagesPDF.pdf"));
document.open();
Image image = Image.getInstance("devi.jpg");
document.add(new Paragraph("Roseindia"));
document.add(image);
document.close();
```
此例中，通过 `Image.getInstance()` 方法加载图片，并将其添加到 PDF 文档中。此外，还可以对图片进行调整尺寸、添加超链接、设置绝对位置等多种操作。
#### 五、文本处理
iText 支持各种文本处理功能，包括添加普通文本、块文本、垂直文本等。
- **块文本**：可以使用 `Paragraph` 类添加段落或块文本。
- **文字背景**：可以为文本设置背景颜色。
- **垂直文本**：通过调整 `PdfContentByte` 对象中的坐标系实现。
- **多行文字**：使用 `List` 或 `ListBullet` 类添加多行文字。
#### 六、其他高级功能
- **章节管理**：通过 `Chapter` 和 `Section` 类可以创建有层次结构的文档。
- **超链接**：可以添加内部和外部超链接。
- **JavaScript**：可以在 PDF 中嵌入 JavaScript 代码来增加交互性。
- **条形码和二维码**：支持多种条形码和二维码类型。
- **页面事件**：可以注册页面事件处理器来响应文档打开、关闭等事件。
- **模板使用**：支持使用模板来快速创建 PDF。
- **图层管理**：可以为文档的不同部分分配不同的图层。
以上仅是 iText 功能的一部分概述，更多细节和高级用法还需深入研究其官方文档和示例代码。
