用Java实现PDF报表

一、前言

　　在企业的信息系统中，报表处理一直占比较重要的作用，本文将介绍一种生成 PDF 报表的 Java 组件 --iText 。通过在服务器端使用 Jsp 或 JavaBean 生成 PDF 报表，客户端采用超级连接显示或下载得到生成的报表，这样就很好的解决了 B/S 系统的报表处理问题。

　　二、 iText 简介

　　 iText 是著名的开放源码的站点 sourceforge 一个项目，是用于生成 PDF 文档的一个 java 类库。通过 iText 不仅可以生成 PDF 或 rtf 的文档，而且可以将 XML 、 Html 文件转化为 PDF 文件。

　　 iText 的安装非常方便，在 http://www.lowagie.com/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  
example cell with colspan 1 and rowspan 2  1.1 2.1  
1.2 2.2  
cell test1 big cell  
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 输出 PDF 文件。

前言

如今 PDF 格式文档的使用已经越来越普遍，它在文档压缩、安全等方面都表现的非常优秀，有关它的好处我就不在这里多说了。那么如何使用 Java 语言开发应用来输出 PDF 格式的文档呢？答案就是 iText ，它是一个开发源代码的项目，你可以使用 iText 方便的实现 PDF 的输出。这篇文章我将向大家介绍如何使用 iText 来生成 PDF 文档。（见“阅读全文”）

HelloWorld

作为一个程序开发人员，对于 HelloWorld 程序并不陌生，几乎每一种语言或应用开始总是会举一个 HelloWorld 的例子来向大家介绍。在开始介绍 iText 时，我们不妨也从 HelloWorld 开始。

/*  * Created on 2004-1-3 ，创建第一个 Hello World 程序  */ package test1;   import java.io.FileNotFoundException; import java.io.FileOutputStream;   import com.lowagie.text.*; import com.lowagie.text.pdf.*; public class HelloWorld {       public static void main(String[] args) {         // 创建一个文档对象         Document doc=new Document();         try {         // 定义输出位置并把文档对象装入输出对象中            PdfWriter.getInstance(doc, new FileOutputStream("c:/hello.pdf"));             // 打开文档对象             doc.open();          // 加入文字 “Hello World”             doc.add(new Paragraph("HelloWorld"));          //  关闭文档对象，释放资源             doc.close();                   } catch (FileNotFoundException e) {            e.printStackTrace();        } catch (DocumentException e) {            e.printStackTrace();        }     } }

现在运行上面的代码（记住在这之前把 itext.jar 放到你的 ClassPath 之中），如果一切正常的话你会在 ”c:/” 看到一个名为 hello.pdf 的文件。打开这个文件，看到了什么？是的文档里有一行字符“ HelloWorld ”，如下图。

怎么样是不是很简单？当然我们在实际应用时不可能只是简单的输出一个字符串就完事了，还要作很多的工作，输出更复杂的 PDF ，下面就让我们开始进一步了解 iText 的其他功能。

更复杂的设置

   分析一下 Document 的构造方法，我们发现除了我们上一个例子中的无参数构造以外还有两个：

public Document(); public Document(Rectangle pageSize); public Document(Rectangle pageSize,    int marginLeft,    int marginRight,    int marginTop,    int marginBottom);

第一个设置文档的页面大小，第二个除了设置文档的页面大小还设置页面边距。下面我分别给出例子。

Rectangle pSize=new Rectangle(144,90);  // 文档的背景色         pSize.setBackgroundColor(Color.blue);                // 创建一个文档对象 ，并设置他的初始化大小         Document doc=new Document(pSize);

 

Rectangle pSize=new Rectangle(144,90);         // 文档的背景色         pSize.setBackgroundColor(Color.blue);                      // 创建一个文档对象 ，设置初始化大小和页边距         Document doc=new Document(pSize,5,5,5,5);

将第一个例子中的代码按上面的方法修改然后运行，你可以看到输出的 PDF 文档将是这个样子，文档变得很小而且背景是蓝色：

 

在上面的例子中我们通过 Rectangle 设置了文档的大小，其实 iText 已经为我们定义好了许多常用的页面，比如： A0-A10, LEGAL, LETTER 等等， 这些都放在 com.lowagie.text. PageSize 这个类中，你可以通过调用 PageSize 中的静态方法直接引用页面信息。比如：

PageSize.A4;

 

设置字体

   使用 iText 可以设置文字的字体，对于我们中国的程序员来说如何显示中文是最紧要的问题。幸好 iText 中有一个专门的包用来设置亚洲国家的字体你可以从 http://itext.sourceforge.net/downloads/iTextAsian.jar 下载这个包。然后把它直接放到你的 ClassPath 中就可以了。如何设置字体呢？

BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);             Font FontChinese = new Font(bfChinese, 12, Font.NORMAL);

在上面的代码中设置了中文字体的显示，你只要使用下面的代码就可以包中文加到 PDF 中了

String title = " 最新电影：矩阵革命 " ;             Paragraph t = new Paragraph(title, FontChinese);             doc.add(t);

如果你觉得这样设置很麻烦的话，呵呵，那你要自己扩展它的源代码了，设置字体全部在那个 BaseFont 里边。

 

编辑表格

   iText 中的表格很像 HTML 中表格的使用不过它有一个 cell 代表一个格子，基本上这里的 Table 和 Swing 中的 Table 对象是一致的，比如上面代码中对于表格的设置：

// 定义一个表格            Table table = new Table(2);             // 设置表格边框            table.setBorderWidth(1);             Cell cell = new Cell("Matrix III");            cell.setHeader(true);             // 分列            cell.setColspan(2);             cell.setBackgroundColor(Color.blue);            table.addCell(cell);

 

放置图片

现在你一定知道如何把一个图片加到文档中了，没错只要声明一个 Image 对象就可以了，这里的 Image 和 AWT 中的 Image 使用方法是一样的。

// 定义一个图片            Image jpeg = Image.getInstance("C:/matrix.jpg");             // 图片居中            jpeg.setAlignment(Image.ALIGN_CENTER);

 

运行后输出的 PDF 文件为：

 

结束

有关 iText 的使用我就大致介绍这些，更深入的东西只有大家参考源代码自己体会了。当然其中有些理解也可能是不对的，哪位朋友有什么建议欢迎与我联系。