最近項(xiàng)目中要使用到單據(jù)的打印功能，于是采用了jasper來(lái)實(shí)現(xiàn)這個(gè)feature。由于之前沒(méi)有開(kāi)發(fā)過(guò)類似的功能，做的過(guò)程中也走了一些彎路，并且總結(jié)了一些經(jīng)驗(yàn)，正好記錄下來(lái)。
一、為什么要使用報(bào)表工具進(jìn)行打印
首先，需要打印的內(nèi)容是業(yè)務(wù)表數(shù)據(jù)的一部分，因此牽涉到數(shù)據(jù)查詢，采用報(bào)表對(duì)SQL的支持進(jìn)行查詢是很方便的。
其次，打印一般對(duì)格式要求很高，采用報(bào)表設(shè)計(jì)工具可以很直觀的調(diào)整格式（當(dāng)然，HTML編輯器也有類似功能）。尤其對(duì)于分頁(yè)的報(bào)表，HTML并沒(méi)有直接的對(duì)分頁(yè)進(jìn)行支持，因此可能出現(xiàn)由于頁(yè)邊距的打印設(shè)置問(wèn)題，導(dǎo)致分頁(yè)錯(cuò)亂。
二、JASPER使用示例
a) 報(bào)表設(shè)計(jì)器iReport
iReport是Jasper Report自帶的一個(gè)設(shè)計(jì)器，最牛逼的是，居然也支持Mac平臺(tái)。各項(xiàng)拖拽操作都非常順暢，而且可以顯示虛線來(lái)對(duì)齊（和QQ拼音有兼容問(wèn)題，容易導(dǎo)致Jasper崩潰）。
b) 和Struts2進(jìn)行整合
官方文檔：http://struts.apache.org/2.0.11.2/docs/jasperreports-tutorial.html
不過(guò)官方介紹的是以DataSource的形式傳遞數(shù)據(jù)，也就是在Action中進(jìn)行查詢，然后將查詢結(jié)果傳遞給報(bào)表引擎。但是在后來(lái)的實(shí)踐中，我覺(jué)得這樣做不是很好。
首先，你無(wú)法直接在iReport中預(yù)覽列表結(jié)果，因?yàn)樾枰獋鬟f一個(gè)List對(duì)象（部署到服務(wù)器上再預(yù)覽結(jié)果是很費(fèi)事的）；
其次，在報(bào)表中，我們一般習(xí)慣寫(xiě)SQL語(yǔ)句。至少可以進(jìn)行SQL的優(yōu)化調(diào)整。報(bào)表對(duì)性能的要求與普通應(yīng)用不一樣，基本是固定的數(shù)據(jù)庫(kù)查詢，因此我認(rèn)為使用SQL作為查詢語(yǔ)句是非常合適的。
下面介紹如何在報(bào)表中編寫(xiě)查詢語(yǔ)句：
i. 通過(guò)Struts傳遞數(shù)據(jù)庫(kù)連接
上面兩個(gè)圖中紅色部分，就是如何將數(shù)據(jù)庫(kù)連接傳遞給Jasper引擎的方法。有了數(shù)據(jù)庫(kù)連接，我們就可以在iReport里直接寫(xiě)SQL了。當(dāng)然，這是運(yùn)行時(shí)數(shù)據(jù)庫(kù)的連接傳遞方式。在iReport中，可以直接指定數(shù)據(jù)庫(kù)連接，這個(gè)連接在運(yùn)行時(shí)會(huì)被替換為Struts傳遞過(guò)來(lái)的Connection。
點(diǎn)擊上圖中紅色圓圈處，就可以編輯iReport所使用的數(shù)據(jù)庫(kù)連接。
ii. 我們?cè)倏匆幌?/span>iReport自帶的Query Designer。
這個(gè)Query Designer非常智能，支持你從左側(cè)拖拽表到右側(cè)區(qū)域，勾選需要顯示的列，以及拖拽關(guān)聯(lián)字段建立表之間的關(guān)聯(lián)關(guān)系，自動(dòng)的生成SQL語(yǔ)句（強(qiáng)烈推薦使用）。
其實(shí)Jasper還可以支持很多其他的查詢語(yǔ)言，包括HQL。我這里就不實(shí)驗(yàn)了。因?yàn)槲矣X(jué)得，報(bào)表還是處理關(guān)系數(shù)據(jù)，因此SQL肯定更合適一些。
關(guān)于Jasper各個(gè)Band的功能這里不做介紹。不過(guò)這種區(qū)分對(duì)于報(bào)表開(kāi)發(fā)是非常好的，體現(xiàn)了Jasper對(duì)報(bào)表技術(shù)要求的深入理解和良好設(shè)計(jì)。
iii. 如何格式化數(shù)據(jù)：
上圖的紅色部分，就是Jasper中的表達(dá)式語(yǔ)法。Jasper支持多種表達(dá)式語(yǔ)法，包括Java，Groovy等。尤其是支持java類的調(diào)用。可以看到上圖中就是利用了java的format功能，拼成一個(gè)字符串。
合理的利用表達(dá)式非常重要。因?yàn)檫@種用于顯示的值，使用java這種強(qiáng)類型語(yǔ)言編寫(xiě)非常麻煩，有時(shí)候還要處理異常。而表達(dá)式非常適合這種情況，簡(jiǎn)單，高效，方便修改。因此千萬(wàn)不要將這種代碼寫(xiě)在你的Action里，Action應(yīng)該只負(fù)責(zé)數(shù)據(jù)的加載和保存等，不負(fù)責(zé)數(shù)據(jù)的顯示。
iv. iReport的預(yù)覽功能
點(diǎn)擊上圖的預(yù)覽按鈕，有可能出現(xiàn)下面的參數(shù)輸入界面：
這取決于你的報(bào)表是否需要參數(shù)。當(dāng)然，大部分報(bào)表都需要傳遞查詢參數(shù)。這里你可以輸入一個(gè)有查詢結(jié)果的參數(shù)值，以方便預(yù)覽報(bào)表查詢結(jié)果。
v. 查詢結(jié)果導(dǎo)出
Jasper支持非常多的格式顯示查詢結(jié)果。包括常見(jiàn)的HTML，PDF，EXCEL等等。因此，Jasper也是一個(gè)很好的導(dǎo)出解決方案。
你可以指定Jasper以什么格式輸出結(jié)果，如上圖所示（在Struts應(yīng)用中）。
下面我簡(jiǎn)單解釋一下，為什么要使用PDF來(lái)顯示查詢結(jié)果，而不用常見(jiàn)的HTML。
首先，HTML不支持分頁(yè)。Jasper之所以可以使HTML報(bào)表產(chǎn)生分頁(yè)的效果，是基于對(duì)高度的計(jì)算。但是這個(gè)計(jì)算顯然會(huì)依賴于頁(yè)邊距的設(shè)置。如果頁(yè)邊距不同，那么就可能造成分頁(yè)錯(cuò)誤。而且各個(gè)瀏覽器對(duì)于頁(yè)邊距的默認(rèn)值都是不一樣的，因此很難做到通用（我們不可能給每個(gè)客戶端調(diào)整一下頁(yè)邊距）；
但是PDF對(duì)于分頁(yè)的支持是全面的，而且格式是通用的，在任何PDF瀏覽器中，都不可能產(chǎn)生串頁(yè)的現(xiàn)象。而且現(xiàn)在PDF應(yīng)該也是一個(gè)廣泛接受的標(biāo)準(zhǔn)，客戶機(jī)幾乎不需要任何特別的設(shè)置（對(duì)于沒(méi)有安裝PDF閱讀器的機(jī)器，可能需要安裝一下）。
總結(jié)到這里，以后有了新的想法，還會(huì)更新。下一步將嘗試一下圖表功能以及其他的報(bào)表工具，例如BIRT等。
聯(lián)系客服
