从Java应用程序动态生成PDF文件
来源:网络 更新时间:2014-11-27
如果应用程序需要动态生成PDF文档,则需要iText库。开放源码的iText库使PDF文档的创建能够在瞬间完成。本文介绍了iText并提供了使用它从Java?技术应用程序生成PDF文档的由浅入深的指南。我们创建了一个示例应用程序以更好地理解iText。
很多应用程序要求动态生成PDF文档。这类应用程序包括银行生成用于电子邮件投递的客户报表,到读者购买特定图书章节并以PDF格式接收这些文档。例子罗列下去是很多的。在本文中,将使用iTextJava库生成PDF文档,并引导您完成一个示例应用程序,以使您能够更好地理解和使用iText。
熟悉iText
iText是Lowagie.com站点(请参阅参考资料)免费提供的Java库。iText库的功能很强大,支持HTML、RTF和XML文档的生成,此外还能够生成PDF文档。可以从多种字体中选择文档中所使用的字体。同时,iText的结构允许使用相同的代码生成以上任意类型的文档。
iText库中的类用于以各种字体来生成PDF文本、在PDF文档中生成表格、为页添加水印等。iText还提供许多功能。在一篇文章中不可能一一演示。本文中将介绍生成PDF文档的基本需求。
我们将使用Eclipse来进行示例应用程序开发。作为一个开放源码的IDE,可以免费获得Eclipse,而且其功能非常强大。现在就可以下载Eclipse。
iTextAPI:近距离观察
com.lowagie.text.Document是生成PDF的主要的类。它是需要使用的第一个类。一旦开始创建文档,将需要一个写入器向文档中写入内容。com.lowagie.text.pdf.PdfWriter就是一个PDF写入器。下面列出了通常需要使用的类:
com.lowagie.text.Paragraph——这个类表示一个缩进的段落。
com.lowagie.text.Chapter——这个类表示PDF文档中的章节。使用Paragraph作为题目并使用int作为章节号码来创建它。
com.lowagie.text.Font——这个类包含了全部的字体规范,例如字体、大小、样式和颜色。各种字体都在这个类中声明为静态常数。
com.lowagie.text.List——这个类表示一个列表,按顺序包含许多ListItems。
com.lowagie.text.Table——这个类表示包含单元格的表,单元格有序地排列在矩阵中。
下载iText并在Eclipse中进行配置
作为一个纯粹的Java库,iText是以JAR文件的形式出现的(请参阅参考资料)。一旦下载了这个库(在路径C:\temp下),执行下列步骤将会在Eclipse环境中配置iText库:
在Eclipse中创建一个新的Java项目,将其命名为iText。
在PackageExplorer视图中右击iText项目,然后选择Properties。
单击JavaBuildPath。在Libraries选项卡中,单击AddExternalJARs。
浏览到C:\temp目录,选择该目录下的itext-1.3.jar。
单击OK。
现在已经配置好iText,Eclipse已经准备好创建Java应用程序以生成动态PDF文档。
示例应用程序
还有什么能够比自己动手创建一个工作示例更好地演示技术了?现在有了所需的工具(EclipseIDE)和库(iText库),可以开始设计和开发一个示例应用程序了。
让我们创建一个简单的PDF文档,其中包含一些基本元素,如纯文本、非默认字体的彩色文本、表格、列表、章节和小节等。此应用程序的目的是让您熟悉iText库的使用方式。有很多与帮助生成PDF文档有关的类。在这里不可能介绍所有这些类。iText的javadoc是介绍如何使用这些类的很好的资料。下面让我们来开始编写代码。
第一步是创建一个文档。文档是PDF文档的所有元素的容器。
清单1.实例化文档对象
Documentdocument=newDocument(PageSize.A4,50,50,50,50);
第一个参数是页面大小。接下来的参数分别是左、右、上和下页边距。但是还没有定义该文档的类型。它取决于所创建的写入器的类型。对于我们的示例,选择了com.lowagie.text.pdf.PdfWriter。其他写入器为HtmlWriter、RtfWriter、XmlWriter等等。它们的名称解释了它们的实际用途。