最近項目中要使用到單據的打印功能,于是采用了jasper來(lái)實(shí)現這個(gè)feature。由于之前沒(méi)有開(kāi)發(fā)過(guò)類(lèi)似的功能,做的過(guò)程中也走了一些彎路,并且總結了一些經(jīng)驗,正好記錄下來(lái)。
一、為什么要使用報表工具進(jìn)行打印
首先,需要打印的內容是業(yè)務(wù)表數據的一部分,因此牽涉到數據查詢(xún),采用報表對SQL的支持進(jìn)行查詢(xún)是很方便的。
其次,打印一般對格式要求很高,采用報表設計工具可以很直觀(guān)的調整格式(當然,HTML編輯器也有類(lèi)似功能)。尤其對于分頁(yè)的報表,HTML并沒(méi)有直接的對分頁(yè)進(jìn)行支持,因此可能出現由于頁(yè)邊距的打印設置問(wèn)題,導致分頁(yè)錯亂。
二、JASPER使用示例
a) 報表設計器iReport
iReport是Jasper Report自帶的一個(gè)設計器,最牛逼的是,居然也支持Mac平臺。各項拖拽操作都非常順暢,而且可以顯示虛線(xiàn)來(lái)對齊(和QQ拼音有兼容問(wèn)題,容易導致Jasper崩潰)。
b) 和Struts2進(jìn)行整合
官方文檔:http://struts.apache.org/2.0.11.2/docs/jasperreports-tutorial.html
不過(guò)官方介紹的是以DataSource的形式傳遞數據,也就是在Action中進(jìn)行查詢(xún),然后將查詢(xún)結果傳遞給報表引擎。但是在后來(lái)的實(shí)踐中,我覺(jué)得這樣做不是很好。
首先,你無(wú)法直接在iReport中預覽列表結果,因為需要傳遞一個(gè)List對象(部署到服務(wù)器上再預覽結果是很費事的);
其次,在報表中,我們一般習慣寫(xiě)SQL語(yǔ)句。至少可以進(jìn)行SQL的優(yōu)化調整。報表對性能的要求與普通應用不一樣,基本是固定的數據庫查詢(xún),因此我認為使用SQL作為查詢(xún)語(yǔ)句是非常合適的。
下面介紹如何在報表中編寫(xiě)查詢(xún)語(yǔ)句:
i. 通過(guò)Struts傳遞數據庫連接
上面兩個(gè)圖中紅色部分,就是如何將數據庫連接傳遞給Jasper引擎的方法。有了數據庫連接,我們就可以在iReport里直接寫(xiě)SQL了。當然,這是運行時(shí)數據庫的連接傳遞方式。在iReport中,可以直接指定數據庫連接,這個(gè)連接在運行時(shí)會(huì )被替換為Struts傳遞過(guò)來(lái)的Connection。
點(diǎn)擊上圖中紅色圓圈處,就可以編輯iReport所使用的數據庫連接。
ii. 我們再看一下iReport自帶的Query Designer。
這個(gè)Query Designer非常智能,支持你從左側拖拽表到右側區域,勾選需要顯示的列,以及拖拽關(guān)聯(lián)字段建立表之間的關(guān)聯(lián)關(guān)系,自動(dòng)的生成SQL語(yǔ)句(強烈推薦使用)。

其實(shí)Jasper還可以支持很多其他的查詢(xún)語(yǔ)言,包括HQL。我這里就不實(shí)驗了。因為我覺(jué)得,報表還是處理關(guān)系數據,因此SQL肯定更合適一些。
關(guān)于Jasper各個(gè)Band的功能這里不做介紹。不過(guò)這種區分對于報表開(kāi)發(fā)是非常好的,體現了Jasper對報表技術(shù)要求的深入理解和良好設計。
iii. 如何格式化數據:

上圖的紅色部分,就是Jasper中的表達式語(yǔ)法。Jasper支持多種表達式語(yǔ)法,包括Java,Groovy等。尤其是支持java類(lèi)的調用??梢钥吹缴蠄D中就是利用了java的format功能,拼成一個(gè)字符串。
合理的利用表達式非常重要。因為這種用于顯示的值,使用java這種強類(lèi)型語(yǔ)言編寫(xiě)非常麻煩,有時(shí)候還要處理異常。而表達式非常適合這種情況,簡(jiǎn)單,高效,方便修改。因此千萬(wàn)不要將這種代碼寫(xiě)在你的Action里,Action應該只負責數據的加載和保存等,不負責數據的顯示。
iv. iReport的預覽功能

點(diǎn)擊上圖的預覽按鈕,有可能出現下面的參數輸入界面:

這取決于你的報表是否需要參數。當然,大部分報表都需要傳遞查詢(xún)參數。這里你可以輸入一個(gè)有查詢(xún)結果的參數值,以方便預覽報表查詢(xún)結果。
v. 查詢(xún)結果導出
Jasper支持非常多的格式顯示查詢(xún)結果。包括常見(jiàn)的HTML,PDF,EXCEL等等。因此,Jasper也是一個(gè)很好的導出解決方案。

你可以指定Jasper以什么格式輸出結果,如上圖所示(在Struts應用中)。
下面我簡(jiǎn)單解釋一下,為什么要使用PDF來(lái)顯示查詢(xún)結果,而不用常見(jiàn)的HTML。
首先,HTML不支持分頁(yè)。Jasper之所以可以使HTML報表產(chǎn)生分頁(yè)的效果,是基于對高度的計算。但是這個(gè)計算顯然會(huì )依賴(lài)于頁(yè)邊距的設置。如果頁(yè)邊距不同,那么就可能造成分頁(yè)錯誤。而且各個(gè)瀏覽器對于頁(yè)邊距的默認值都是不一樣的,因此很難做到通用(我們不可能給每個(gè)客戶(hù)端調整一下頁(yè)邊距);
但是PDF對于分頁(yè)的支持是全面的,而且格式是通用的,在任何PDF瀏覽器中,都不可能產(chǎn)生串頁(yè)的現象。而且現在PDF應該也是一個(gè)廣泛接受的標準,客戶(hù)機幾乎不需要任何特別的設置(對于沒(méi)有安裝PDF閱讀器的機器,可能需要安裝一下)。
總結到這里,以后有了新的想法,還會(huì )更新。下一步將嘗試一下圖表功能以及其他的報表工具,例如BIRT等。
聯(lián)系客服