iTextPDF API帮助文档详解

在现代数字时代，PDF 文件已成人们共同使用的标准文件格式之一。PDF 文件的可靠性是必须保证的，并且我们需要确保在计算机或移动设备上能够正确显示和编辑 PDF 文件。iTextPDF API 帮助文档就是一个特别有用的工具来实现这一目标。

一、创建PDF文件

创建 PDF 文件是最常见的任务之一。iTextPDF 提供了多种方法来创建 PDF 文件，这些方式都依赖于应用程序的不同要求。下面我们就来看看如何使用 iTextPDF 创建 PDF 文件。

我们可以使用下面的代码片段创建一个 PDF 文件，并在其中添加一些元素：

// 创建一个新的 PDF Document
Document document = new Document();
 
// 添加一个 PDF 文件页面
PdfWriter.getInstance(document, new FileOutputStream("HelloWorld.pdf"));
document.open();
 
// 添加一段文本
document.add(new Paragraph("Hello World"));
 
// 关闭 document
document.close();

以上代码片段中，我们首先创建一个 Document 对象。Document 对象是 iTextPDF 的核心，它表示了我们将要生成的 PDF 文件。接着，我们使用 PdfWriter 以只写模式打开文件流，我们要写入的内容将写入到这里。PdfWriter.getInstance(document, new FileOutputStream(“HelloWorld.pdf”)) 这行代码会创建一个 PdfWriter 实例并将文档写入到 HelloWorld.pdf 文件中。

在创建完 Document 对象和 PdfWriter 对象后，我们可以通过 Document 对象的 open() 方法打开文档以开始添加内容。在这个例子中，我们使用了 Document 对象的 add() 方法向文档添加了“Hello World”文本。

最后，我们使用 Document 对象的 close() 方法关闭文档并完成文件的写入。我们现在可以使用我们收到的 HelloWorld.pdf 文件。

二、插入图像

添加图像是创建 PDF 文件的另一个常见任务。iTextPDF API 提供了多种方法来向 PDF 文件添加图像。我们可以使用以下代码片段来添加图像到 PDF 文件中：

// 创建一个新的 PDF Document
Document document = new Document();
 
// 添加一个 PDF 文件页面
PdfWriter.getInstance(document, new FileOutputStream("ImageExample.pdf"));
document.open();
 
// 添加图像
Image image = Image.getInstance("image.png");
document.add(image);
 
// 关闭 document
document.close();

以上代码片段中，我们使用 Image 对象来添加图像到 PDF 文件中。我们需要注意的一点是，我们必须提供图像文件的路径，确保它是当前工作目录下的一个有效路径。

Image 对象拥有多个构造函数，我们可以使用它们来对图像进行更多的操作。例如，我们可以设置图像的大小和旋转角度，如下所示：

// 创建一个 Image 实例
Image image = Image.getInstance("image_file_path");
 
// 旋转图像
image.setRotationDegrees(45);
 
// 设置图像宽度和高度
image.scaleAbsolute(300, 300);
 
// 添加图像到 Document 对象
document.add(image);

三、创建表格

创建表格是 iTextPDF API 中最常见的任务之一，特别是在处理文档生成时。iTextPDF 提供了 Table 类来实现这一功能，下面是一个基本的表格创建代码示例：

// 创建一个新的 PDF Document
Document document = new Document();
 
// 添加一个 PDF 文件页面
PdfWriter.getInstance(document, new FileOutputStream("TableExample.pdf"));
document.open();
 
// 创建一个 3 行 2 列的表格
Table table = new Table(2, 3);
table.addCell(new Cell(1, 2).add("Header"));
table.addCell("Col 1 Row 1");
table.addCell("Col 2 Row 1");
table.addCell("Col 1 Row 2");
table.addCell("Col 2 Row 2");
table.addCell("Col 1 Row 3");
 
// 添加表格到 Document 对象
document.add(table);
 
// 关闭 document
document.close();

以上示例中，我们创建了一个 3 行 2 列的表格并添加到了 PDF 文件中。在表格的第一行添加了一个列跨度为 2 的标题单元格，并在其他单元格中添加了文本。

我们可以使用 Table 方法的 addCell() 方法来动态添加单元格到表格对象中，也可以使用 setWidths() 方法来设置列宽度，如下所示：

// 定义列宽
float[] columnWidths = {1f, 1f, 1f};
Table table = new Table(columnWidths);
 
// 添加表头
Cell[] headerCells = new Cell[] {
 new Cell().add(new Paragraph("Header 1")),
 new Cell().add(new Paragraph("Header 2")),
 new Cell().add(new Paragraph("Header 3"))
};
 
for (Cell cell : headerCells) {
 table.addHeaderCell(cell);
}
 
// 添加数据行
Cell[] row1Cells = new Cell[] {
 new Cell().add(new Paragraph("1.1")),
 new Cell().add(new Paragraph("1.2")),
 new Cell().add(new Paragraph("1.3"))
};
 
for (Cell cell : row1Cells) {
 table.addCell(cell);
}
 
// 添加表格到 Document 对象
document.add(table);

以上代码示例中，我们首先定义了表格的列宽。在这个特定的例子中，每列的宽度是相等的。

接着，我们使用 addHeaderCell() 方法向表格对象添加表头，并使用 addCell() 方法向表格添加数据行。

最后，我们将表格添加到 PDF 文件中。