丁振凡 ,王小明 ,吳小元 ,鄧建明 ,周 斌
(1.華東交通大學(xué),江西 南昌330013;2.南昌鐵路局,江西 南昌330001)
在信息系統(tǒng)應(yīng)用中,報(bào)表處理一直起著比較重要的作用。Java報(bào)表制作中最常使用的是iText組件,它是一種生成PDF報(bào)表的Java組件。本文討論兩種形式的PDF報(bào)表處理,一種是通過程序?qū)ο笊烧麄€PDF報(bào)表文檔,另一種是利用制作好的含報(bào)表的PDF文檔模板,通過在模板填寫數(shù)據(jù)實(shí)現(xiàn)數(shù)據(jù)報(bào)表。
對于內(nèi)容動態(tài)變化的表格,適合使用程序繪制辦法進(jìn)行生成處理。這類表格中數(shù)據(jù)項(xiàng)和數(shù)據(jù)均是動態(tài)存在的。
(1)建立Document對象。Document是 PDF文件所有元素的容器。
(2)建立一個與Document對象關(guān)聯(lián)的書寫器(Writer)。通過書寫器(Writer)對象可以將具體文檔存盤成需要的格式,PDFWriter可以將文檔保存為PDF文件。
(3)打開文檔。如:document.open();
(4)向文檔中添加內(nèi)容。所有向文檔添加的內(nèi)容都是以對象為單位的,iText中用文本塊(Chunk)、短語(Phrase)和段落(Paragraph)處理文本。
//添加一個段落
值得注意的是文本中漢字的顯示,默認(rèn)的iText字體設(shè)置不支持中文字體,需要下載遠(yuǎn)東字體包iTextAsian.jar,否則不能往PDF文檔中輸出中文字體[2]。
(5)關(guān)閉文檔。如:document.close();
要在PDF文件中創(chuàng)建表格,iText提供了兩個類——Table和PdfPTable。Table類用來實(shí)現(xiàn)簡單表格,PdfPTable類則用來實(shí)現(xiàn)比較復(fù)雜的表格。本文主要討論P(yáng)dfPTable類的應(yīng)用。
(1)創(chuàng)建 PdfPTable對象
創(chuàng)建PdfPTable對象只需要指定列數(shù),不用指定行數(shù)。通常生成的表格默認(rèn)以80%的比例顯示在頁面上。例如定義3列的表格,每列的寬度分別為15%、25%和60%,語句如下:
用 setWidthPercentage(float widthPercentage)方法可設(shè)置表格的按百分比的寬度。而用setTotalWidth則可設(shè)置表格按像素計(jì)算的寬度。如果表格的內(nèi)容超過了300 px,表格的寬度會自動加長。用setLockedWidth(true)方法可鎖定表格寬度。通過表格對象的系列方法可設(shè)置表格的邊界以及對齊、填充方式。
(2)添加單元格
表格創(chuàng)建完成以后,可通過 addCell(Object object)方法插入單元格元素(PdfPCell)。其中,Object對象可以是PdfPCell、String、Phrase、Image,也可以是 PdfPTable 對象本身,即在表格中嵌套一個表格。通過單元格的方法可設(shè)定單元格的列跨度、邊框粗細(xì)、對齊方式、填充間隙等。
(3)合并單元格
為了實(shí)現(xiàn)某些特殊的表格形式,需要合并單元格。PdfPCell類提供了 setColspan(int colspan)方法用于合并橫向單元格,參數(shù)colspan為合并的單元格數(shù)。但要合并縱向單元格需要使用嵌套表格的方法。將某個子表加入單元格,且安排單元格所占列數(shù)為子表中列數(shù),則其行跨度也就是子表中的行數(shù)。
由于實(shí)際編程時,經(jīng)常出現(xiàn)各類結(jié)構(gòu)的嵌套情形,可以將產(chǎn)生某種結(jié)構(gòu)的表格模塊進(jìn)行封裝,編制成方法,通過傳遞方法參數(shù)完成表格特定模塊的繪制。
例如,可以將生成一個整齊行列表格的代碼編寫成方法。方法返回表格,填充的數(shù)據(jù)通過二維對象數(shù)組傳遞。代碼如下:
有些表格具有固定的格式,實(shí)際工作中只是給表格填寫數(shù)據(jù)。這類表格可轉(zhuǎn)換為PDF文件格式的報(bào)表模板,通過特殊工具在文件中定義若干數(shù)據(jù)域,通過給數(shù)據(jù)域?qū)懭霐?shù)據(jù)實(shí)現(xiàn)對報(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對 PDF進(jìn)行設(shè)計(jì),定義數(shù)據(jù)域;
(4)利用iText組件實(shí)現(xiàn)對報(bào)表數(shù)據(jù)字段的寫入。
可利用Adobe Designer 7.0導(dǎo)入某個PDF文件進(jìn)行設(shè)計(jì),在任意位置添加文本域。每個文本域有一個綁定的名稱和值,在Java程序中正是通過文本域的名稱訪問文本域?qū)ο蟆?/p>
圖2給出了利用Adobe Acrobat 7.0 Professional打開一個制作好的帶數(shù)據(jù)域定義的PDF文檔模板文件的瀏覽界面,出于清晰考慮,圖中特別將數(shù)據(jù)域采用高亮度顯示。
圖2 帶數(shù)據(jù)域定義的PDF文檔
以下給出了打開報(bào)表模板實(shí)現(xiàn)數(shù)據(jù)寫入的關(guān)鍵代碼:
【說明】
①利用PdfReader讀取PDF文檔;通過實(shí)例化Pdf-Reader對象來獲取pdf模板,傳入的字符串就是pdf文件所放置的路徑,可以用絕對路徑表示。
②取得對象后,需要用PdfStamper來編輯PdfReader對象,同時獲取一個OutputStream輸出流作為輸出對象。
③利用PdfStamper獲取文件中定義的AcroFields對象。
④用AcroFields對象的setField填寫各個字段的數(shù)據(jù)到表格中。
在Web應(yīng)用中要在客戶端打印PDF文檔只需要將文件送客戶瀏覽器顯示,利用瀏覽器客戶端的文件打印功能可實(shí)現(xiàn)打印。以下討論在Java應(yīng)用程序中如何打印報(bào)表文件。
Java實(shí)現(xiàn)報(bào)表打印首先要獲取打印服務(wù)對象,然后利用服務(wù)對象開始一個作業(yè)的打印。以下給出了新的JDK1.4以上版本中實(shí)現(xiàn)打印的具體步驟和關(guān)鍵代碼。
本文介紹了利用iText實(shí)現(xiàn)PDF報(bào)表打印的編程處理方法。分別介紹了報(bào)表處理中的兩種典型應(yīng)用。一種是由程序?qū)ο髣討B(tài)產(chǎn)生整個報(bào)表,重點(diǎn)介紹了利用Pdf-PTable等對象實(shí)現(xiàn)報(bào)表生成處理的技巧。另一種是在已存在的PDF報(bào)表文檔中填寫數(shù)據(jù)域完成報(bào)表,重點(diǎn)介紹了通過AcroFields對象實(shí)現(xiàn)數(shù)據(jù)域的填寫處理。最后給出了Java實(shí)現(xiàn)報(bào)表打印的控制方法。
[1]侯金波,王德群.iText API在計(jì)量信息管理系統(tǒng)中的應(yīng)用[J].計(jì)量與測試技術(shù),2007,34(1):57-60.
[2]王麗萍,秦永平.基于iText的PDF報(bào)表設(shè)計(jì)[J].電腦知識與技術(shù),2007(8):493-494.