怎樣用iReport制作Web報(bào)表

申請(qǐng)免費(fèi)試用、咨詢電話：400-8352-114

用iReport開(kāi)發(fā)Web報(bào)表功能強(qiáng)大，容易上手使用。由于iReport支持JasperReport，它是純Java程序，所以用于Web的最佳引擎是JSP，首選Tomcat。報(bào)表開(kāi)發(fā)平臺(tái)使用Windows平臺(tái)即可。iReport早期在Windows系統(tǒng)上安裝只要直接解壓即可，而目前最新的版本是1.3.1，可在其官方網(wǎng)站下載http://ireport.sf.net/，支持安裝程序。

安裝時(shí)需要預(yù)先安裝java jre，可打開(kāi)DOS窗口輸入java-version看使用的是哪個(gè)版本的jre。實(shí)用中，安裝Oracle10g客戶端自帶的Java 1.4.2最適合當(dāng)前的iReport版本，使用Jbuilder2006自帶的Java 1.5.0在打開(kāi)某些交叉報(bào)表時(shí)可能出現(xiàn)死機(jī)現(xiàn)象，建議在Windows系統(tǒng)上安裝Java1.4，它支持最新iReport。

iReport開(kāi)發(fā)文檔是收費(fèi)的，雖然網(wǎng)上可找到較多例子供參考，還有完整的簡(jiǎn)單報(bào)表開(kāi)發(fā)指南，稍加研究即可開(kāi)發(fā)簡(jiǎn)單報(bào)表。但如果要開(kāi)發(fā)中小企業(yè)級(jí)各類(lèi)Web報(bào)表，就需要深入研究，反復(fù)測(cè)試了。

在報(bào)表中顯示中文

iReport內(nèi)部使用Unicode UTF-8編碼，設(shè)置正確就可支持所有中文報(bào)表需求。界面選項(xiàng)支持簡(jiǎn)體中文。為了在報(bào)表中顯示中文，在報(bào)表字體或較新版本的Style，選擇宋體字體。為了正確顯示中文，必須安裝亞洲語(yǔ)言包，可以從網(wǎng)上下載iTextAsian.jar考入開(kāi)發(fā)機(jī)iReport安裝目錄／lib之下和服務(wù)器端WEB-INF/lib目錄下。還必須將服務(wù)器端的Java漢化，Java1.4比較麻煩，除拷貝宋體字庫(kù)外，還要修改幾個(gè)屬性文件。Java1.5漢化非常簡(jiǎn)單，只要在jre/lib/fonts下建立fallback目錄，將宋體字庫(kù)考入該目錄即可。為了以PDF格式輸出中文，需要在“PDF Font Name”選項(xiàng)中選擇“STSong-Light”，在中文字體定義中勾選“Default”、“PDF Embedded”，“PDF Encoding”選擇“UniGB-UCS2-H (Chinese Simplified)”。

在報(bào)表中插入圖形

適當(dāng)?shù)牟鍒D在報(bào)表中起到畫(huà)龍點(diǎn)睛作用，可以使枯燥冗長(zhǎng)的數(shù)據(jù)趨勢(shì)、比例等一目了然。iReport內(nèi)置基于jfreechart的Chart Tool工具可以方便繪制常用的柱狀圖、餅圖、曲線圖等，可滿足一般報(bào)表的需求。

如果需要插入靜態(tài)圖片，則要用image工具，要在圖片的“Image Expression”中寫(xiě)圖片文件的絕對(duì)路徑。為了便于在PC上調(diào)試并可用于服務(wù)器，文件路徑應(yīng)寫(xiě)成“$P{imagePath}+文件名”的形式，參數(shù)$P{imagePath}在PC上設(shè)為PC機(jī)上的DOS路徑，注意因?yàn)椤啊笔寝D(zhuǎn)義符號(hào)，DOS路徑的“”要寫(xiě)成“\”。在Web輸出圖片時(shí)將服務(wù)器上的文件路徑作為參數(shù)$P{imagePath}傳遞給輸出程序，就可輸出正確圖片。在以下設(shè)定子報(bào)表絕對(duì)路徑等場(chǎng)合，為了增加靈活性，都需要這樣做。

iReport內(nèi)置的Chart工具并沒(méi)有支持jfreechart的全部功能，繪圖存在局限性，例如，1.2.7之后的版本才實(shí)現(xiàn)標(biāo)記label的旋轉(zhuǎn)，旋轉(zhuǎn)90度可使標(biāo)記字符垂直顯示，以免水平項(xiàng)目過(guò)多時(shí)標(biāo)記顯示重疊在一起而顯示不出來(lái)。又如圖片中的category各個(gè)項(xiàng)目只能是查詢結(jié)果集各個(gè)記錄垂直方向的項(xiàng)目，如果要顯示同一記錄中水平方向各個(gè)項(xiàng)目就無(wú)法繪圖。另外，至今最新版本餅圖還不能顯示百分比。為了顯示更為靈活的圖片，應(yīng)該使用第三方繪圖工具。自行開(kāi)發(fā)jfteechart繪圖程序可解決這些問(wèn)題。jfreeChart也是純Java工具，一般設(shè)計(jì)Servlet用于繪圖，使用image工具，在“Image Expression”中用URL表示對(duì)繪圖程序Servlet的調(diào)用，new java.net.URL(URL?參數(shù))，其中URL繪圖Servlet的調(diào)用路徑，問(wèn)號(hào)后用于傳遞各種繪圖參數(shù)。其中為了正確傳遞中文參數(shù)，中文字符串應(yīng)該使用標(biāo)準(zhǔn)的URL編碼，即定義一個(gè)變量值為java.net.URLEncoder.encode("中文字符串"，"GB2312")，在image的URL中使用變量名傳遞中文。

對(duì)數(shù)據(jù)源的支持

iReport報(bào)表引擎需要從數(shù)據(jù)源獲取報(bào)表中的數(shù)據(jù)。而最基本的查詢數(shù)據(jù)源的方法就是SQL查詢語(yǔ)句，一個(gè)報(bào)表只支持一個(gè)查詢結(jié)果集，設(shè)計(jì)一個(gè)報(bào)表的核心內(nèi)容就是設(shè)計(jì)SQL語(yǔ)句。如果一個(gè)報(bào)表在不同條件使用完全不同的數(shù)據(jù)庫(kù)表查詢語(yǔ)句，一般在報(bào)表程序中形成SQL語(yǔ)句，并查詢得到結(jié)果集，再將所得結(jié)果集傳遞給報(bào)表引擎形成報(bào)表。這樣雖然很靈活，但使報(bào)表程序冗長(zhǎng)復(fù)雜，不便維護(hù)。最好是將SQL寫(xiě)在報(bào)表數(shù)據(jù)源內(nèi)，運(yùn)行時(shí)將數(shù)據(jù)庫(kù)連接和其他必要參數(shù)傳遞給報(bào)表引擎，由報(bào)表引擎執(zhí)行SQL語(yǔ)句并生成報(bào)表。

由于報(bào)表只支持單一結(jié)果集，對(duì)較為復(fù)雜的報(bào)表，SQL語(yǔ)句的設(shè)計(jì)就需要較高技巧。簡(jiǎn)單的參數(shù)如數(shù)字可直接傳遞，在報(bào)表的SQL語(yǔ)句中用參數(shù)表示，如查詢條件where x=$P{y}，實(shí)際使用時(shí)程序中直接將參數(shù)值如“10”傳遞給報(bào)表引擎，執(zhí)行時(shí)就可以當(dāng)做where x=10執(zhí)行。較為復(fù)雜的參數(shù)可用$P!{param}，可用于替代SQL語(yǔ)句的任何部分，如在不同條件下使用不同的字段排序，可在報(bào)表SQL中寫(xiě)order by $P!{y}，實(shí)際使用報(bào)表時(shí)可將實(shí)際的值如“a，b”或“b desc”傳遞給報(bào)表引擎，實(shí)際執(zhí)行時(shí)就當(dāng)做“order by a,b”或“order by b desc”排序子句執(zhí)行，參數(shù)使用是SQL語(yǔ)句靈活支持多種需要的最重要手段。

絕大部分參數(shù)是字符串格式，偶然需要日期格式的參數(shù)，iReport中設(shè)缺省值比較復(fù)雜，如“2007年2月28日”要寫(xiě)成“(new SimpleDateFormat("yyyy-MM-dd")).parse("2003-01-01")”，要使用Java函數(shù)形式，實(shí)際上iReport中所有設(shè)定表達(dá)式都要顯式使用Java函數(shù)。

對(duì)于涉及多個(gè)表查詢的情況，需要使用聯(lián)合查詢語(yǔ)句join和union，join用語(yǔ)橫向聯(lián)結(jié)多個(gè)表，而union用于縱向合并相同結(jié)構(gòu)表的結(jié)果集?？梢允褂米硬樵兗夹g(shù)，即將一個(gè)查詢語(yǔ)句當(dāng)做臨時(shí)表再進(jìn)行查詢，或與其他表聯(lián)合查詢。

通過(guò)以上各種技術(shù)，在各種條件下，最終形成一個(gè)單一數(shù)據(jù)結(jié)果集，形成報(bào)表。對(duì)于報(bào)表各個(gè)記錄來(lái)自完全不同來(lái)源的情況，可考慮使用非SQL基本數(shù)據(jù)源，如可用“JavaBean Data Source”。定義一個(gè)基本類(lèi)，聲明各個(gè)字段類(lèi)型及getXXX（）、setXXX（）方法。測(cè)試報(bào)表時(shí)，建一個(gè)數(shù)據(jù)類(lèi)，用JRBeanCollectionDataSource(list)封裝，其中用list加入測(cè)試數(shù)據(jù)。將class打包考入iReport/lib目錄下，在iReport新建數(shù)據(jù)源，類(lèi)型為JRDataSourceProvider，類(lèi)名為剛才定義的類(lèi)，就可用該類(lèi)提供測(cè)試數(shù)據(jù)測(cè)試報(bào)表。打包時(shí)注意兩點(diǎn)，編譯和打包使用的jar的Java版本要與安裝iReport時(shí)Java版本一致，特別在電腦上裝有多個(gè)版本的Java時(shí)。實(shí)際使用報(bào)表時(shí)，也是使用list先動(dòng)態(tài)填充數(shù)據(jù)，fill報(bào)表時(shí)傳遞數(shù)據(jù)源為new JRBeanCollectionDataSource(list)即可生成動(dòng)態(tài)報(bào)表。

iReport還支持其他數(shù)據(jù)源，一般使用SQL數(shù)據(jù)源就足夠了。

實(shí)現(xiàn)交叉報(bào)表

較為復(fù)雜的報(bào)表需求是交叉報(bào)表和子報(bào)表。

交叉報(bào)表是國(guó)內(nèi)數(shù)據(jù)統(tǒng)計(jì)報(bào)表最常使用的形式之一。通常用于將在數(shù)據(jù)庫(kù)中記錄的數(shù)據(jù)字段按不同分類(lèi)水平匯總顯示。有兩種實(shí)現(xiàn)方式：1.用交叉查詢形成交叉結(jié)果集，最終用簡(jiǎn)單報(bào)表實(shí)現(xiàn)；2.使用iReport的交叉報(bào)表直接實(shí)現(xiàn)。

并非所有數(shù)據(jù)庫(kù)都支持交叉查詢，Oracle10g中通過(guò)sum和decode函數(shù)可以實(shí)現(xiàn)交叉查詢，匯總使用函數(shù)sum(decode(key,KEY1,value,0)) as Field1、sum(decode(key,KEY2,value,0)) as Field2，等等，將具有（…key,value…）形式的簡(jiǎn)單結(jié)果集匯總為有(…Feild1,Field2,…)，其中Field1是按key值為KEY1匯總值， Field2按key值為KEY2匯總值，依次類(lèi)推。iReport可將該交叉結(jié)果集當(dāng)做普通結(jié)果集處理形成交叉報(bào)表形式。

使用iReport的交叉報(bào)表工具，可以制作更為豐富的交叉報(bào)表，過(guò)程較復(fù)雜。要點(diǎn)是，在主報(bào)表的Detail欄目插入crosstable，需要編輯交叉報(bào)表屬性決定交叉報(bào)表內(nèi)容，交叉報(bào)表設(shè)計(jì)決定報(bào)表的外觀。

在主報(bào)表中定義SQL查詢語(yǔ)句，將結(jié)果集傳遞給交叉報(bào)表。這樣就只需要進(jìn)行一次數(shù)據(jù)庫(kù)查詢操作，不過(guò)也只能支持一個(gè)交叉報(bào)表，且不能自動(dòng)繪圖，因?yàn)榻徊鎴?bào)表會(huì)將結(jié)果集的游標(biāo)指向尾部，這樣可滿足單一交叉報(bào)表需要。為實(shí)現(xiàn)上述要求，在交叉報(bào)表屬性中點(diǎn)選“use a dataset to fill the crosstable”，選擇并命名一個(gè)subdataset，并且在連接數(shù)據(jù)源表達(dá)式中輸入系統(tǒng)參數(shù)“$P{REPORT_DATA_SOURCE}”。定義行列分組和Measure。Measure就是交叉報(bào)表需要進(jìn)行匯總的目標(biāo)字段。行列分組寫(xiě)入分組需要依據(jù)的字段，類(lèi)似交叉查詢匯總的key字段，可支持嵌套多重分組，適用多級(jí)樹(shù)型管理分別需要統(tǒng)計(jì)的情況。屬性設(shè)置完畢，就可以使用報(bào)表設(shè)計(jì)，可視化進(jìn)行報(bào)表外觀設(shè)計(jì)，每個(gè)字段或匯總字段的長(zhǎng)度、顏色、線條等，可以做出相當(dāng)專(zhuān)業(yè)的交叉報(bào)表。

實(shí)現(xiàn)子報(bào)表

子報(bào)表也常用于多級(jí)管理的情況，需要知道按最高級(jí)別部門(mén)的統(tǒng)計(jì)數(shù)據(jù)，有時(shí)同時(shí)也需要查看高級(jí)別下屬的按較低級(jí)別部門(mén)的統(tǒng)計(jì)數(shù)據(jù)。與交叉報(bào)表不同的是，子報(bào)表是獨(dú)立的報(bào)表，子報(bào)表還可以嵌套子報(bào)表。在主報(bào)表的detail欄目中插入子報(bào)表，事先子報(bào)表應(yīng)作為獨(dú)立報(bào)表調(diào)試好。主報(bào)表通過(guò)修改子報(bào)表屬性建立聯(lián)系，傳遞數(shù)據(jù)。在subreport中連接數(shù)據(jù)源屬性中選擇“$P{REPORT_CONNECTION”。子報(bào)表通常多達(dá)3級(jí)以上，每級(jí)傳遞數(shù)據(jù)庫(kù)連接說(shuō)明顯示每級(jí)報(bào)表都需要執(zhí)行各自的數(shù)據(jù)庫(kù)查詢，通常認(rèn)為這樣做是低效的。但如果采用數(shù)據(jù)結(jié)果集的話，一次子報(bào)表調(diào)用就將游標(biāo)移至底部，導(dǎo)致主報(bào)表只能顯示一行。如果使用數(shù)據(jù)庫(kù)連接做參數(shù)，各報(bào)表進(jìn)行各自查詢，則沒(méi)有這個(gè)問(wèn)題，而且最后還可以使用自動(dòng)繪圖。其次要指定子報(bào)表絕對(duì)路徑表達(dá)式，為方便調(diào)試和實(shí)際使用，也應(yīng)采用“$P{路徑參數(shù)}+文件名.jasper”的形式。子報(bào)表參數(shù)中填入字段名作為參數(shù)，子報(bào)表將利用這些參數(shù)進(jìn)行它的子查詢，當(dāng)然這些參數(shù)也要在子報(bào)表中有相應(yīng)定義。

最后子報(bào)表的顯示結(jié)果是，每顯示一行主報(bào)表數(shù)據(jù)，就根據(jù)“顯示表達(dá)式”真假值決定是否顯示相應(yīng)的子報(bào)表數(shù)據(jù)，如果含嵌套子報(bào)表，依次類(lèi)推。最后在匯總欄可用主報(bào)表結(jié)果集自動(dòng)繪制圖形。

顯示表達(dá)式

為了制作靈活顯示的報(bào)表，顯示表達(dá)式是必不可少的。例如，多級(jí)子報(bào)表到底顯示哪些級(jí)，同一個(gè)字段在不同的值范圍用不同的顏色字體顯示，這些都需要顯示表達(dá)式。iReport所有的項(xiàng)目都有顯示表達(dá)式“Print When Expression”，顯示表達(dá)式是個(gè)邏輯表達(dá)式，運(yùn)行時(shí)計(jì)算出真假值，決定相應(yīng)項(xiàng)目是否被顯示出來(lái)。例如，常用的報(bào)表中某數(shù)字字段用黑色顯示，超過(guò)預(yù)定值用紅色顯示。需要在相同位置定義兩個(gè)相同的字段，分別顯示黑色和紅色，每個(gè)都設(shè)定顯示表達(dá)式，確定顯示的條件。實(shí)際運(yùn)行時(shí)，可得到彩色報(bào)表，紅色值顯示超過(guò)預(yù)設(shè)范圍的值。

寫(xiě)顯示表達(dá)式的要點(diǎn)是所有值要使用Java的類(lèi)型，所有表達(dá)式內(nèi)的項(xiàng)目都要顯式使用Java函數(shù)，否則容易得到編譯錯(cuò)誤。要求這樣做的原因是iReport編譯選項(xiàng)中缺省使用“JasperReport Default”編譯報(bào)表，運(yùn)算時(shí)使用JasperReport定義的數(shù)據(jù)類(lèi)型，如使用Java編譯器情況可能不同，設(shè)置會(huì)更簡(jiǎn)潔。

輸出例程

每張不同的報(bào)表最后利用iReport產(chǎn)生過(guò)程都是大同小異的。就是根據(jù)程序參數(shù)獲取數(shù)據(jù)源fill報(bào)表，并按程序的要求以各種形式輸出。所以，所有報(bào)表使用公共的報(bào)表輸出程序可以大大簡(jiǎn)化和方便報(bào)表程序的設(shè)計(jì)。

輸出程序要點(diǎn)如下，必須使用Servlet，例如ExportReport為輸出報(bào)表Servlet的名字：

public class ExportReport extends HttpServlet {“key”，value}

缺省JSP報(bào)表程序調(diào)用ExportReport采用GET。不同報(bào)表調(diào)用公用報(bào)表輸出程序，需要將數(shù)據(jù)結(jié)果集和參數(shù)傳遞給ExportReport，GET方式調(diào)用參數(shù)傳遞只能使用會(huì)話對(duì)象，session.setAttribute(“key”,value)，當(dāng)用戶在同一會(huì)話中打開(kāi)多個(gè)報(bào)表或多次以不同參數(shù)打開(kāi)同一報(bào)表時(shí)，參數(shù)就會(huì)相互覆蓋產(chǎn)生錯(cuò)誤，尤其當(dāng)刷新報(bào)表時(shí)，參數(shù)改變會(huì)使用戶看到的報(bào)表不是想要的報(bào)表。

解決多用戶傳遞參數(shù)的辦法是使用請(qǐng)求對(duì)象傳遞參數(shù)request.setAttribute(“key”,value)，則每個(gè)報(bào)表發(fā)出的請(qǐng)求互相沒(méi)有沖突，用戶每次刷新都可得到參數(shù)正確的報(bào)表。在調(diào)用時(shí)，不能使用response.sendRedirect(exportURL)，這樣只能以GET調(diào)用，且無(wú)法傳遞request對(duì)象中的參數(shù)。

輸出HTML圖文報(bào)表

HTML格式輸出是Web程序最基本的要求。在輸出有圖片的報(bào)表時(shí)，使用PDF格式輸出是最好的，HTML很容易出現(xiàn)各種圖片顯示問(wèn)題。根據(jù)網(wǎng)上資料，在早期iReport０.5以前版本HTML輸出圖片沒(méi)有問(wèn)題，從iReport1.1.0到最新的iReport1.3.0，首先必須在報(bào)表輸出Servlet中設(shè)置參數(shù)exporter.setParameter(JRHtmlExporterParameter.IS_OUTPUT_IMAGES_TO_DIR，Boolean.TRUE)，還必須設(shè)置“IMAGES_DIR_NAME”、“IMAGES_URI”參數(shù)，輸出報(bào)表時(shí)才能在上述參數(shù)指定的目錄下生成臨時(shí)圖片文件，用戶在瀏覽器上才能看到圖片。但是問(wèn)題產(chǎn)生了，當(dāng)多用戶以不同參數(shù)使用同一報(bào)表的情況下，臨時(shí)文件名一般是一樣的，用戶看到的報(bào)表數(shù)據(jù)是正確的，但插圖有可能是別人生成的臨時(shí)圖片。

經(jīng)過(guò)深入研究，筆者發(fā)現(xiàn)問(wèn)題出在輸出設(shè)置上，目前幾乎所有資料在輸出HTML格式文件時(shí)，都沿用與輸出PDF格式文件相同的設(shè)置，可通過(guò)以下設(shè)置實(shí)現(xiàn)：

exporter.setParameter(JRExporterParameter.OUTPUT_STREAM，outputStream);

最后動(dòng)作是將jprint文件直接輸出到Servlet的輸出流中，而根據(jù)分析，PDF圖片是在二進(jìn)制輸出流中輸出，而HTML輸出流中對(duì)圖片只是一個(gè)URL引用。圖片雖已作為獨(dú)立文件生成，以二進(jìn)制方式在outputStream輸出HTML文件時(shí)，瀏覽器不能正確掌握引用圖片的時(shí)機(jī)。為了正確輸出圖片，根據(jù)HTML是文本文件的特性，先將HTML文件輸出到一個(gè)字符緩沖區(qū)當(dāng)中，再調(diào)用outputStream.println()方法以字符流方式打印HTML文件，println()函數(shù)以字符方式打印HTML文件，瀏覽器接受到輸出Servlet以println()發(fā)來(lái)的字符行形式的HTML文件時(shí)，可以正確地對(duì)已生成的臨時(shí)圖片文件進(jìn)行引用，從而為用戶顯示出正確插圖的HTML文檔。