幾乎在各種應(yīng)用中,報(bào)表都具有其不可替代的作用。各類報(bào)表軟件也是爭(zhēng)奇斗艷,如今Eclipse也推出了自己的報(bào)表框架:BIRT?,F(xiàn)在,讓我們不妨看看它到底提供了什么樣的功能,以及特點(diǎn)是什么。
安裝介紹
對(duì)于擴(kuò)展Eclipse的功能,首先當(dāng)然就是去下載對(duì)應(yīng)的plugin,BIRT也不能例外。BIRT的下載地址:http://download./birt/downloads/,當(dāng)前版本是2.0。BIRT依賴于Eclipse的其它幾個(gè)plugin(GEF和EMF),由于我使用的是Eclipse WTP(這是Eclipse的WEB開(kāi)發(fā)工具),在這個(gè)工具中那些plugin都已預(yù)裝,因此直接下載birt-report-framework-2_0_0.zip就好了。如果沒(méi)有這些plugin,請(qǐng)下載。
下載之后,安裝非常簡(jiǎn)單:只需解壓然后將對(duì)應(yīng)的features和plugins目錄中的內(nèi)容復(fù)制到Eclipse對(duì)應(yīng)的目錄下即可。且慢,這只是完成了對(duì)于BIRT的基本安裝。下一步就是去下載BIRT需要的第三方軟件包:
|
需要的jar文件 |
復(fù)制位置(都在plugins目錄下) |
Apache Axis |
axis.jar axis-ant.jar commons-discovery-0.2.jar jaxrpc.jar saaj.jar wsdl4j-1.5.1.jar
|
org.eclipse.birt.report.viewer_version/birt/WEB-INF/Lib |
iText 1.3 |
itext-1.3.jar |
org.eclipse.birt.report.engine.emitter.pdf_version/lib |
prototype.js v1.4.0 |
prototype.js v1.4.0 |
org.eclipse.birt.report.viewer_version/birt/ajax/lib |
自此,BIRT的安裝大功告成。啟動(dòng)Eclipse,在"project wizard"中會(huì)出現(xiàn)一個(gè)BIRT的項(xiàng)目類型。
典型使用
在使用之前,了解一些關(guān)于BIRT的基本概念,將會(huì)對(duì)使用非常有益:
- 數(shù)據(jù)源:數(shù)據(jù)的來(lái)源,或提供者。如xml數(shù)據(jù)源、jdbc數(shù)據(jù)源等。
- 數(shù)據(jù)集:數(shù)據(jù)集合,它必須與數(shù)據(jù)源關(guān)聯(lián),可以理解為查詢的結(jié)果。
- 報(bào)表以及報(bào)表項(xiàng),報(bào)表可視為是針對(duì)一組數(shù)據(jù)集的表現(xiàn)形式,而報(bào)表項(xiàng)這是這個(gè)表現(xiàn)形式的某個(gè)具體的單元。它們之間的關(guān)系,與窗體和控件的關(guān)系非常類似。報(bào)表、數(shù)據(jù)集、數(shù)據(jù)源三者間的關(guān)系:數(shù)據(jù)源 --- 數(shù)據(jù)集 --- 報(bào)表。
- 報(bào)表參數(shù):查詢參數(shù)的表現(xiàn)形式,使用它可以構(gòu)建更靈活的報(bào)表。
- 模板和庫(kù):主要用于復(fù)用報(bào)表設(shè)計(jì),提高報(bào)表開(kāi)發(fā)的效率。
本文中的例子都采用jdbc數(shù)據(jù)源,這是最常見(jiàn)的使用情形,其中涉及的數(shù)據(jù)關(guān)系是一個(gè)典型的多對(duì)多關(guān)系:

1. 簡(jiǎn)單報(bào)表
首先,讓我們來(lái)看看一個(gè)"Hello World"級(jí)別的應(yīng)用:"列出所有用戶",以便可以快速的了解BIRT。為了完成這一任務(wù),我們需要:
A. 通過(guò)項(xiàng)目向?qū)?,?chuàng)建BIRT工程。工程創(chuàng)建完畢之后,顯示BIRT的"報(bào)表設(shè)計(jì)"視圖。由于此時(shí)沒(méi)有報(bào)表,其它幾個(gè)視圖,如"數(shù)據(jù)資源管理器",不可用。

B. 在項(xiàng)目上點(diǎn)鼠標(biāo)右鍵,選擇:"new -> 報(bào)表"。在報(bào)表類型中,選擇"空白報(bào)表"。
C. 創(chuàng)建新報(bào)表后,數(shù)據(jù)視圖可用。在"數(shù)據(jù)資源管理器"中創(chuàng)建報(bào)表所需要的jdbc數(shù)據(jù)源。根據(jù)向?qū)?,可以方便的添加jdbc驅(qū)動(dòng)、數(shù)據(jù)庫(kù)url、用戶名和密碼。
D. 在指定的數(shù)據(jù)源上,創(chuàng)建數(shù)據(jù)集,這一步完成產(chǎn)生數(shù)據(jù)集的查詢。在BIRT中支持2種數(shù)據(jù)集:基于查詢語(yǔ)句和基于存儲(chǔ)過(guò)程。在本例中使用前者,對(duì)應(yīng)的查詢語(yǔ)句是:select user.userid, user.username, user.addr from user 。
E. 選擇剛剛創(chuàng)建的數(shù)據(jù)集,將它拖至空白報(bào)表頁(yè)上。BIRT會(huì)自動(dòng)為其創(chuàng)建一個(gè)報(bào)表項(xiàng),此處是"表"。如下圖:

F. 選擇預(yù)覽,就可以看到報(bào)表運(yùn)行的實(shí)際結(jié)果了。或在報(bào)表上點(diǎn)擊鼠標(biāo)右鍵,選擇:"報(bào)表 -> 運(yùn)行報(bào)表"。
非常簡(jiǎn)單,一個(gè)顯示所有用戶信息的報(bào)表就完成了。在此基礎(chǔ)之上,讓我們?cè)賮?lái)完成一些其它具有挑戰(zhàn)性的任務(wù):
1.格式化:這是一個(gè)內(nèi)容廣泛的主題,常見(jiàn)的需求:
需求 |
解決辦法(以上為例) |
顯示報(bào)表列頭為中文 |
如:將userid顯示為"用戶標(biāo)識(shí)"。 選擇"userid",輸入"用戶標(biāo)識(shí)"。 |
設(shè)置報(bào)表外觀 |
選擇對(duì)應(yīng)的報(bào)表項(xiàng),通過(guò)"屬性編輯器"調(diào)整。 |
對(duì)于報(bào)表數(shù)據(jù)列進(jìn)行處理 |
如:將userid和username,顯示成:userid:username。雙擊row["userid"],出現(xiàn)"表達(dá)式生成器",輸入: row["userid"]+":"+ row["username"] |
分頁(yè) |
選擇"表":在"屬性編輯器"中,選擇"分頁(yè)符",在"分頁(yè)符間隔"中輸入分頁(yè)大小。 |
頁(yè)眉和頁(yè)腳 |
在報(bào)表設(shè)計(jì)頁(yè),選擇"主頁(yè)",在其中設(shè)置頁(yè)眉和頁(yè)腳。 |
2.排序:一種變通的做法是:將數(shù)據(jù)集排序之后,如在對(duì)應(yīng)的SQL語(yǔ)句中使用order by,再顯示。除此之外,也可以在報(bào)表設(shè)計(jì)時(shí)來(lái)完成:
A. 選擇表,此時(shí)屬性編輯器下方會(huì)出現(xiàn)與表相關(guān)的選擇頁(yè)。

B. 選擇"排序",在對(duì)應(yīng)的頁(yè)面中選擇"添加"按鈕之后,出現(xiàn):

C. 選擇需要進(jìn)行排序的列,以及排序方式。
3.計(jì)算列:通過(guò)"數(shù)據(jù)集編輯器"來(lái)完成。進(jìn)入"數(shù)據(jù)集編輯器后",選擇"計(jì)算列":輸入對(duì)應(yīng)的"列名稱"、"數(shù)據(jù)類型"和"表達(dá)式"。
4.報(bào)表參數(shù):它為報(bào)表的產(chǎn)生帶來(lái)了極大的靈活性。報(bào)表參數(shù)一定是與含參數(shù)的查詢對(duì)應(yīng)的,否則失去了意義?,F(xiàn)在,將以上需求改為列出"用戶標(biāo)識(shí)大于某一輸入的所有用戶":
A. 編輯數(shù)據(jù)集,修改SQL:select user.userid,user.username,user.addr from user where user.userid>? 。
B. 在數(shù)據(jù)集編輯窗體內(nèi)選擇"參數(shù)",然后輸入對(duì)應(yīng)的"名稱"、"數(shù)據(jù)類型"、"方向"和"默認(rèn)值"(必須給出默認(rèn)值)。其中"方向"表示"輸入"或"輸出"。對(duì)于參數(shù),一般選"輸入"。完畢之后:

C. 在"數(shù)據(jù)資源管理器"視圖,創(chuàng)建報(bào)表參數(shù):"用戶標(biāo)識(shí)"。
D. 選擇"表",在"屬性編輯器"中選擇"綁定"。此時(shí),會(huì)出現(xiàn)剛才在數(shù)據(jù)集中定義的參數(shù)"id"。在"值"列,選擇報(bào)表參數(shù)"用戶標(biāo)識(shí)":

E. 運(yùn)行報(bào)表時(shí),此時(shí)會(huì)出現(xiàn)報(bào)表參數(shù)的輸入框,填寫(xiě)值后即出現(xiàn)報(bào)表結(jié)果。
本例雖然只定義了一個(gè)報(bào)表參數(shù),但是BIRT并沒(méi)有這樣的限制。我們可以創(chuàng)建多個(gè)參數(shù),做法很簡(jiǎn)單:首先,查詢有多個(gè)參數(shù);定義數(shù)據(jù)集的參數(shù)時(shí),按照查詢中參數(shù)出現(xiàn)的順序定義;最后,添加需要的報(bào)表參數(shù)。
5.分組:以上為例:將用戶按地址分組。
A. 選擇"表",點(diǎn)擊鼠標(biāo)右鍵,選擇"插入組"。這里有兩個(gè)選擇:"在上面"和"在下面"。
B. 選擇任意一種,彈出分組資料窗體。填寫(xiě)其中的:"名稱"和"分組依據(jù)"。在本例中,"分組依據(jù)"是addr列。
C. 選擇預(yù)覽,或運(yùn)行報(bào)表,查看結(jié)果。
2. 子報(bào)表
子報(bào)表是另一種最常見(jiàn)的報(bào)表,以上為例:列出所有用戶,并列出每個(gè)用戶所購(gòu)買的項(xiàng)目,以及項(xiàng)目數(shù)。為了完成這種父子關(guān)系的報(bào)表,需要:
A. 創(chuàng)建新報(bào)表和數(shù)據(jù)源。
B. 創(chuàng)建數(shù)據(jù)集user,使用SQL:select user.userid,user.username,user.addr from user。
C. 創(chuàng)建數(shù)據(jù)集items,使用SQL:
select item.itemid,item.itemdesc,item.price,user_item.count from item,user_item
where item.itemid= user_item.itemid
and user_item.userid= ?
|
同時(shí)在數(shù)據(jù)集items上創(chuàng)建參數(shù)user,它對(duì)應(yīng)SQL中的參數(shù)。
D. 從"Palette"視圖拖入"列表"到報(bào)表中,在"屬性編輯器"的"綁定"頁(yè)中,選擇數(shù)據(jù)集為user。它用來(lái)顯示主表的信息,在本例中是用戶信息。
E. 從"Palette"視圖拖入"網(wǎng)格"到"列表"的"明細(xì)數(shù)據(jù)"中,設(shè)置網(wǎng)格為1行2列,它用來(lái)存放"用戶姓名"和"用戶地址"。在"數(shù)據(jù)資源管理器"視圖,選擇數(shù)據(jù)集user,將username和addr分別拖入網(wǎng)格的2列中。
F. 在"數(shù)據(jù)資源管理器"視圖,選擇數(shù)據(jù)集items,將它拖入"列表"的"明細(xì)數(shù)據(jù)"中,位于剛剛插入的網(wǎng)格下方。此時(shí),BIRT會(huì)生成數(shù)據(jù)集items對(duì)應(yīng)的"表"。
G. 選擇剛剛生成的"表",在"屬性編輯器"的"綁定"頁(yè)中,會(huì)出現(xiàn)在items中定義的參數(shù)。修改它的值:row["userid"]。于是,父子報(bào)表就發(fā)生了聯(lián)系。
H. 選擇預(yù)覽,或運(yùn)行報(bào)表,就可以看到結(jié)果了。
很遺憾,到目前為止,另一種最常見(jiàn)的報(bào)表"交叉表"還不被BIRT支持。但是,BIRT的官方網(wǎng)站已明確表示,將在未來(lái)的版本中支持它。
3. 統(tǒng)計(jì)圖表
俗話說(shuō),"一圖頂千言"。沒(méi)有圖的報(bào)表是枯燥,且缺乏表現(xiàn)力的。在本例中,我們將使用圖表來(lái)表示:每個(gè)用戶的消費(fèi)總數(shù)。
A. 創(chuàng)建新報(bào)表和數(shù)據(jù)源。
B. 創(chuàng)建數(shù)據(jù)集chart,使用SQL:
select user.username,round(sum(item.price*user_item.count),2)
from item, user_item, user
where item.itemid= user_item.itemid
and user.userid= user_item.userid
group by user.username
|
C. 從"Palette"視圖拖入"圖表"到報(bào)表中,此時(shí)會(huì)彈出"編輯圖表"窗體。
D. 在"選擇圖表類型"頁(yè),選擇圖表類型為"條形圖"。在"選擇數(shù)據(jù)"頁(yè),使用數(shù)據(jù)集chart,同時(shí)選中username列,將其拖入"類別x系列"。對(duì)于統(tǒng)計(jì)列,同樣將其拖入"類別y系列"。在"圖表格式"頁(yè),分別為x和y系列,填寫(xiě)相應(yīng)的顯示名稱。
E. 選擇預(yù)覽,或運(yùn)行報(bào)表,即可看到統(tǒng)計(jì)圖表。
4. 使用腳本
可以使用腳本,是BIRT的一大特色。在BIRT中,數(shù)據(jù)源、數(shù)據(jù)集和報(bào)表項(xiàng),都可以書(shū)寫(xiě)腳本。具體做法:選擇數(shù)據(jù)源、數(shù)據(jù)集和報(bào)表項(xiàng)任意一種對(duì)象,然后選擇"腳本"頁(yè)面。如選擇數(shù)據(jù)源user后,對(duì)應(yīng)的腳本輸入頁(yè)面:

選擇對(duì)應(yīng)的事件,然后在下方的腳本輸入框中輸入腳本即可。如對(duì)于第一個(gè)例子,我們需要統(tǒng)計(jì)用戶地址是"No.5 St."的用戶數(shù):
A. 選擇數(shù)據(jù)集,然后選擇"腳本",進(jìn)入數(shù)據(jù)集的腳本編輯窗口。
B. 選擇事件"afterOpen",在腳本窗口內(nèi)輸入:count=0;
C. 選擇事件"onFetch",在腳本窗口內(nèi)輸入:if( row["addr"]== "No.5 St.") count++;
D. 選擇報(bào)表,在腳本窗口選擇事件"onRender",輸入:this.caption=count;
E. 預(yù)覽,或運(yùn)行報(bào)表后,會(huì)在報(bào)表的標(biāo)題輸出count的數(shù)值。
另外,BIRT也支持使用java來(lái)作為報(bào)表項(xiàng)的事件處理程序。具體做法,請(qǐng)參見(jiàn)BIRT的幫助文檔。
5. 庫(kù)和模板
除了腳本使開(kāi)發(fā)者可以自定義報(bào)表的行為外,BIRT還提供了庫(kù)和模板機(jī)制來(lái)重用設(shè)計(jì),加快報(bào)表的開(kāi)發(fā)。在TheServerSide上有一篇相當(dāng)詳細(xì)的文檔:Using Eclipse BIRT Report Libraries and Templates。
|