第一部分:使用iReport制作報(bào)表的詳細(xì)過程(Windows環(huán)境下)
提示:在有些板塊,文中的圖片看不到,建議到我的blog瀏覽文章:http://blog.csdn.net/jemlee2002/
文章將會(huì)涉及3個(gè)方面的內(nèi)容:
第一部分:使用iReport制作報(bào)表的詳細(xì)過程(Windows環(huán)境下)
第二部分:使用Jasperreport作為報(bào)表控件開發(fā)胖客戶端報(bào)表應(yīng)用
第三部分:使用Jasperreport作為報(bào)表控件開發(fā)Web報(bào)表應(yīng)用
1、前言
在網(wǎng)絡(luò)上可以搜索到很多使用iReport和Jasperreport配合實(shí)現(xiàn)各種報(bào)表任務(wù)的文章,但是我覺得很少有一篇(幾乎沒有)做一個(gè)比較詳細(xì)的介紹如何使用iReport制作報(bào)表的全過程,我所看過的文章的基本思想是覆蓋面廣,很多內(nèi)容都是提及即過,并不是開發(fā)人員都有時(shí)間為每個(gè)實(shí)踐花費(fèi)時(shí)間自己實(shí)現(xiàn),如果能有更詳細(xì)的資料,那豈不是一件樂事。出于這個(gè)念頭促使我寫這篇文章,希望能對(duì)那些使用iReport和Jasperreport朋友有所幫助,特別是需要親身去實(shí)現(xiàn)報(bào)表的朋友,希望能給你們帶來一點(diǎn)幫助。本文不是對(duì)iReport的每個(gè)細(xì)節(jié)進(jìn)行介紹,關(guān)于iReport的每個(gè)細(xì)節(jié)可以參考iReport網(wǎng)站的資料,但是可能得花費(fèi)一些費(fèi)用。一般用戶沒有必要付出這些費(fèi)用,因?yàn)槲覀冴P(guān)心的是如何制作我們需要的報(bào)表,而不是去擴(kuò)展iReport,比如制作iReport的插件。
2、準(zhǔn)備
2.1、下載JDK
地址:http://www.sun.com,選擇1.3以上版本(建議1.4.2以上版本),安裝JDK,默認(rèn)安裝即可;如果你的系統(tǒng)已經(jīng)有安裝過JDK或是有JRE即可省略這一步驟,驗(yàn)證JDK或是JRE是否可以默認(rèn)運(yùn)行,在命令行(CMD)打入X:>java 如果出現(xiàn):Usage:java………………………..開頭的一堆信息既是通過驗(yàn)證。否則必須進(jìn)行配置,配置信息如下,在windows的環(huán)境變量設(shè)置:
path:在最后面加入“;java的安裝目錄”
JAVA_HOME :“java的安裝目錄”
CLASSPATH:“java的安裝目錄\\bin”
重新驗(yàn)證JDK或是JRE是否可以在CMD任何位置運(yùn)行
2.2、下載iReport
地址:http://ireport.sourceforge.net/,選擇0.3.2版本(發(fā)稿之前為止建議使用的版本)解壓iReport在任意目錄,解壓后的文件里面有一個(gè)iReport.bat,通過雙擊,過大約30秒鐘如果可以彈出iReport的主窗體即表明你的系統(tǒng)已經(jīng)可以運(yùn)行iReport了,如果不能彈出主窗體,一般是第一步驟錯(cuò)誤,或是沒有完成。
2.3、準(zhǔn)備數(shù)據(jù)庫(kù)
iReport支持絕大部分?jǐn)?shù)據(jù)庫(kù),只要該數(shù)據(jù)庫(kù)能提供JDBC驅(qū)動(dòng)器。本文提供MySql數(shù)據(jù)庫(kù)作為例子,但是文章最后會(huì)提到如何配置Oracle的支持。關(guān)于數(shù)據(jù)庫(kù)的安裝和建立表不屬于本文的范圍,請(qǐng)參考其他資料。本文假設(shè)已經(jīng)安裝了MySql和在MySql已經(jīng)有一些表,并且確定表中已經(jīng)有數(shù)據(jù)了。
*【特別提示】MySql的版本要求與iReport文件夾下的Lib目錄的使用MySql驅(qū)動(dòng)程序兼容,筆者建議到http://dev.mysql.com/downloads/下載最新版本mysql的驅(qū)動(dòng)器,這樣就不會(huì)應(yīng)為JDBC驅(qū)動(dòng)器的問題而當(dāng)心數(shù)據(jù)庫(kù)的支持問題。
2.4、啟動(dòng)MySql服務(wù)
確定Mysql使用的的字符集是重要的問題,特別是對(duì)需要中文報(bào)表的朋友,應(yīng)該特別注意這個(gè)問題。
2.5、確定商務(wù)邏輯
?????? 也就是希望完成什么樣的報(bào)表任務(wù)。需要實(shí)現(xiàn)的報(bào)表的詳細(xì)描述,這是實(shí)現(xiàn)報(bào)表的業(yè)務(wù)條件,否則所有的任務(wù)絕大部分沒有意義。本文使用一個(gè)Bug記錄表為例,本文的例子是制作一個(gè)根據(jù)項(xiàng)目和項(xiàng)目中的模塊分組的Bug量統(tǒng)計(jì)。
3、開始配置基本信息
3.1、配置界面使用的語(yǔ)言和報(bào)表輸出路徑
?????? 第一次進(jìn)入系統(tǒng)是英文環(huán)境,可以通過【Tools】-【Options】開啟配置iReport系統(tǒng)的基本信息對(duì)話框。在“Language”選項(xiàng)里面選擇你需要的界面語(yǔ)言,比如“中文-中國(guó)”。點(diǎn)擊【Apply】按鈕,系統(tǒng)既把整個(gè)界面中文化。
?????? 在配置iReport系統(tǒng)的基本信息對(duì)話框中選擇【編譯】Label,之后決定你的報(bào)表輸出路徑,可以把“編譯在報(bào)表數(shù)據(jù)文件夾”選擇打勾,這樣報(bào)表的jrxml文件和jasper文件就放置同一文件夾。(在新建報(bào)表時(shí)會(huì)要求你把jrxml文件保存到指定的文件夾)
【Options】選項(xiàng)中的一部分參數(shù)修改不能通過【Apply】按鈕直接起作用,比如“Look&Feel”,必須重新啟動(dòng)iReport才能起作用。不知道是不是iReport的Bug?!最后【存檔】。
3.2、配置MySql的數(shù)據(jù)庫(kù)連接
?????? 這就是報(bào)表與數(shù)據(jù)庫(kù)的接口。可以通過【資料來源】-【連接/資料來源】開啟配置列表對(duì)話框,iReport會(huì)記錄以前使用的所有連接,除非你手工刪除這些連接,否則所有的連接都會(huì)存在連接/資料來源配置列表對(duì)話框中,不管是否確實(shí)可用。
?????? 點(diǎn)擊【New】進(jìn)入配置新連接界面,如圖:

填寫JDBC連接需要的信息,iReport支持多種數(shù)據(jù)源連接,如圖:

本文只是介紹DataBase JDBC Connection連接方式,這也是最常用的方式,特別是在嵌入式報(bào)表應(yīng)用。所有的信息填寫并測(cè)試通過之后,最后就是保存信息。回到配置列表對(duì)話框,關(guān)閉對(duì)話框,完成MySql數(shù)據(jù)庫(kù)JDBC連接配置。
提示:如果你需要報(bào)表提供中文內(nèi)容顯示可以在JDBC URL下工夫,比如輸入:
jdbc:mysql://localhost/SUBRDB?user=****&password=****&useUnicode=true&characterEncoding=GB2312
其中的****號(hào)替換成數(shù)據(jù)庫(kù)的用戶合密碼。
3.3、新建一個(gè)空?qǐng)?bào)表的基本配置
單擊工具欄的第一個(gè)工具“New Report”,新建一個(gè)報(bào)表,輸入報(bào)表名稱和定義報(bào)表的一些參數(shù),比如名稱輸入BugsRpt(例子是做一個(gè)項(xiàng)目的Bug量統(tǒng)計(jì)報(bào)表),單擊【More….】選擇標(biāo)簽,填寫或是選擇XML編碼,這是關(guān)系到你的XML支持的字符集的選擇,請(qǐng)根據(jù)需要選擇,比如需要你的XML文件支持中文,那么可以輸入GB2312或是GBK,之后點(diǎn)擊【OK】按鈕,進(jìn)入報(bào)表的設(shè)計(jì)界面。
*【特別提示】請(qǐng)?jiān)陂_始任何工作之前保存報(bào)表,這時(shí)iReport提示保存報(bào)表的位置,選擇合適的位置之后輸入BugsRpt作為名稱。
3.4、定義報(bào)表可能需要的字體類型及其屬性
?????? 一個(gè)報(bào)表的內(nèi)容五花八門,有表頭、欄位名、數(shù)據(jù)、其他變量信息等等,如果這些信息都是一致的字體和屬性(比如顏色),那么整個(gè)報(bào)表就死氣沉沉,顯得很粗糙了。我們可以在為報(bào)表添加每個(gè)元素時(shí)定義元素的屬性,但是那是一個(gè)多么費(fèi)時(shí)的工作,如果能預(yù)先定義一些屬性的組合,之后在創(chuàng)建每個(gè)元素時(shí)只需選擇這些組合的其中一個(gè)即可,省事又快速。
?????? 單擊【預(yù)覽】-【報(bào)表字體】開啟自定義組合對(duì)話框。單擊【New】進(jìn)入定義詳細(xì)對(duì)話框,如圖:按照?qǐng)D中的順序填寫信息和步驟,依次定義“表頭”、“組”、“列”、“列內(nèi)容”、“統(tǒng)計(jì)計(jì)算”、“其他”等6中字體組合。注意PDF內(nèi)嵌字體的選擇,如果你需要報(bào)表時(shí)以PDF文件格式提供,那么對(duì)此需要作出選擇。

4、理解幾個(gè)重要的概念
4.1、iReport的輸出格式
iReport的預(yù)覽輸出格式可以支持以下幾種:
PDF、HTML、CSV、JAVA2D、Excel、純文字、JRViewer,其中最常用的是PDF、JRViewer。本文以JRViewer為例子。JRViewer是直接以C/S方式作為報(bào)表的輸出格式,在JFrame框架下輸出。Jasperreport提供默認(rèn)的JRViewer輸出類。
4.2、報(bào)表的動(dòng)態(tài)對(duì)象變量、參數(shù)、字段
在使用iReport的過程中會(huì)碰到很多與變量(Variables)、參數(shù)(Parameters)、字段(Fields)這些有關(guān)的內(nèi)容,我們要介紹這些對(duì)象的使用和意義:
·字段(Fields):是數(shù)據(jù)庫(kù)抽取出來的,希望在報(bào)表中出現(xiàn)的數(shù)據(jù)庫(kù)內(nèi)容。比如一個(gè)ID的所有值。$F{ filedsName }
·參數(shù)(Parameters):這是你的應(yīng)用需要提供給報(bào)表的入口,比如你希望在報(bào)表被解釋的時(shí)候提供Where語(yǔ)句的條件值,那么就可以使用參數(shù)(Parameters)。$P{ parameterName }
·變量(Variables):這是報(bào)表中一些邏輯運(yùn)算的表現(xiàn),比如統(tǒng)計(jì)值。$V{ variablesName }
每種對(duì)象的定義格式如每個(gè)對(duì)象的后面說明,比如定義一個(gè)變量(Variables),那么表達(dá)式就寫成$V{ variablesName },報(bào)表中出現(xiàn)的就是這個(gè)變量的名稱。后文會(huì)詳細(xì)的介紹使用方法。
4.3、編譯、靜態(tài)運(yùn)行、動(dòng)態(tài)運(yùn)行
Jasperreport運(yùn)行時(shí)需要的就是一個(gè)jasper后綴的文件,編譯過程其實(shí)就是把jrxml后綴的文件生成jasper后綴的文件。(可以參考Jasperreport的運(yùn)行原理)
靜態(tài)運(yùn)行和動(dòng)態(tài)運(yùn)行是相對(duì)的,后者帶數(shù)據(jù)源運(yùn)行,比如帶數(shù)據(jù)庫(kù)運(yùn)行。前者就是靜態(tài)文本運(yùn)行,和數(shù)據(jù)源無關(guān),如果報(bào)表中出現(xiàn)和數(shù)據(jù)源有關(guān)的對(duì)象,則以null顯示。
4.4、報(bào)表結(jié)構(gòu)
?????? 一個(gè)報(bào)表的結(jié)構(gòu)大致是幾個(gè)部分:title、pageHeader、columnHeader、detial、columnFooter、pageFooter、summary、groupHeader、groupfooter。
·Title:每個(gè)報(bào)表一般會(huì)有一個(gè)名字,比如×××銷售報(bào)表,title就是擱置這個(gè)名稱的最好地方了,當(dāng)然你也可以根據(jù)需要擱置在合適的地方。
·pageHeader:報(bào)表的一些公共要素,比如頁(yè)碼、創(chuàng)建時(shí)間、創(chuàng)建人等信息放置在這里是比較好的選擇。
·columnHeader:無可非議的這里是放置列的名稱,記住不是列數(shù)據(jù)。
·Detial:放置需要循環(huán)的數(shù)據(jù),比如銷售記錄數(shù)據(jù)。
·columnFooter:放置列級(jí)別的統(tǒng)計(jì)計(jì)算值或是列的說明。
·pageFooter:放置頁(yè)級(jí)別的統(tǒng)計(jì)值或是頁(yè)的說明。
·Summary:可能需要對(duì)幾頁(yè)(你的報(bào)表可能有幾個(gè)頁(yè)組成)的統(tǒng)計(jì)值。比如50個(gè)銷售記錄共占用了3頁(yè),那么放置這些統(tǒng)計(jì)記錄的統(tǒng)計(jì)值最好的地方就是summary。
·groupHeader:每個(gè)表的內(nèi)容可能需要根據(jù)某個(gè)屬性進(jìn)行劃分顯示內(nèi)容和計(jì)算內(nèi)容,比如希望以月份為單位每組分開顯示銷售記錄,那么就可以定義一個(gè)組(組的定義參考后文),groupHeader就是放置組說明或是組標(biāo)志最好的地方。
·Groupfooter:放置組的統(tǒng)計(jì)或是說明
5、向表添加對(duì)象
5.1、添加靜態(tài)對(duì)象
可以通過工具欄的工具添加靜態(tài)對(duì)象,比如文本,點(diǎn)擊【T】,之后在報(bào)表的空白處單擊,如此即可把靜態(tài)對(duì)象添加到報(bào)表,然后拖動(dòng)對(duì)象的邊框,使它的大小合適,雙擊對(duì)象彈出對(duì)象的屬性配置對(duì)話框,切換到【Font】Label,在“Report font”的ComBox選擇“表頭”字體,(表頭字體是前文提供的自定義屬性組合),再切換到【Static Text】Label,修改表頭的名字,比如“Bug統(tǒng)計(jì)報(bào)表”或是“銷售記錄統(tǒng)計(jì)表”等等與業(yè)務(wù)有關(guān)的內(nèi)容。添加圖片,請(qǐng)點(diǎn)擊【Image Tool】,之后的操作與Text類似。其他靜態(tài)對(duì)象操作步驟類似。
5.2、使用連接
?????? 還記得前文提供的(3.2節(jié))配置MySql數(shù)據(jù)庫(kù)連接嗎?這里我們將要使用前文配置的連接了。選擇菜單【建立】-【使用動(dòng)態(tài)連接】開啟可選的動(dòng)態(tài)連接,選擇任何一個(gè)你需要的連接最后【OK】,保存報(bào)表,這樣你的報(bào)表就使用了這個(gè)連接了。
*【特別提示】此連接必須與以后應(yīng)用程序使用的連接一致。
5.3、創(chuàng)建SQL查詢語(yǔ)句
?????? SQL語(yǔ)句是對(duì)任何RDBMS起作用的語(yǔ)言,外部用戶需要使用這些語(yǔ)言管理維護(hù)數(shù)據(jù)庫(kù)中的數(shù)據(jù),同樣的,iReport也是需要這么做,我們需要提供查詢數(shù)據(jù)庫(kù)的語(yǔ)言-SQL語(yǔ)句,這樣,iReport即可通過此SQL語(yǔ)句獲取數(shù)據(jù),之后組織到報(bào)表中并顯示出來,以滿足用戶的需要為目的。
?????? 通過菜單【資料來源】-【報(bào)表查詢】開啟SQL輸入對(duì)話框,并在【Report SQL Query】 Label中輸入SQL語(yǔ)句如圖:圖中的“Automatically Retrieve Fields”checkbox和“ReadFields”Button是確認(rèn)自動(dòng)獲取還是手動(dòng)獲取數(shù)據(jù)庫(kù)表的可用Fields。單擊【OK】,保存報(bào)表。

5.4、創(chuàng)建字段動(dòng)態(tài)對(duì)象
報(bào)表的動(dòng)態(tài)對(duì)象有變量、參數(shù)、字段,前文提及了他們的概念,這里將要一一講解如何使用。
字段也就是數(shù)據(jù)庫(kù)中的字段,通過菜單【預(yù)覽】-【報(bào)表字段】開啟字段的列表(工具條上可以找到相應(yīng)的工具),可以拖放任意字段到報(bào)表的任何位置,比如拖動(dòng)一部分Bug的內(nèi)容字段到detial段(內(nèi)容無關(guān)緊要,只要知道原理)。
5.5、創(chuàng)建組
組是一個(gè)很重要的概念,一個(gè)報(bào)表可以多個(gè)組,每個(gè)組以一個(gè)關(guān)鍵字為標(biāo)記,比如希望Bug統(tǒng)計(jì)是根據(jù)項(xiàng)目(或是產(chǎn)品)進(jìn)行統(tǒng)計(jì)的。那么可以設(shè)立一個(gè)項(xiàng)目標(biāo)記的組。如圖:

組的參數(shù)設(shè)定可以看界面即可理解部分,其中最主要的是“Group expression”,這是必須輸入格式正確的并且存在的字段名稱,本文的“proname”是【字段】中的一個(gè)元素。依此類推,建立其他的組對(duì)象。每建立一個(gè)組,在報(bào)表的界面上都會(huì)出現(xiàn)該組對(duì)應(yīng)的段,如圖:至于他們的意義和容納的內(nèi)容參考“4.4報(bào)表結(jié)構(gòu)”,他們是首尾對(duì)應(yīng)出現(xiàn)的。(Header和Footer)

5.6、添加參數(shù)和使用參數(shù)
我們重申參數(shù)作用,一般是需要外界提供參數(shù)給報(bào)表的入口,比如SQL語(yǔ)句的where條件的表達(dá)式。通過【預(yù)覽】-【報(bào)表參數(shù)】開啟報(bào)表參數(shù)列表對(duì)話框(工具條上可以找到相應(yīng)的工具)。如圖:輸入名稱及其他參數(shù)。【ok】,保存報(bào)表。

那么如何使用呢?打開SQL語(yǔ)句對(duì)話框,參考“5.3創(chuàng)建SQL查詢語(yǔ)句”,這時(shí)候的SQL語(yǔ)句應(yīng)該是:
SELECT *
FROM bugs??where proname=$P{ProjectName} order by proname,modulename
注意其中的紅體字部分,就是把剛才定義的變量運(yùn)用到SQL語(yǔ)句了。這樣當(dāng)應(yīng)用提供參數(shù)時(shí),只要指定提供給這個(gè)參數(shù),那么報(bào)表解釋引擎即可替換這些變量然后再執(zhí)行SQL語(yǔ)句,在第二部分提到編程時(shí),會(huì)提供參數(shù)設(shè)定代碼。
5.7、添加變量和使用變量
變量的定義類似參數(shù),通過【預(yù)覽】-【報(bào)表變量】開啟報(bào)表變量列表對(duì)話框(工具條上可以找到相應(yīng)的工具),如圖,圖中定義的變量的作用是:定義一個(gè)Bug的計(jì)數(shù)器,數(shù)據(jù)類型是java.lang.Integer,使用Count函數(shù)進(jìn)行統(tǒng)計(jì)字段tester,作用范圍是模塊組,也就是統(tǒng)計(jì)模塊的Bug量。其中的tester可以改成其他非組對(duì)象,比如proname是組對(duì)象,就不要用作這里的統(tǒng)計(jì)參數(shù)。以上提供的是自定義變量,其實(shí)iReport系統(tǒng)還有提供一些內(nèi)嵌(Buildin)的變量,比如頁(yè)碼,行記錄數(shù)等,視需要而使用。

6、最后的報(bào)表
6.1、完成后的報(bào)表

6.2、預(yù)覽報(bào)表
點(diǎn)擊動(dòng)態(tài)運(yùn)行報(bào)表,出現(xiàn)如圖內(nèi)容:

7、總結(jié)
第一部分只是介紹了如何制作一個(gè)動(dòng)態(tài)數(shù)據(jù)報(bào)表,其實(shí)iReport還有提供很多的特性供開發(fā)人員使用,比如柱狀圖、餅圖、及各種形狀的圖形等,滿足企業(yè)絕大部分應(yīng)用的需求。希望你能繼續(xù)研究并充分利用。????
????關(guān)于使用Oracle數(shù)據(jù)庫(kù)作為數(shù)據(jù)源的內(nèi)容:提供與使用的Oracle版本對(duì)應(yīng)的JDBC驅(qū)動(dòng),把驅(qū)動(dòng)放置在iReport的lib目錄,配置數(shù)據(jù)庫(kù)的JDBC連接時(shí)如圖:其它操作基本沒有區(qū)別。

8、補(bǔ)充內(nèi)容
8.1、實(shí)現(xiàn)表格
可以在Detial中加入必要線條實(shí)現(xiàn)表格,配合columnFooter、columnHeader、Detial這3個(gè)位置實(shí)現(xiàn),您可以試試畫線的位置!
