从 Java 应用程序动态生成 PDF 文件(2)

还有什么能比您亲自创建的一个有效样例能更好地演示任何技术呢？现在您已拥有所需的工具 (Eclipse IDE) 和库 (iText library)，我们已准备好设计和开发一个有效的样例程序。

首先创建一个简单的 PDF 文档，该文档包含一些基本元素，比如纯文本、具有非默认字体的彩色文本、表格、列表、章、节等。此应用程序的用途是让您熟悉使用 iText 库的方式。有许多类为您执行了与 PDF 文档生成相关的大量工作。本文不可能介绍所有这些类。iText 的 Javadocs 是有关如何使用这些类的一个不错的信息来源。接下来我们开始编码。

第一步是创建一个文档。文档是一个 PDF 文档的所有元素的容器。

清单 1. 实例化文档对象

Document document = new Document(PageSize.A4, 50, 50, 50, 50);  

第一个参数是页面大小。接下来的几个参数分别是左边距、右边距、上边距和下边距。此文档的类型还未定义。它依赖于您创建的编写器类型。对于我们的样例，我们选择 com.itextpdf.text.pdf.PdfWriter。其他编写器包括 HtmlWriter、RtfWriter、XmlWriter 等。它们的名称说明了它们的实际用途。

清单 2. 创建 PdfWriter 对象

PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream("C:\\ITextTest.pdf")); document.open();  

第一个参数是文档对象的引用，第二个参数是输出将写入的文件的绝对名称。接下来，我们打开文档开始编写。

现在，我们将在文档的第一页上添加一些文本。任何文本都借助 com.itextpdf.text.Paragraph 来进行添加。您可使用您的文本以及字体、颜色、字号等默认设置创建一个默认段落。否则，您可提供自己的字体。在本文中，我们还将讨论 PDF 文档的定位符（链接）。在此 PDF 中，我们使用 backToTop 作为链接。当单击 backToTop 链接时，它会将您带到文档的第一页。您需要将该文本设置为第一页的定位目标。让我们看看如何将定位目标和字体设置到所添加的段落中。

清单 3. 创建段落对象

Anchor anchorTarget = new Anchor("First page of the document."); anchorTarget.setName("BackToTop"); Paragraph paragraph1 = new Paragraph(); paragraph1.setSpacingBefore(50); paragraph1.add(anchorTarget); document.add(paragraph1); document.add(new Paragraph("Some more text on the first page with different color and font type.", FontFactory.getFont(FontFactory.COURIER, 14, Font.BOLD, new CMYKColor(0, 255, 0, 0))));  

图 1 显示了 清单 3 中的代码的样例输出。要关闭文档，将 document.close(); 添加到清单 3 中的代码末尾。

图 1. 清单 3 中的代码的样例输出

您刚才看到了如何将纯文本添加到 PDF 文档中。接下来，我们需要向文档中添加一些复杂的元素。首先创建一个新章。章是一种特殊的节，它从一个新页开始且默认会显示一个编号。

清单 4. 创建章对象

Paragraph title1 = new Paragraph("Chapter 1", FontFactory.getFont(FontFactory.HELVETICA, 18, Font.BOLDITALIC, new CMYKColor(0, 255, 255,17))); Chapter chapter1 = new Chapter(title1, 1); chapter1.setNumberDepth(0);  

在 清单 4 中的代码中，我们创建了一个新的章对象 chapter1，它的标题为 “This is Chapter 1”。将编号深度设置为 0，这样就不会在页面上显示章编号。

节是章的子元素。在 清单 5 中的代码中，我们创建一个标题为 “This is Section 1 in Chapter 1” 的节。要在此节下添加一些文本，我们创建了另一个段落对象 someSectionText，并将它添加到节对象中。

清单 5. 创建节对象

Paragraph title11 = new Paragraph("This is Section 1 in Chapter 1", FontFactory.getFont(FontFactory.HELVETICA, 16, Font.BOLD, new CMYKColor(0, 255, 255,17))); Section section1 = chapter1.addSection(title11); Paragraph someSectionText = new Paragraph("This text comes as part of section 1 of chapter 1."); section1.add(someSectionText); someSectionText = new Paragraph("Following is a 3 X 2 table."); section1.add(someSectionText);  

在添加表格之前，让我们看看该文档的外观。添加以下两行代码以关闭 图 2 中的文档。然后编译和执行程序，以生成 PDF 文档：document.add(chapter1);document.close();。

图 2. 章的样例输出

接下来，我们创建一个表格对象。一个表格包含一个行和列的矩阵。一行中的一个单元格可占据多于一列。类似地，一列中的一个单元格可占据多于一行。

清单 6. 创建表格对象

PdfPTable t = new PdfPTable(3); t.setSpacingBefore(25); t.setSpacingAfter(25); PdfPCell c1 = new PdfPCell(new Phrase("Header1")); t.addCell(c1); PdfPCell c2 = new PdfPCell(new Phrase("Header2")); t.addCell(c2); PdfPCell c3 = new PdfPCell(new Phrase("Header3")); t.addCell(c3); t.addCell("1.1"); t.addCell("1.2"); t.addCell("1.3"); section1.add(t);  

在 清单 6 中的代码中，我们创建了一个 PDFPTable 对象 t，它包含 3 列且在不断地添加行。接下来，我们创建 3 个 PDFPcell 对象，每个对象包含不同的文本。我们不断地将它们添加到表格中。它们会添加到第一行中，从第一列开始，移动到同一行中的下一列。该行完成后，将下一个单元格添加到下一行的第一列中。也可通过提供单元格的文本来将它添加到表格中，比如 t.addCell("1.1");。最后，将表格对象添加到节对象中。

最后，让我们看看如何将一个列表添加到 PDF 文档中。列表包含多个 ListItem。一个列表可带有编号，也可不带编号。将第一个参数作为 true 传送，表明您希望创建带编号的列表。

清单 7. 创建列表对象

List l = new List(true, false, 10); l.add(new ListItem("First item of list")); l.add(new ListItem("Second item of list")); section1.add(l);  

我们已将所有内容都添加到 chapter1 对象中。现在我们将一个图像添加到该 Java 对象中。我们可使用以下一个 Image 方法缩放图像：

scaleAbsolute()

scaleAbsoluteWidth()

scaleAbsoluteHeight()

scalePercentage()

scaleToFit()

在 清单 8 中，我们使用了 scaleAbsolute。然后将图像对象添加到 Section 中。

清单 8. 将 Image 添加到主 Document 中

Image image2 = Image.getInstance("IBMLogo.bmp"); image2.scaleAbsolute(120f, 120f); section1.add(image2);  

iText 中的 com.itextpdf.text.Anchor 类表示一个外部网站或文档内部的一个链接。定位符（链接）可像网页中的一个链接一样单击。要添加定位符，我们需要创建一个新定位符并将引用设置为 清单 3 中创建的 Anchor 目标。然后将定位符添加到节中，并将该节添加到文档中。

清单 9. 将定位符添加到主文档中

Paragraph title2 = new Paragraph("Using Anchor", FontFactory.getFont(FontFactory.HELVETICA, 16, Font.BOLD, new CMYKColor(0, 255, 0, 0))); section1.add(title2); title2.setSpacingBefore(5000); Anchor anchor2 = new Anchor("Back To Top"); anchor2.setReference("#BackToTop"); section1.add(anchor2);  

没有需要添加到 chapter1 中的元素后，就该是将 chapter1 添加到主 document 中的时候了。在这里，当我们完成样例应用程序后，也将关闭文档对象。

清单 10. 将一章添加到主文档中

document.add(chapter1); document.close();