摘 要: 結(jié)合報表制作的兩種情形介紹了iText的應(yīng)用方法。一種是由程序?qū)ο髣討B(tài)產(chǎn)生整個報表文件的內(nèi)容,另一種是在已存在的PDF報表文檔中填寫數(shù)據(jù)域以完成報表。給出了Java實現(xiàn)報表打印的控制方法。
關(guān)鍵詞: Java報表;iText包;動態(tài)報表;填充型報表;報表打印
在信息系統(tǒng)應(yīng)用中,報表處理一直起著比較重要的作用。Java報表制作中最常使用的是iText組件,它是一種生成PDF報表的Java組件。本文討論兩種形式的PDF報表處理,一種是通過程序?qū)ο笊烧麄€PDF報表文檔,另一種是利用制作好的含報表的PDF文檔模板,通過在模板填寫數(shù)據(jù)實現(xiàn)數(shù)據(jù)報表。
1 通過編程繪制實現(xiàn)報表的生成
對于內(nèi)容動態(tài)變化的表格,適合使用程序繪制辦法進(jìn)行生成處理。這類表格中數(shù)據(jù)項和數(shù)據(jù)均是動態(tài)存在的。
1.1 使用iText編程生成含報表的PDF文檔的步驟[1]
(1)建立Document對象。Document是PDF文件所有元素的容器。
Document document = new Document();
(2)建立一個與Document對象關(guān)聯(lián)的書寫器(Writer)。通過書寫器(Writer)對象可以將具體文檔存盤成需要的格式,PDFWriter可以將文檔保存為PDF文件。
PDFWriter.getInstance(document, new FileOutputStream
("my.PDF"));
(3)打開文檔。如:document.open();
(4)向文檔中添加內(nèi)容。所有向文檔添加的內(nèi)容都是以對象為單位的,iText中用文本塊(Chunk)、短語(Phrase)和段落(Paragraph)處理文本。
document.add(new Paragraph("Hello World"));
//添加一個段落
值得注意的是文本中漢字的顯示,默認(rèn)的iText字體設(shè)置不支持中文字體,需要下載遠(yuǎn)東字體包iTextAsian.jar,否則不能往PDF文檔中輸出中文字體[2]。
(5)關(guān)閉文檔。如:document.close();
1.2 表格繪制
要在PDF文件中創(chuàng)建表格,iText提供了兩個類——Table和PdfPTable。Table類用來實現(xiàn)簡單表格,PdfPTable類則用來實現(xiàn)比較復(fù)雜的表格。本文主要討論PdfPTable類的應(yīng)用。
(1)創(chuàng)建PdfPTable對象
創(chuàng)建PdfPTable對象只需要指定列數(shù),不用指定行數(shù)。通常生成的表格默認(rèn)以80%的比例顯示在頁面上。例如定義3列的表格,每列的寬度分別為15%、25%和60%,語句如下:
float[] widths = {15f, 25f, 60f};
PdfPTable table = new PdfPTable(widths);
用setWidthPercentage(float widthPercentage)方法可設(shè)置表格的按百分比的寬度。而用setTotalWidth則可設(shè)置表格按像素計算的寬度。如果表格的內(nèi)容超過了300 px,表格的寬度會自動加長。用setLockedWidth(true)方法可鎖定表格寬度。通過表格對象的系列方法可設(shè)置表格的邊界以及對齊、填充方式。
(2)添加單元格
表格創(chuàng)建完成以后,可通過addCell(Object object)方法插入單元格元素(PdfPCell)。其中,Object對象可以是PdfPCell、String、Phrase、Image,也可以是PdfPTable對象本身,即在表格中嵌套一個表格。通過單元格的方法可設(shè)定單元格的列跨度、邊框粗細(xì)、對齊方式、填充間隙等。
(3)合并單元格
為了實現(xiàn)某些特殊的表格形式,需要合并單元格。PdfPCell類提供了setColspan(int colspan)方法用于合并橫向單元格,參數(shù)colspan為合并的單元格數(shù)。但要合并縱向單元格需要使用嵌套表格的方法。將某個子表加入單元格,且安排單元格所占列數(shù)為子表中列數(shù),則其行跨度也就是子表中的行數(shù)。
由于實際編程時,經(jīng)常出現(xiàn)各類結(jié)構(gòu)的嵌套情形,可以將產(chǎn)生某種結(jié)構(gòu)的表格模塊進(jìn)行封裝,編制成方法,通過傳遞方法參數(shù)完成表格特定模塊的繪制。
例如,可以將生成一個整齊行列表格的代碼編寫成方法。方法返回表格,填充的數(shù)據(jù)通過二維對象數(shù)組傳遞。代碼如下:
public static PdfPTable creatSubTable(Object x[][]){
PdfPTable t= new PdfPTable(x[0].length);
t.getDefaultCell ().setHorizontalAlignment (Element.ALIGN_
CENTER);
for (int k=0;k<x.length;k++) {
for (int j=0;j<x[0].length;j++)
t.addCell(new Phrase(x[k][j].toString(),
FontChinese));
}
return t;
}
以下代碼調(diào)用上述方法,繪制圖1表格中黑框內(nèi)部分:
PdfPTable t2= new PdfPTable(3);
String x1[][]={ {"+601k","10","合格"},{"-601k",
"11","合格"},{"+601k-601k","12","合格"}};
PdfPCell m=new PdfPCell(creatSubTable(x1));
//將創(chuàng)建的子表放入單元格
m.setColspan(3); //單元格占用外層表格的3欄
t2.addCell(m);
2 基于PDF報表模板的報表生成
有些表格具有固定的格式,實際工作中只是給表格填寫數(shù)據(jù)。這類表格可轉(zhuǎn)換為PDF文件格式的報表模板,通過特殊工具在文件中定義若干數(shù)據(jù)域,通過給數(shù)據(jù)域?qū)懭霐?shù)據(jù)實現(xiàn)對報表數(shù)據(jù)的填充處理。它具有格式靈活的特點?;趫蟊砟0宓膱蟊硖幚聿襟E如下:
(1)利用Word制作打印報表;
(2)利用Adobe Acrobat 7.0 Professional將Word文檔轉(zhuǎn)換為PDF格式;
(3)利用Adobe Designer 7.0對PDF進(jìn)行設(shè)計,定義數(shù)據(jù)域;
(4)利用iText組件實現(xiàn)對報表數(shù)據(jù)字段的寫入。
可利用Adobe Designer 7.0導(dǎo)入某個PDF文件進(jìn)行設(shè)計,在任意位置添加文本域。每個文本域有一個綁定的名稱和值,在Java程序中正是通過文本域的名稱訪問文本域?qū)ο蟆?br />
圖2給出了利用Adobe Acrobat 7.0 Professional打開一個制作好的帶數(shù)據(jù)域定義的PDF文檔模板文件的瀏覽界面,出于清晰考慮,圖中特別將數(shù)據(jù)域采用高亮度顯示。
以下給出了打開報表模板實現(xiàn)數(shù)據(jù)寫入的關(guān)鍵代碼:
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.pdf.AcroFields;
import com.itextpdf.text.pdf.PdfReader;
import com.itextpdf.text.pdf.PdfStamper;
……
PdfReader r=new PdfReader("d:\\預(yù)檢模板
(DC600V方式).pdf"); // ①
PdfStamper s=new PdfStamper(r,new FileOutputStream
("d:\\結(jié)果.pdf")); //②
AcroFields form=s.getAcroFields(); // ③
String x[]=detectlog.getYjdata(date,cheNumber,code);
//讀取數(shù)據(jù)庫數(shù)據(jù)
form.setField("日期", x[1]); // ④
form.setField("修規(guī)", x[2]);
……
s.close();
【說明】
①利用PdfReader讀取PDF文檔;通過實例化PdfReader對象來獲取pdf模板,傳入的字符串就是pdf文件所放置的路徑,可以用絕對路徑表示。
②取得對象后,需要用PdfStamper來編輯PdfReader對象,同時獲取一個OutputStream輸出流作為輸出對象。
③利用PdfStamper獲取文件中定義的AcroFields對象。
④用AcroFields對象的setField填寫各個字段的數(shù)據(jù)到表格中。
3 Java打印PDF報表文件
在Web應(yīng)用中要在客戶端打印PDF文檔只需要將文件送客戶瀏覽器顯示,利用瀏覽器客戶端的文件打印功能可實現(xiàn)打印。以下討論在Java應(yīng)用程序中如何打印報表文件。
Java實現(xiàn)報表打印首先要獲取打印服務(wù)對象,然后利用服務(wù)對象開始一個作業(yè)的打印。以下給出了新的JDK1.4以上版本中實現(xiàn)打印的具體步驟和關(guān)鍵代碼。
// ① 構(gòu)建打印請求屬性集
PrintRequestAttributeSet pras = new HashPrintRequest-
AttributeSet();
// ② 設(shè)置打印格式,因為未確定文件類型,
這里選擇AUTOSENSE
DocFlavor flavor=DocFlavor.INPUT_STREAM.AUTOSENSE;
// ③ 查找所有的可用打印服務(wù)
PrintService printService[] = PrintServiceLookup.lookup-
PrintServices(flavor, pras);
// ④ 定位默認(rèn)的打印服務(wù)
PrintService defaultService =
PrintServiceLookup.lookupDefaultPrintService();
// ⑤ 顯示打印對話框
PrintService service = ServiceUI.printDialog(null, 200,
200, printService, defaultService, flavor, pras);
if (service != null) {
DocPrintJob job = service.createPrintJob();
// ⑥創(chuàng)建打印作業(yè)
FileInputStream fis = new FileInputStream(file);
// 假設(shè)file為具體文件對象
DocAttributeSet das = new HashDocAttributeSet();
Doc doc = new SimpleDoc(fis, flavor, das);
// ⑦ 建立打印文件格式
job.print(doc, pras); // ⑧ 進(jìn)行文件的打印
}
本文介紹了利用iText實現(xiàn)PDF報表打印的編程處理方法。分別介紹了報表處理中的兩種典型應(yīng)用。一種是由程序?qū)ο髣討B(tài)產(chǎn)生整個報表,重點介紹了利用PdfPTable等對象實現(xiàn)報表生成處理的技巧。另一種是在已存在的PDF報表文檔中填寫數(shù)據(jù)域完成報表,重點介紹了通過AcroFields對象實現(xiàn)數(shù)據(jù)域的填寫處理。最后給出了Java實現(xiàn)報表打印的控制方法。
參考文獻(xiàn)
[1] 侯金波,王德群.iText API在計量信息管理系統(tǒng)中的應(yīng)用[J].計量與測試技術(shù),2007,34(1):57-60.
[2] 王麗萍,秦永平.基于iText的PDF報表設(shè)計[J].電腦知識與技術(shù),2007(8):493-494.