许多应用程序要求动态生成PDF文档。 这样的应用程序范围很广,从银行生成用于发送电子邮件的客户对账单,到购买特定书籍章节并以PDF格式接收它们的读者。 列表是无止境的。 在本文中,我们将使用iText Java库来生成PDF文档。 我们将带您看一个示例应用程序,以便您自己动手并更好地理解它。
学到更多。 开发更多。 连接更多。
新的developerWorks Premium会员计划通过Safari Books Online提供了无障碍访问强大的开发工具和资源的权利,其中包括500个顶级技术标题(数十个专门针对开源开发人员),主要开发人员活动的大幅折扣,最近O'的视频回放Reilly会议,等等。 立即注册 。
iText是可从http://itextpdf.com免费获得的Java库。 iText库功能强大,除了生成PDF之外,还支持HTML,RTF和XML文档的生成。 您可以从文档中使用的各种字体中进行选择。 另外,iText的结构允许您使用相同的代码生成任何上述类型的文档。
iText库包含用于生成各种字体的PDF文本,在PDF文档中生成表格,向页面添加水印等的类。 iText提供了更多功能。 不可能在一篇文章中演示所有这些内容。 我们将介绍PDF生成所需的基本知识。 有关更多详细信息,请参阅供应商提供的文档。
我们将使用Eclipse来开发示例应用程序。 作为开放源代码的IDE,Eclipse是免费提供的并且功能强大。 您可以立即下载Eclipse。
com.itextpdf.text.Document是生成PDF文档的主要类。 这是要实例化的第一类。 创建文档后,您需要编写者才能写入文档。 com.itextpdf.text.pdf.PdfWriter是PDF编写器。 下面列出了一些其他常用的类:
com.itextpdf.text.Paragraph-此类表示缩进的段落。 com.itextpdf.text.Chapter — 此类表示PDF文档中的一章。 它是使用“ Paragraph作为标题并使用“ int作为章号创建的。 com.itextpdf.text.Font-此类包含字体的所有规范,例如字体系列,大小,样式和颜色。 在此类中,各种字体都声明为静态常量。 com.itextpdf.text.List-此类表示一个列表,该列表又包含多个ListItems 。 com.itextpdf.text.pdf.PDFPTable-这是一个表,可以放在绝对位置,也可以作为类Table添加到文档中。 com.itextpdf.text.Anchor-锚可以是参考,也可以是参考的目标。作为纯Java库,iText以JAR文件的形式出现。 下载该库后(假设位于路径C:\ temp),以下步骤将在Eclipse环境中配置iText库:
在Eclipse中创建一个名为iText的新Java项目。 在Package Explorer视图中右键单击iText项目,然后选择Properties 。 单击Java构建路径 。 在“库”选项卡上,单击“ 添加外部JAR” 。 浏览到C:\ temp目录,然后在此目录中选择itext-5.3.0.jar。 单击确定 。现在已配置了iText,并且Eclipse准备创建Java应用程序以生成动态PDF文档。
有什么比您自己动手制作的工作样本更好地展示任何技术的呢? 现在,您已经拥有必需的工具(Eclipse IDE)和库(iText库),我们都可以设计和开发示例运行程序。
让我们创建一个简单的PDF文档,其中包含一些基本元素,例如纯文本,带有非默认字体的彩色文本,表格,列表,章节,节等。此应用程序的目的是使您熟悉使用iText库的方式。 有很多类可以为您做很多与PDF文档生成相关的工作。 不可能涵盖所有这些课程。 iText的javadocs是有关如何使用这些类的很好的信息来源。 让我们开始编码。
第一步是创建一个文档。 文档是PDF文档所有元素的容器。
第一个参数是页面大小。 接下来的参数分别是左,右,上和下页边距。 该文档的类型尚未定义。 这取决于您创建的编写器的类型。 对于我们的示例,我们选择com.itextpdf.text.pdf.PdfWriter。 其他作家是HtmlWriter,RtfWriter,XmlWriter以及其他一些作家。 他们的名字充分说明了他们的目的。
第一个参数是对文档对象的引用,第二个参数是将在其中写入输出的文件的绝对名称。 接下来,我们打开文档进行编写。
现在,我们将在文档的第一页上添加一些文本。 借助com.itextpdf.text.Paragraph可以添加任何文本。 您可以使用文本以及字体,颜色,大小等的默认设置来创建默认段落。 否则,您可以提供自己的字体。 在本文中,我们还将讨论锚定(链接)到PDF文档。 在此PDF中,我们使用backToTop作为链接。 当您单击backToTop链接时,它将带您到文档的第一页。 您需要将文本设置为首页的定位目标。 让我们看看如何设置锚定目标并将字体设置为添加的段落。
图1显示了清单3中的代码示例输出。 要关闭文档,请添加document.close(); 清单3中的代码末尾。
您刚刚看到了如何在PDF文档中添加纯文本。 接下来,我们需要在文档中添加一些复杂的元素。 让我们从创建一个新的章节开始。 章节是一个特殊部分,从新页面开始,默认情况下显示数字。
在清单4的代码中,我们创建了一个新的章对象chapter1 ,标题为“ This is Chapter 1”。 将编号深度设置为0将不会在页面上显示章节编号。
节是章节的子元素。 在清单5的代码中,我们创建了一个标题为“这是第1章的第1节”的部分。 要在此部分下添加一些文本,我们创建另一个段落对象someSectionText ,并将其添加到该部分对象中。
在添加表之前,让我们看一下文档的外观。 添加以下两行以关闭图2中的文档。 然后编译并执行程序以生成PDF文档: document.add(chapter1);document.close(); 。
接下来,我们创建一个表对象。 表格包含行和列的矩阵。 一行中的一个单元格可以跨越多于一列。 同样,一列中的一个单元格可以跨越多于一行。
在清单6的代码中,我们创建了一个具有三列的PDFPTable对象t ,并继续添加行。 接下来,我们创建三个具有不同文本的PDFPcell对象。 我们继续将它们添加到表中。 它们将从第一列开始添加到第一行,然后移至同一行的下一列。 该行完成后,下一个单元格将添加到下一行的第一列。 只需提供单元格的文本,例如t.addCell("1.1");也可以将单元格添加到表中t.addCell("1.1"); 。 最后,将表对象添加到节对象。
最后,让我们看看如何将列表添加到PDF文档。 列表包含许多ListItem 。 列表可以编号或不编号。 将第一个参数传递为true意味着您要创建编号列表。
我们已经将所有内容添加到了chapter1对象中。 现在,我们在java项目中添加一个图像。 我们可以使用以下Image方法之一缩放图像:
scaleAbsolute() scaleAbsoluteWidth() scaleAbsoluteHeight() scalePercentage() scaleToFit()在清单8中 ,我们使用了scaleAbsolute。 然后将图像对象添加到该部分。
iText中的com.itextpdf.text.Anchor类表示指向外部网站或文档内部的链接。 锚点(链接)可以像网页中的链接一样单击。 要添加锚点,我们需要创建一个新的锚点并将引用设置为清单3中创建的Anchor目标。 然后将锚点添加到该部分,并将该部分添加到文档。
没有更多的元素可以添加到chapter1 ,是时候将chapter1添加到主document 。 与示例应用程序一样,我们还将在此处关闭文档对象。
该程序将在C:\处生成ITextTest.pdf文档。 图3显示了PDF文档首页的屏幕截图。
图4显示了第1章及其在PDF文档中的节,文本,表格,列表和图像的屏幕截图。
图5显示了PDF文档中Anchor链接的屏幕截图。
您刚刚看到了PDF生成的一些基本元素。 iText的优点在于,您可以在不同类型的编写器中使用相同元素的语法。 另外,您可以将编写器的输出重定向到控制台(对于XML和HTML编写器),Servlet的输出流(对于对PDF文档的Web请求的响应)或任何其他类型的OutputStream 。 在响应相同的情况下,iText也很方便,但是响应的类型因PDF,RTF,HTML或XML而异。 iText允许您创建水印,加密文档以及其他输出功能。
注册developerWorks Premium
翻译自: https://www.ibm.com/developerworks/java/library/os-javapdf/index.html
相关资源:java生成PDF并下载