利用iText包實(shí)現(xiàn)Java報(bào)表打印

丁振凡 ，王小明 ，吳小元 ，鄧建明 ，周 斌

（1.華東交通大學(xué)，江西 南昌330013；2.南昌鐵路局，江西 南昌330001）

在信息系統(tǒng)應(yīng)用中，報(bào)表處理一直起著比較重要的作用。Java報(bào)表制作中最常使用的是iText組件，它是一種生成PDF報(bào)表的Java組件。本文討論兩種形式的PDF報(bào)表處理，一種是通過程序?qū)ο笊烧麄€(gè)PDF報(bào)表文檔，另一種是利用制作好的含報(bào)表的PDF文檔模板，通過在模板填寫數(shù)據(jù)實(shí)現(xiàn)數(shù)據(jù)報(bào)表。

1 通過編程繪制實(shí)現(xiàn)報(bào)表的生成

對(duì)于內(nèi)容動(dòng)態(tài)變化的表格，適合使用程序繪制辦法進(jìn)行生成處理。這類表格中數(shù)據(jù)項(xiàng)和數(shù)據(jù)均是動(dòng)態(tài)存在的。

1.1 使用iText編程生成含報(bào)表的PDF文檔的步驟[1]

(1)建立Document對(duì)象。Document是 PDF文件所有元素的容器。

(2)建立一個(gè)與Document對(duì)象關(guān)聯(lián)的書寫器(Writer)。通過書寫器(Writer)對(duì)象可以將具體文檔存盤成需要的格式，PDFWriter可以將文檔保存為PDF文件。

(3)打開文檔。如：document.open();

(4)向文檔中添加內(nèi)容。所有向文檔添加的內(nèi)容都是以對(duì)象為單位的，iText中用文本塊(Chunk)、短語(Phrase)和段落(Paragraph)處理文本。

//添加一個(gè)段落

值得注意的是文本中漢字的顯示，默認(rèn)的iText字體設(shè)置不支持中文字體，需要下載遠(yuǎn)東字體包iTextAsian.jar，否則不能往PDF文檔中輸出中文字體[2]。

(5)關(guān)閉文檔。如：document.close();

1.2 表格繪制

要在PDF文件中創(chuàng)建表格，iText提供了兩個(gè)類——Table和PdfPTable。Table類用來實(shí)現(xiàn)簡(jiǎn)單表格，PdfPTable類則用來實(shí)現(xiàn)比較復(fù)雜的表格。本文主要討論P(yáng)dfPTable類的應(yīng)用。

(1)創(chuàng)建 PdfPTable對(duì)象

創(chuàng)建PdfPTable對(duì)象只需要指定列數(shù)，不用指定行數(shù)。通常生成的表格默認(rèn)以80%的比例顯示在頁面上。例如定義3列的表格，每列的寬度分別為15%、25%和60%，語句如下：

用 setWidthPercentage(float widthPercentage)方法可設(shè)置表格的按百分比的寬度。而用setTotalWidth則可設(shè)置表格按像素計(jì)算的寬度。如果表格的內(nèi)容超過了300 px，表格的寬度會(huì)自動(dòng)加長(zhǎng)。用setLockedWidth(true)方法可鎖定表格寬度。通過表格對(duì)象的系列方法可設(shè)置表格的邊界以及對(duì)齊、填充方式。

(2)添加單元格

表格創(chuàng)建完成以后，可通過 addCell(Object object)方法插入單元格元素（PdfPCell）。其中，Object對(duì)象可以是PdfPCell、String、Phrase、Image，也可以是 PdfPTable 對(duì)象本身，即在表格中嵌套一個(gè)表格。通過單元格的方法可設(shè)定單元格的列跨度、邊框粗細(xì)、對(duì)齊方式、填充間隙等。

(3)合并單元格

為了實(shí)現(xiàn)某些特殊的表格形式，需要合并單元格。PdfPCell類提供了 setColspan(int colspan)方法用于合并橫向單元格，參數(shù)colspan為合并的單元格數(shù)。但要合并縱向單元格需要使用嵌套表格的方法。將某個(gè)子表加入單元格，且安排單元格所占列數(shù)為子表中列數(shù)，則其行跨度也就是子表中的行數(shù)。

由于實(shí)際編程時(shí)，經(jīng)常出現(xiàn)各類結(jié)構(gòu)的嵌套情形，可以將產(chǎn)生某種結(jié)構(gòu)的表格模塊進(jìn)行封裝，編制成方法，通過傳遞方法參數(shù)完成表格特定模塊的繪制。

例如，可以將生成一個(gè)整齊行列表格的代碼編寫成方法。方法返回表格，填充的數(shù)據(jù)通過二維對(duì)象數(shù)組傳遞。代碼如下：

2 基于PDF報(bào)表模板的報(bào)表生成

有些表格具有固定的格式，實(shí)際工作中只是給表格填寫數(shù)據(jù)。這類表格可轉(zhuǎn)換為PDF文件格式的報(bào)表模板，通過特殊工具在文件中定義若干數(shù)據(jù)域，通過給數(shù)據(jù)域?qū)懭霐?shù)據(jù)實(shí)現(xiàn)對(duì)報(bào)表數(shù)據(jù)的填充處理。它具有格式靈活的特點(diǎn)?；趫?bào)表模板的報(bào)表處理步驟如下：

(1)利用Word制作打印報(bào)表；

(2)利用 Adobe Acrobat 7.0 Professional將 Word文檔轉(zhuǎn)換為PDF格式；

(3)利用 Adobe Designer 7.0對(duì) PDF進(jìn)行設(shè)計(jì)，定義數(shù)據(jù)域；

(4)利用iText組件實(shí)現(xiàn)對(duì)報(bào)表數(shù)據(jù)字段的寫入。

可利用Adobe Designer 7.0導(dǎo)入某個(gè)PDF文件進(jìn)行設(shè)計(jì),在任意位置添加文本域。每個(gè)文本域有一個(gè)綁定的名稱和值，在Java程序中正是通過文本域的名稱訪問文本域?qū)ο蟆?/p>

圖2給出了利用Adobe Acrobat 7.0 Professional打開一個(gè)制作好的帶數(shù)據(jù)域定義的PDF文檔模板文件的瀏覽界面，出于清晰考慮，圖中特別將數(shù)據(jù)域采用高亮度顯示。

圖2 帶數(shù)據(jù)域定義的PDF文檔

以下給出了打開報(bào)表模板實(shí)現(xiàn)數(shù)據(jù)寫入的關(guān)鍵代碼：

【說明】

①利用PdfReader讀取PDF文檔；通過實(shí)例化Pdf-Reader對(duì)象來獲取pdf模板，傳入的字符串就是pdf文件所放置的路徑，可以用絕對(duì)路徑表示。

②取得對(duì)象后，需要用PdfStamper來編輯PdfReader對(duì)象，同時(shí)獲取一個(gè)OutputStream輸出流作為輸出對(duì)象。

③利用PdfStamper獲取文件中定義的AcroFields對(duì)象。

④用AcroFields對(duì)象的setField填寫各個(gè)字段的數(shù)據(jù)到表格中。

3 Java打印PDF報(bào)表文件

在Web應(yīng)用中要在客戶端打印PDF文檔只需要將文件送客戶瀏覽器顯示，利用瀏覽器客戶端的文件打印功能可實(shí)現(xiàn)打印。以下討論在Java應(yīng)用程序中如何打印報(bào)表文件。

Java實(shí)現(xiàn)報(bào)表打印首先要獲取打印服務(wù)對(duì)象，然后利用服務(wù)對(duì)象開始一個(gè)作業(yè)的打印。以下給出了新的JDK1.4以上版本中實(shí)現(xiàn)打印的具體步驟和關(guān)鍵代碼。

本文介紹了利用iText實(shí)現(xiàn)PDF報(bào)表打印的編程處理方法。分別介紹了報(bào)表處理中的兩種典型應(yīng)用。一種是由程序?qū)ο髣?dòng)態(tài)產(chǎn)生整個(gè)報(bào)表，重點(diǎn)介紹了利用Pdf-PTable等對(duì)象實(shí)現(xiàn)報(bào)表生成處理的技巧。另一種是在已存在的PDF報(bào)表文檔中填寫數(shù)據(jù)域完成報(bào)表，重點(diǎn)介紹了通過AcroFields對(duì)象實(shí)現(xiàn)數(shù)據(jù)域的填寫處理。最后給出了Java實(shí)現(xiàn)報(bào)表打印的控制方法。

[1]侯金波，王德群.iText API在計(jì)量信息管理系統(tǒng)中的應(yīng)用[J].計(jì)量與測(cè)試技術(shù)，2007，34(1)：57-60.

[2]王麗萍，秦永平.基于iText的PDF報(bào)表設(shè)計(jì)[J].電腦知識(shí)與技術(shù)，2007(8)：493-494.