生成pdf文件方法.docx

针对生成pdf文件二中的方法一、前言在企业的信息系统中，报表处理一直占比较重要的作用，本文将介绍一种生成PDF报表的Java组件-iText。通过在服务器端使用Jsp或JavaBean生成PDF报表，客户端采用超级连接显示或下载得到生成的报表，这样就很好的解决了B/S系统的报表处理问题。二、iText简介iText是著名的开放源码的站点sourceforge一个项目，是用于生成PDF文档的一个java类库。通过iText不仅可以生成PDF或rtf的文档，而且可以将XML、Html文件转化为PDF文件。iText的安装非常方便，在/iText/download.html - download 网站上下载iText.jar文件后，只需要在系统的CLASSPATH中加入iText.jar的路径，在程序中就可以使用iText类库了。三、建立第一个PDF文档用iText生成PDF文档需要5个步骤：建立com.lowagie.text.Document对象的实例。Document document = new Document();建立一个书写器(Writer)与document对象关联，通过书写器(Writer)可以将文档写入到磁盘中。PDFWriter.getInstance(document, new FileOutputStream(Helloworld.PDF);打开文档。document.open();向文档中添加内容。document.add(new Paragraph(Hello World);关闭文档。document.close();通过上面的5个步骤，就能产生一个Helloworld.PDF的文件，文件内容为Hello World。建立com.lowagie.text.Document对象的实例com.lowagie.text.Document对象的构建函数有三个，分别是：public Document();public Document(Rectangle pageSize);public Document(Rectangle pageSize,int marginLeft,int marginRight,int marginTop,int marginBottom);构建函数的参数pageSize是文档页面的大小，对于第一个构建函数，页面的大小为A4，同Document(PageSize.A4)的效果一样；对于第三个构建函数，参数marginLeft、marginRight、marginTop、marginBottom分别为左、右、上、下的页边距。通过参数pageSize可以设定页面大小、面背景色、以及页面横向/纵向等属性。iText定义了A0-A10、AL、LETTER、HALFLETTER、_11x17、LEDGER、NOTE、B0-B5、ARCH_A-ARCH_E、FLSA 和FLSE等纸张类型，也可以通过Rectangle pageSize = new Rectangle(144, 720);自定义纸张。通过Rectangle方法rotate()可以将页面设置成横向。书写器（Writer）对象一旦文档(document)对象建立好之后，需要建立一个或多个书写器(Writer)对象与之关联。通过书写器(Writer)对象可以将具体文档存盘成需要的格式，如com.lowagie.text.PDF.PDFWriter可以将文档存成PDF文件，com.lowagie.text.html.HtmlWriter可以将文档存成html文件。设定文档属性在文档打开之前，可以设定文档的标题、主题、作者、关键字、装订方式、创建者、生产者、创建日期等属性，调用的方法分别是：public boolean addTitle(String title)public boolean addSubject(String subject)public boolean addKeywords(String keywords)public boolean addAuthor(String author)public boolean addCreator(String creator)public boolean addProducer()public boolean addCreationDate()public boolean addHeader(String name, String content)其中方法addHeader对于PDF文档无效，addHeader仅对html文档有效，用于添加文档的头信息。当新的页面产生之前，可以设定页面的大小、书签、脚注（HeaderFooter）等信息，调用的方法是：public boolean setPageSize(Rectangle pageSize)public boolean add(Watermark watermark)public void removeWatermark()public void setHeader(HeaderFooter header)public void resetHeader()public void setFooter(HeaderFooter footer)public void resetFooter()public void resetPageCount()public void setPageCount(int pageN)如果要设定第一页的页面属性，这些方法必须在文档打开之前调用。对于PDF文档，iText还提供了文档的显示属性，通过调用书写器的setViewerPreferences方法可以控制文档打开时Acrobat Reader的显示属性，如是否单页显示、是否全屏显示、是否隐藏状态条等属性。另外，iText也提供了对PDF文件的安全保护，通过书写器（Writer）的setEncryption方法，可以设定文档的用户口令、只读、可打印等属性。添加文档内容所有向文档添加的内容都是以对象为单位的，如Phrase、Paragraph、Table、Graphic对象等。比较常用的是段落(Paragraph)对象，用于向文档中添加一段文字。四、文本处理iText中用文本块(Chunk)、短语(Phrase)和段落(paragraph)处理文本。文本块(Chunk)是处理文本的最小单位，有一串带格式（包括字体、颜色、大小）的字符串组成。如以下代码就是产生一个字体为HELVETICA、大小为10、带下划线的字符串：Chunk chunk1 = new Chunk(This text is underlined, FontFactory.getFont(FontFactory.HELVETICA, 12, Font.UNDERLINE);短语(Phrase)由一个或多个文本块(Chunk)组成，短语(Phrase)也可以设定字体，但对于其中以设定过字体的文本块(Chunk)无效。通过短语(Phrase)成员函数add可以将一个文本块(Chunk)加到短语(Phrase)中，如：phrase6.add(chunk);段落(paragraph)由一个或多个文本块(Chunk)或短语(Phrase)组成，相当于WORD文档中的段落概念，同样可以设定段落的字体大小、颜色等属性。另外也可以设定段落的首行缩进、对齐方式（左对齐、右对齐、居中对齐）。通过函数setAlignment可以设定段落的对齐方式，setAlignment的参数1为居中对齐、2为右对齐、3为左对齐，默认为左对齐。五、表格处理iText中处理表格的类为：com.lowagie.text.Table和com.lowagie.text.PDF.PDFPTable，对于比较简单的表格处理可以用com.lowagie.text.Table，但是如果要处理复杂的表格，这就需要com.lowagie.text.PDF.PDFPTable进行处理。这里就类com.lowagie.text.Table进行说明。类com.lowagie.text.Table的构造函数有三个：Table (int columns)Table(int columns, int rows)Table(Properties attributes)参数columns、rows、attributes分别为表格的列数、行数、表格属性。创建表格时必须指定表格的列数，而对于行数可以不用指定。建立表格之后，可以设定表格的属性，如：边框宽度、边框颜色、衬距（padding space 即单元格之间的间距）大小等属性。下面通过一个简单的例子说明如何使用表格，代码如下：1:Table table = new Table(3);2:table.setBorderWidth(1);3:table.setBorderColor(new Color(0, 0, 255);4:table.setPadding(5);5:table.setSpacing(5);6:Cell cell = new Cell(header);7:cell.setHeader(true);8:cell.setColspan(3);9:table.addCell(cell);10:table.endHeaders();11:cell = new Cell(example cell with colspan 1 and rowspan 2);12:cell.setRowspan(2);13:cell.setBorderColor(new Color(255, 0, 0);14:table.addCell(cell);15:table.addCell(1.1);16:table.addCell(2.1);17:table.addCell(1.2);18:table.addCell(2.2);19:table.addCell(cell test1);20:cell = new Cell(big cell);21:cell.setRowspan(2);22:cell.setColspan(2);23:table.addCell(cell);24:table.addCell(cell test2);运行结果如下：header cell test2代码1-5行用于新建一个表格，如代码所示，建立了一个列数为3的表格，并将边框宽度设为1，颜色为蓝色，衬距为5。代码6-10行用于设定表格的表头，第7行cell.setHeader(true);是将该单元格作为表头信息显示；第8行cell.setColspan(3);指定了该单元格占3列；为表格添加表头信息时，要注意的是一旦表头信息添加完了之后，必须调用endHeaders()方法，如第10行，否则当表格跨页后，表头信息不会再显示。代码11-14行是向表格中添加一个宽度占一列，长度占二行的单元格。往表格中添加单元格(cell)时，按自左向右、从上而下的次序添加。如执行完11行代码后，表格的右下方出现2行2列的空白，这是再往表格添加单元格时，先填满这个空白，然后再另起一行，15-24行代码说明了这种添加顺序。六、图像处理iText中处理表格的类为com.lowagie.text.Image，目前iText支持的图像格式有：GIF, Jpeg, PNG, wmf等格式，对于不同的图像格式，iText用同样的构造函数自动识别图像格式。通过下面的代码分别获得gif、jpg、png图像的实例。Image gif = Image.getInstance(vonnegut.gif);Image jpeg = Image.getInstance(myKids.jpg);Image png = Image.getInstance(hitchcock.png);图像的位置图像的位置主要是指图像在文档中的对齐方式、图像和文本的位置关系。IText中通过函数public void setAlignment(int alignment)进行处理，参数alignment为Image.RIGHT、Image.MIDDLE、Image.LEFT分别指右对齐、居中、左对齐；当参数alignment为Image.TEXTWRAP、Image.UNDERLYING分别指文字绕图形显示、图形作为文字的背景显示。这两种参数可以结合以达到预期的效果，如setAlignment(Image.RIGHT|Image.TEXTWRAP)显示的效果为图像右对齐，文字围绕图像显示。图像的尺寸和旋转如果图像在文档中不按原尺寸显示，可以通过下面的函数进行设定：public void scaleAbsolute(int newWidth, int newHeight)public void scalePercent(int percent)public void scalePercent(int percentX, int percentY)函数public void scaleAbsolute(int newWidth, int newHeight)直接设定显示尺寸；函数public void scalePercent(int percent)设定显示比例，如scalePercent(50)表示显示的大小为原尺寸的50%；而函数scalePercent(int percentX, int percentY)则图像高宽的显示比例。如果图像需要旋转一定角度之后在文档中显示，可以通过函数public void setRotation(double r)设定，参数r为弧度，如果旋转角度为30度，则参数r= Math.PI / 6。七、中文处理默认的iText字体设置不支持中文字体，需要下载远东字体包iTextAsian.jar，否则不能往PDF文档中输出中文字体。通过下面的代码就可以在文档中使用中文了：BaseFont bfChinese = BaseFont.createFont(STSong-Light, UniGB-UCS2-H, BaseFont.NOT_EMBEDDED);com.lowagie.text.Font FontChinese = new com.lowagie.text.Font(bfChinese, 12, com.lowagie.text.Font.NORMAL);Paragraph pragraph=new Paragraph(你好, FontChinese);八、后计iText还有很多高级的功能，这里就不一一介绍了，具体开发时可参考发布的文档。总的来说，iText是一套java环境下不错的制作PDF的组件。因为iText支持jsp/javabean下的开发，这使得B/S应用中的报表问题能得到很好的解决。由于iText毕竟不是专门为制作报表设计，所有报表中的内容、格式都需要通过写代码实现，相对于那些专业的支持可视化设计的报表软件来说，编程的工作量就有一定程度的增加。熟悉 iText V5.3.0 版iText 是一个可从 / 免费获取的 Java 库（请参见参考资料）。iText 库非常强大，且支持生成 HTML、RTF 和 XML 文档，还支持生成 PDF 文档。您可以选择各种各样的字体来用于文档中。另外，iText 的结构允许您使用相同代码生成上面提及的任何类型的文档。iText 库包含使用各种字体生成 PDF 文本、在 PDF 文档中生成表格、向页面中添加水印等的类。iText 还提供了其他许多特性。在一篇文章中无法演示所有这些特性。我们将介绍生成 PDF 所需的基本知识。有关更多详细信息，请参阅供应商提供的文档（参见参考资料）。我们将使用 Eclipse 开发我们的样例应用程序。作为一个开源 IDE，Eclipse 可免费获取且非常强大。您可立即下载 Eclipse（参见参考资料）。iText API：详细了解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：一个 Anchor 可能是一个引用，或是一个引用的目标。在 Eclipse 中下载和配置 iText作为一个纯 Java 库，iText 以 JAR 文件的形式提供（参见参考资料）。下载该库之后（假设下载到路径 C:temp），使用以下步骤在 Eclipse 环境中配置 iText 库：1. 在 Eclipse 中创建一个名为 iText 的新 Java 项目。2. 右键单击 Package Explorer 视图中的 iText 项目，选择Properties。3. 单击Java Build Path。在 Libraries 选项卡上，单击Add External JARs。4. 找到 C:temp 目录并选择此目录中的 itext-5.3.0.jar。5. 单击OK。iText 现在已配置，Eclipse 已准备好创建 Java 应用程序来生成动态的 PDF 文档。回页首样例应用程序还有什么能比您亲自创建的一个有效样例能更好地演示任何技术呢？现在您已拥有所需的工具 (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 类表示一个外部网站或文档内部