幾乎在各種應(yīng)用中,報表都具有其不可替代的作用。各類報表軟件也是爭奇斗艷,如今Eclipse也推出了自己的報表框架:BIRT?,F(xiàn)在,讓我們不妨看看它到底提供了什么樣的功能,以及特點是什么。
對于擴展Eclipse的功能,首先當(dāng)然就是去下載對應(yīng)的plugin,BIRT也不能例外。BIRT的下載地址:
http://download.eclipse.org/birt/downloads/,當(dāng)前版本是2.0。BIRT依賴于Eclipse的其它幾個plugin(GEF和EMF),由于我使用的是Eclipse WTP(這是Eclipse的WEB開發(fā)工具),在這個工具中那些plugin都已預(yù)裝,因此直接下載birt-report-framework-2_0_0.zip就好了。如果沒有這些plugin,請下載。
下載之后,安裝非常簡單:只需解壓然后將對應(yīng)的features和plugins目錄中的內(nèi)容復(fù)制到Eclipse對應(yīng)的目錄下即可。且慢,這只是完成了對于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的安裝大功告成。啟動Eclipse,在"project wizard"中會出現(xiàn)一個BIRT的項目類型。
在使用之前,了解一些關(guān)于BIRT的基本概念,將會對使用非常有益:
數(shù)據(jù)源:數(shù)據(jù)的來源,或提供者。如xml數(shù)據(jù)源、jdbc數(shù)據(jù)源等。
數(shù)據(jù)集:數(shù)據(jù)集合,它必須與數(shù)據(jù)源關(guān)聯(lián),可以理解為查詢的結(jié)果。
報表以及報表項,報表可視為是針對一組數(shù)據(jù)集的表現(xiàn)形式,而報表項這是這個表現(xiàn)形式的某個具體的單元。它們之間的關(guān)系,與窗體和控件的關(guān)系非常類似。報表、數(shù)據(jù)集、數(shù)據(jù)源三者間的關(guān)系:數(shù)據(jù)源 --- 數(shù)據(jù)集 --- 報表。
報表參數(shù):查詢參數(shù)的表現(xiàn)形式,使用它可以構(gòu)建更靈活的報表。
模板和庫:主要用于復(fù)用報表設(shè)計,提高報表開發(fā)的效率。
本文中的例子都采用jdbc數(shù)據(jù)源,這是最常見的使用情形,其中涉及的數(shù)據(jù)關(guān)系是一個典型的多對多關(guān)系:
首先,讓我們來看看一個"Hello World"級別的應(yīng)用:"列出所有用戶",以便可以快速的了解BIRT。為了完成這一任務(wù),我們需要:
A. 通過項目向?qū)?,?chuàng)建BIRT工程。工程創(chuàng)建完畢之后,顯示BIRT的"報表設(shè)計"視圖。由于此時沒有報表,其它幾個視圖,如"數(shù)據(jù)資源管理器",不可用。
B. 在項目上點鼠標(biāo)右鍵,選擇:"new -> 報表"。在報表類型中,選擇"空白報表"。
C. 創(chuàng)建新報表后,數(shù)據(jù)視圖可用。在"數(shù)據(jù)資源管理器"中創(chuàng)建報表所需要的jdbc數(shù)據(jù)源。根據(jù)向?qū)?,可以方便的添加jdbc驅(qū)動、數(shù)據(jù)庫url、用戶名和密碼。
D. 在指定的數(shù)據(jù)源上,創(chuàng)建數(shù)據(jù)集,這一步完成產(chǎn)生數(shù)據(jù)集的查詢。在BIRT中支持2種數(shù)據(jù)集:基于查詢語句和基于存儲過程。在本例中使用前者,對應(yīng)的查詢語句是:select user.userid, user.username, user.addr from user。
E. 選擇剛剛創(chuàng)建的數(shù)據(jù)集,將它拖至空白報表頁上。BIRT會自動為其創(chuàng)建一個報表項,此處是"表"。如下圖:
F. 選擇預(yù)覽,就可以看到報表運行的實際結(jié)果了。或在報表上點擊鼠標(biāo)右鍵,選擇:"報表 -> 運行報表"。
非常簡單,一個顯示所有用戶信息的報表就完成了。在此基礎(chǔ)之上,讓我們再來完成一些其它具有挑戰(zhàn)性的任務(wù):
1.格式化:這是一個內(nèi)容廣泛的主題,常見的需求:
需求 解決辦法(以上為例)
顯示報表列頭為中文 如:將userid顯示為"用戶標(biāo)識"。
選擇"userid",輸入"用戶標(biāo)識"。
設(shè)置報表外觀 選擇對應(yīng)的報表項,通過"屬性編輯器"調(diào)整。
對于報表數(shù)據(jù)列進行處理 如:將userid和username,顯示成:userid:username。雙擊row["userid"],出現(xiàn)"表達式生成器",輸入: row["userid"]+":"+ row["username"]
分頁 選擇"表":在"屬性編輯器"中,選擇"分頁符",在"分頁符間隔"中輸入分頁大小。
頁眉和頁腳 在報表設(shè)計頁,選擇"主頁",在其中設(shè)置頁眉和頁腳。
2.排序:一種變通的做法是:將數(shù)據(jù)集排序之后,如在對應(yīng)的SQL語句中使用order by,再顯示。除此之外,也可以在報表設(shè)計時來完成:
A. 選擇表,此時屬性編輯器下方會出現(xiàn)與表相關(guān)的選擇頁。
B. 選擇"排序",在對應(yīng)的頁面中選擇"添加"按鈕之后,出現(xiàn):
C. 選擇需要進行排序的列,以及排序方式。
3.計算列:通過"數(shù)據(jù)集編輯器"來完成。進入"數(shù)據(jù)集編輯器后",選擇"計算列":輸入對應(yīng)的"列名稱"、"數(shù)據(jù)類型"和"表達式"。
4.報表參數(shù):它為報表的產(chǎn)生帶來了極大的靈活性。報表參數(shù)一定是與含參數(shù)的查詢對應(yīng)的,否則失去了意義?,F(xiàn)在,將以上需求改為列出"用戶標(biāo)識大于某一輸入的所有用戶":
A. 編輯數(shù)據(jù)集,修改SQL:select user.userid,user.username,user.addr from user where user.userid>?。
B. 在數(shù)據(jù)集編輯窗體內(nèi)選擇"參數(shù)",然后輸入對應(yīng)的"名稱"、"數(shù)據(jù)類型"、"方向"和"默認(rèn)值"(必須給出默認(rèn)值)。其中"方向"表示"輸入"或"輸出"。對于參數(shù),一般選"輸入"。完畢之后:
C. 在"數(shù)據(jù)資源管理器"視圖,創(chuàng)建報表參數(shù):"用戶標(biāo)識"。
D. 選擇"表",在"屬性編輯器"中選擇"綁定"。此時,會出現(xiàn)剛才在數(shù)據(jù)集中定義的參數(shù)"id"。在"值"列,選擇報表參數(shù)"用戶標(biāo)識":
E. 運行報表時,此時會出現(xiàn)報表參數(shù)的輸入框,填寫值后即出現(xiàn)報表結(jié)果。
本例雖然只定義了一個報表參數(shù),但是BIRT并沒有這樣的限制。我們可以創(chuàng)建多個參數(shù),做法很簡單:首先,查詢有多個參數(shù);定義數(shù)據(jù)集的參數(shù)時,按照查詢中參數(shù)出現(xiàn)的順序定義;最后,添加需要的報表參數(shù)。
5.分組:以上為例:將用戶按地址分組。
A. 選擇"表",點擊鼠標(biāo)右鍵,選擇"插入組"。這里有兩個選擇:"在上面"和"在下面"。
B. 選擇任意一種,彈出分組資料窗體。填寫其中的:"名稱"和"分組依據(jù)"。在本例中,"分組依據(jù)"是addr列。
C. 選擇預(yù)覽,或運行報表,查看結(jié)果。
子報表是另一種最常見的報表,以上為例:列出所有用戶,并列出每個用戶所購買的項目,以及項目數(shù)。為了完成這種父子關(guān)系的報表,需要:
A. 創(chuàng)建新報表和數(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ù)據(jù)集items上創(chuàng)建參數(shù)user,它對應(yīng)SQL中的參數(shù)。
D. 從"Palette"視圖拖入"列表"到報表中,在"屬性編輯器"的"綁定"頁中,選擇數(shù)據(jù)集為user。它用來顯示主表的信息,在本例中是用戶信息。
E. 從"Palette"視圖拖入"網(wǎng)格"到"列表"的"明細(xì)數(shù)據(jù)"中,設(shè)置網(wǎng)格為1行2列,它用來存放"用戶姓名"和"用戶地址"。在"數(shù)據(jù)資源管理器"視圖,選擇數(shù)據(jù)集user,將username和addr分別拖入網(wǎng)格的2列中。
F. 在"數(shù)據(jù)資源管理器"視圖,選擇數(shù)據(jù)集items,將它拖入"列表"的"明細(xì)數(shù)據(jù)"中,位于剛剛插入的網(wǎng)格下方。此時,BIRT會生成數(shù)據(jù)集items對應(yīng)的"表"。
G. 選擇剛剛生成的"表",在"屬性編輯器"的"綁定"頁中,會出現(xiàn)在items中定義的參數(shù)。修改它的值:row["userid"]。于是,父子報表就發(fā)生了聯(lián)系。
H. 選擇預(yù)覽,或運行報表,就可以看到結(jié)果了。
很遺憾,到目前為止,另一種最常見的報表"交叉表"還不被BIRT支持。但是,BIRT的官方網(wǎng)站已明確表示,將在未來的版本中支持它。
俗話說,"一圖頂千言"。沒有圖的報表是枯燥,且缺乏表現(xiàn)力的。在本例中,我們將使用圖表來表示:每個用戶的消費總數(shù)。
A. 創(chuàng)建新報表和數(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"視圖拖入"圖表"到報表中,此時會彈出"編輯圖表"窗體。
D. 在"選擇圖表類型"頁,選擇圖表類型為"條形圖"。在"選擇數(shù)據(jù)"頁,使用數(shù)據(jù)集chart,同時選中username列,將其拖入"類別x系列"。對于統(tǒng)計列,同樣將其拖入"類別y系列"。在"圖表格式"頁,分別為x和y系列,填寫相應(yīng)的顯示名稱。
E. 選擇預(yù)覽,或運行報表,即可看到統(tǒng)計圖表。
可以使用腳本,是BIRT的一大特色。在BIRT中,數(shù)據(jù)源、數(shù)據(jù)集和報表項,都可以書寫腳本。具體做法:選擇數(shù)據(jù)源、數(shù)據(jù)集和報表項任意一種對象,然后選擇"腳本"頁面。如選擇數(shù)據(jù)源user后,對應(yīng)的腳本輸入頁面:
選擇對應(yīng)的事件,然后在下方的腳本輸入框中輸入腳本即可。如對于第一個例子,我們需要統(tǒng)計用戶地址是"No.5 St."的用戶數(shù):
A. 選擇數(shù)據(jù)集,然后選擇"腳本",進入數(shù)據(jù)集的腳本編輯窗口。
B. 選擇事件"afterOpen",在腳本窗口內(nèi)輸入:count=0;
C. 選擇事件"onFetch",在腳本窗口內(nèi)輸入:if( row["addr"]== "No.5 St.") count++;
D. 選擇報表,在腳本窗口選擇事件"onRender",輸入:this.caption=count;
E. 預(yù)覽,或運行報表后,會在報表的標(biāo)題輸出count的數(shù)值。
另外,BIRT也支持使用java來作為報表項的事件處理程序。具體做法,請參見BIRT的幫助文檔。
除了腳本使開發(fā)者可以自定義報表的行為外,BIRT還提供了庫和模板機制來重用設(shè)計,加快報表的開發(fā)。在TheServerSide上有一篇相當(dāng)詳細(xì)的文檔:
Using Eclipse BIRT Report Libraries and Templates。
其他公司、產(chǎn)品或服務(wù)的名稱可能是其他公司的商標(biāo)或服務(wù)標(biāo)志。
關(guān)于 IBM 隱私條約 聯(lián)系 IBM