安裝介紹
對于擴展 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)系：
1. 簡單報表
首先，讓我們來看看一個"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ū)В梢苑奖愕奶砑觠dbc驅(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ù)列進(jìn)行處理 |
如：將userid和username，顯示成：userid：username。雙擊row["userid"]，出現(xiàn)"表達(dá)式生成器"，輸入： 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. 選擇需要進(jìn)行排序的列，以及排序方式。
3.計算列：通過"數(shù)據(jù)集編輯器"來完成。進(jìn)入"數(shù)據(jù)集編輯器后"，選擇"計算列"：輸入對應(yīng)的"列名稱"、"數(shù)據(jù)類型"和"表達(dá)式"。
4.報表參數(shù)：它為報表的產(chǎn)生帶來了極大的靈活性。報表參數(shù)一定是與含參數(shù)的查詢對應(yīng)的，否則失去了意義。現(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é)果。
2. 子報表
子報表是另一種最常見的報表，以上為例：列出所有用戶，并列出每個用戶所購買的項目，以及項目數(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)站已明確表示，將在未來的版本中支持它。
3. 統(tǒ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)計圖表。
4. 使用腳本
可以使用腳本，是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ù)集，然后選擇"腳本"，進(jìn)入數(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的幫助文檔。
5. 庫和模板
除了腳本使開發(fā)者可以自定義報表的行為外，BIRT還提供了庫和模板機制來重用設(shè)計，加快報表的開發(fā)。在TheServerSide上有一篇相當(dāng)詳細(xì)的文檔：Using Eclipse BIRT Report Libraries and Templates。
應(yīng)用集成
BIRT與現(xiàn)有應(yīng)用的集成非常簡單，由于BIRT主要是web應(yīng)用，本節(jié)以web應(yīng)用為例進(jìn)行說明。
1. 從Eclipse BIRT官方網(wǎng)站下載birt-runtime-2_0_0.zip。
2. 解壓之后，只需要其中的web view example目錄下的內(nèi)容。
3. 復(fù)制以下第三方軟件包到web view example目錄：
| |
需要的jar文件 |
復(fù)制位置 |
| Apache Axis |
axis.jar
axis-ant.jar
commons-discovery-0.2.jar
jaxrpc.jar
saaj.jar
wsdl4j-1.5.1.jar
|
WEB-INF/Lib |
| iText 1.3 |
itext-1.3.jar |
Plugins/org.eclipse.birt.report.engine.emitter.pdf/lib |
| prototype.js v1.4.0 |
prototype.js v1.4.0 |
ajax/lib |
4. 將web view example目錄發(fā)布到web容器中，如tomcat，改名：birtApp。
5. 啟動tomcat，并訪問birtApp。在首頁中選擇"View Example"，如果成功發(fā)布，系統(tǒng)將提示成功。
6. 發(fā)布設(shè)計完成的報表文件，在birtApp中創(chuàng)建reports目錄，用于存放報表設(shè)計文件。
7. 在應(yīng)用中通過：http://localhost:8080/birtApp/frameset?__report=報表文件路徑，就可以訪問報表了。
這個web應(yīng)用支持2個動作：
- frameset，以frameset的形式顯示報表。這個界面包含一些frame，如頁面導(dǎo)航，報表主體在其中的一個frame中顯示；使用形式：
http://localhost:8080/birtApp/frameset?__report=報表文件路徑&參數(shù)=........
- run，報表以一個單獨的html頁面或pdf顯示，由于這種形式?jīng)]有frmaeset，因此使用者必須自己提供相應(yīng)的參數(shù)，如報表參數(shù)，頁號等。使用形式：
http://localhost:8080/birtApp/run?__report=報表文件路徑&參數(shù)=........
對于以上2個動作，以下列出可用的參數(shù)：
| 選項 |
說明 |
| __format |
報表輸出格式：html或pdf，缺省是html。對于frameset不起作用。 |
| __isnull |
指明一個參數(shù)是null，常用于字符串類型。如果提供參數(shù)且值為空： - 對于日期和數(shù)字類型，BIRT會將它們當(dāng)作null處理。 - 對于字符串，BIRT會將它作為空字符串。因此，為了說明某個字符串是null，通常寫為：__isnull=參數(shù)。 |
| __locale |
本地化選項，缺省是jvm的locale。 |
| __report |
報表設(shè)計文件路徑。 |
| 報表參數(shù) |
報表參數(shù)參數(shù)值對，形式：參數(shù)名=參數(shù)值。對于frameset，直接在地址欄中輸入?yún)?shù)名=參數(shù)值后回車，不會影響報表結(jié)果。雖然，此時選擇"運行報表"時，彈出的參數(shù)值已經(jīng)改變。 |
雖然本節(jié)所說的是針對web應(yīng)用的集成，但是這種方法同樣也可與非web應(yīng)用集成。此時，我們可以采取一種變通的方法：在非web應(yīng)用中使用內(nèi)嵌的web容器，如jetty，也可達(dá)到同樣的效果。這種做法和Eclipse的做法類似。還記得在報表設(shè)計時使用"報表 -> 運行報表"嗎？那個彈出的窗體，實際就是一個web頁面。
結(jié)論
與一些老牌報表軟件相比，BIRT可能仍顯稚嫩。然而，它也不乏其獨到之處，如腳本控制、庫和模板。加之有世界領(lǐng)先的報表廠商Actuate支持，實際上BIRT的ROM（Report Object Model）就是Actuate捐獻(xiàn)的，我們有充分的理由對BIRT的前景表示樂觀。
參考資料