该用户从未签到
|
如果应用程序需要动态生成 PDF 文档,则需要 iText 库。开放源码的 iText 库使 PDF 文档的创建能够在瞬间完成。本文介绍了 iText 并提供了使用它从 java ? 技术应用程序生成 PDF 文档的由浅入深的指南。我们创建了一个示例应用程序以更好地理解 iText。
9 B# U/ a4 B& u# @" |' H很多应用程序要求动态生成 PDF 文档。这类应用程序包括银行生成用于电子邮件投递的客户报表,到读者购买特定图书章节并以 PDF 格式接收这些文档。例子罗列下去是很多的。在本文中,将使用 iText Java 库生成 PDF 文档,并引导您完成一个示例应用程序,以使您能够更好地理解和使用 iText。+ @$ p+ F) X) }( w+ Q
熟悉 iText
1 X+ y2 b& `; x" diText 是 Lowagie.com 站点(请参阅 参考资料)免费提供的 Java 库。iText 库的功能很强大,支持 HTML、RTF 和 XML 文档的生成,此外还能够生成 PDF 文档。可以从多种字体中选择文档中所使用的字体。同时,iText 的结构允许使用相同的代码生成以上任意类型的文档。
4 R8 d# c5 H2 _7 k3 Z6 }- A2 wiText 库中的类用于以各种字体来生成 PDF 文本、在 PDF 文档中生成表格、为页添加水印等。iText 还提供许多功能。在一篇文章中不可能一一演示。本文中将介绍生成 PDF 文档的基本需求。, h" K6 N! w- m& g
我们将使用 Eclipse 来进行示例应用程序开发。作为一个开放源码的 IDE,可以免费获得 Eclipse,而且其功能非常强大。现在就可以下载 Eclipse。2 L/ K! f1 a/ R( r
iText API:近距离观察
, x4 I/ D+ o3 `( gcom.lowagie.text.Document 是生成 PDF 的主要的类。它是需要使用的第一个类。一旦开始创建文档,将需要一个写入器向文档中写入内容。com.lowagie.text.pdf.PdfWriter 就是一个 PDF 写入器。下面列出了通常需要使用的类:1 _ j% x4 }& i, V- V1 y$ Q7 ?
com.lowagie.text.Paragraph —— 这个类表示一个缩进的段落。1 ^6 s- ?* t& h+ Q. y9 a
com.lowagie.text.Chapter —— 这个类表示 PDF 文档中的章节。使用 Paragraph 作为题目并使用 int 作为章节号码来创建它。
; Z0 t7 w/ \. A7 k) O) C$ [com.lowagie.text.Font —— 这个类包含了全部的字体规范,例如字体、大小、样式和颜色。各种字体都在这个类中声明为静态常数。
$ h8 a# F/ A% t* i6 z+ e3 I* xcom.lowagie.text.List —— 这个类表示一个列表,按顺序包含许多 ListItems。
2 k4 k$ U: V' K1 pcom.lowagie.text.Table —— 这个类表示包含单元格的表,单元格有序地排列在矩阵中。
' g( B$ Z& u, W0 E0 b1 C7 |下载 iText 并在 Eclipse 中进行配置
9 [5 v# `& F; f作为一个纯粹的 Java 库,iText 是以 JAR 文件的形式出现的(请参阅 参考资料)。一旦下载了这个库(在路径 C:\temp 下),执行下列步骤将会在 Eclipse 环境中配置 iText 库:
. ?: e, ~. V3 y) ~3 ~7 `4 o- B* v& x在 Eclipse 中创建一个新的 Java 项目,将其命名为 iText。
# w# Z# X7 h' a在 Package Explorer 视图中右击 iText 项目,然后选择 Properties。. w. m0 c2 ~0 ?7 F2 e
单击 Java Build Path。在 Libraries 选项卡中,单击 Add External JARs。
( u! F8 P# n$ ~1 V浏览到 C:\temp 目录,选择该目录下的 itext-1.3.jar。9 }( n7 i# M. ?; b, p0 I
单击 OK。6 ~) R% S/ t5 } H& @
现在已经配置好 iText,Eclipse 已经准备好创建 Java 应用程序以生成动态 PDF 文档。& P1 c! [( Z- `# C3 W/ V
示例应用程序
- ^! L4 {+ i, B6 |3 _, e; }还有什么能够比自己动手创建一个工作示例更好地演示技术了?现在有了所需的工具(Eclipse IDE)和库(iText 库),可以开始设计和开发一个示例应用程序了。
9 [# {- Z9 `" _4 m4 _) r让我们创建一个简单的 PDF 文档,其中包含一些基本元素,如纯文本、非默认字体的彩色文本、表格、列表、章节和小节等。此应用程序的目的是让您熟悉 iText 库的使用方式。有很多与帮助生成 PDF 文档有关的类。在这里不可能介绍所有这些类。iText 的 javadoc 是介绍如何使用这些类的很好的资料。下面让我们来开始编写代码。$ a1 Z; `- P# `! Q
第一步是创建一个文档。文档是 PDF 文档的所有元素的容器。
X) O- f" r6 A$ i' {7 f清单 1. 实例化文档对象7 Z' ]/ Z) x' E' N4 [. }' F8 m
Document document = new Document(PageSize.A4, 50, 50, 50, 50);
g2 G& O- B1 ?/ l第一个参数是页面大小。接下来的参数分别是左、右、上和下页边距。但是还没有定义该文档的类型。它取决于所创建的写入器的类型。对于我们的示例,选择了 com.lowagie.text.pdf.PdfWriter。其他写入器为 HtmlWriter、RtfWriter、XmlWriter 等等。它们的名称解释了它们的实际用途。
. c+ e& z: C7 H$ U/ {; Z I- l& m清单 2. 创建 PdfWriter 对象
2 R2 U2 v" Y; l& j) UPdfWriter writer = PdfWriter.getInstance(document, \0 H% E4 E( `* c% N) ^5 X/ z$ o7 z s
new FileOutputStream("C:\\ITextTest.pdf"));. }- S8 K; ^5 S( S
document.open();
( t7 J! \0 u5 Z% z: q( S, g; y第一个参数是对文档对象的引用,第二个参数是文件的实际名称,在该名称中还会给出其输出路径。接下来,打开文档以写入内容。5 I( S1 ]# p& d! o( p7 `2 ?) G% Y
4 S3 p% {; L0 B! j. ?" r8 O8 }' ]
|
|