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 文件中。