胡鍵 , 西安交通大學碩士

2006 年 3 月 22 日

安裝介紹

對于擴展Eclipse的功能，首先當然就是去下載對應的plugin，BIRT也不能例外。BIRT的下載地址：http://download.eclipse.org/birt/downloads/，當前版本是2.0。BIRT依賴于Eclipse的其它幾個plugin（GEF和EMF），由于我使用的是Eclipse WTP（這是Eclipse的WEB開發工具），在這個工具中那些plugin都已預裝，因此直接下載birt-report-framework- 2_0_0.zip就好了。如果沒有這些plugin，請下載。

下載之后，安裝非常簡單：只需解壓然后將對應的features和plugins目錄中的內容復制到Eclipse對應的目錄下即可。且慢，這只是完成了對于BIRT的基本安裝。下一步就是去下載BIRT需要的第三方軟件包：

自此，BIRT的安裝大功告成。啟動Eclipse，在"project wizard"中會出現一個BIRT的項目類型。

典型使用

在使用之前，了解一些關于BIRT的基本概念，將會對使用非常有益：

• 數據源：數據的來源，或提供者。如xml數據源、jdbc數據源等。
• 數據集：數據集合，它必須與數據源關聯，可以理解為查詢的結果。
• 報表以及報表項，報表可視為是針對一組數據集的表現形式，而報表項這是這個表現形式的某個具體的單元。它們之間的關系，與窗體和控件的關系非常類似。報表、數據集、數據源三者間的關系：數據源 --- 數據集 --- 報表。
• 報表參數：查詢參數的表現形式，使用它可以構建更靈活的報表。
• 模板和庫：主要用于復用報表設計，提高報表開發的效率。

本文中的例子都采用jdbc數據源，這是最常見的使用情形，其中涉及的數據關系是一個典型的多對多關系：

1. 簡單報表

首先，讓我們來看看一個"Hello World"級別的應用："列出所有用戶"，以便可以快速的了解BIRT。為了完成這一任務，我們需要：

A. 通過項目向導，創建BIRT工程。工程創建完畢之后，顯示BIRT的"報表設計"視圖。由于此時沒有報表，其它幾個視圖，如"數據資源管理器"，不可用。

B. 在項目上點鼠標右鍵，選擇："new -> 報表"。在報表類型中，選擇"空白報表"。

C. 創建新報表后，數據視圖可用。在"數據資源管理器"中創建報表所需要的jdbc數據源。根據向導，可以方便的添加jdbc驅動、數據庫url、用戶名和密碼。

D. 在指定的數據源上，創建數據集，這一步完成產生數據集的查詢。在BIRT中支持2種數據集：基于查詢語句和基于存儲過程。在本例中使用前者，對應的查詢語句是：select user.userid, user.username, user.addr from user。

E. 選擇剛剛創建的數據集，將它拖至空白報表頁上。BIRT會自動為其創建一個報表項，此處是"表"。如下圖：

F. 選擇預覽，就可以看到報表運行的實際結果了?；蛟趫蟊砩宵c擊鼠標右鍵，選擇："報表 -> 運行報表"。

非常簡單，一個顯示所有用戶信息的報表就完成了。在此基礎之上，讓我們再來完成一些其它具有挑戰性的任務：

1.格式化：這是一個內容廣泛的主題，常見的需求：

2.排序：一種變通的做法是：將數據集排序之后，如在對應的SQL語句中使用order by，再顯示。除此之外，也可以在報表設計時來完成：

A. 選擇表，此時屬性編輯器下方會出現與表相關的選擇頁。

B. 選擇"排序"，在對應的頁面中選擇"添加"按鈕之后，出現：

C. 選擇需要進行排序的列，以及排序方式。

3.計算列：通過"數據集編輯器"來完成。進入"數據集編輯器后"，選擇"計算列"：輸入對應的"列名稱"、"數據類型"和"表達式"。

4.報表參數：它為報表的產生帶來了極大的靈活性。報表參數一定是與含參數的查詢對應的，否則失去了意義?，F在，將以上需求改為列出"用戶標識大于某一輸入的所有用戶"：

A. 編輯數據集，修改SQL：select user.userid,user.username,user.addr from user where user.userid>?。

B. 在數據集編輯窗體內選擇"參數"，然后輸入對應的"名稱"、"數據類型"、"方向"和"默認值"（必須給出默認值）。其中"方向"表示"輸入"或"輸出"。對于參數，一般選"輸入"。完畢之后：

C. 在"數據資源管理器"視圖，創建報表參數："用戶標識"。

D. 選擇"表"，在"屬性編輯器"中選擇"綁定"。此時，會出現剛才在數據集中定義的參數"id"。在"值"列，選擇報表參數"用戶標識"：

E. 運行報表時，此時會出現報表參數的輸入框，填寫值后即出現報表結果。

本例雖然只定義了一個報表參數，但是BIRT并沒有這樣的限制。我們可以創建多個參數，做法很簡單：首先，查詢有多個參數；定義數據集的參數時，按照查詢中參數出現的順序定義；最后，添加需要的報表參數。

5.分組：以上為例：將用戶按地址分組。

A. 選擇"表"，點擊鼠標右鍵，選擇"插入組"。這里有兩個選擇："在上面"和"在下面"。

B. 選擇任意一種，彈出分組資料窗體。填寫其中的："名稱"和"分組依據"。在本例中，"分組依據"是addr列。

C. 選擇預覽，或運行報表，查看結果。

2. 子報表

子報表是另一種最常見的報表，以上為例：列出所有用戶，并列出每個用戶所購買的項目，以及項目數。為了完成這種父子關系的報表，需要：

A. 創建新報表和數據源。

B. 創建數據集user，使用SQL：select user.userid,user.username,user.addr from user。

C. 創建數據集items，使用SQL：

同時在數據集items上創建參數user，它對應SQL中的參數。

D. 從"Palette"視圖拖入"列表"到報表中，在"屬性編輯器"的"綁定"頁中，選擇數據集為user。它用來顯示主表的信息，在本例中是用戶信息。

E. 從"Palette"視圖拖入"網格"到"列表"的"明細數據"中，設置網格為1行2列，它用來存放"用戶姓名"和"用戶地址"。在"數據資源管理器"視圖，選擇數據集user，將username和addr分別拖入網格的2列中。

F. 在"數據資源管理器"視圖，選擇數據集items，將它拖入"列表"的"明細數據"中，位于剛剛插入的網格下方。此時，BIRT會生成數據集items對應的"表"。

G. 選擇剛剛生成的"表"，在"屬性編輯器"的"綁定"頁中，會出現在items中定義的參數。修改它的值：row["userid"]。于是，父子報表就發生了聯系。

H. 選擇預覽，或運行報表，就可以看到結果了。

很遺憾，到目前為止，另一種最常見的報表"交叉表"還不被BIRT支持。但是，BIRT的官方網站已明確表示，將在未來的版本中支持它。

3. 統計圖表

俗話說，"一圖頂千言"。沒有圖的報表是枯燥，且缺乏表現力的。在本例中，我們將使用圖表來表示：每個用戶的消費總數。

A. 創建新報表和數據源。

B. 創建數據集chart，使用SQL：

C. 從"Palette"視圖拖入"圖表"到報表中，此時會彈出"編輯圖表"窗體。

D. 在"選擇圖表類型"頁，選擇圖表類型為"條形圖"。在"選擇數據"頁，使用數據集chart，同時選中username列，將其拖入"類別x系列"。對于統計列，同樣將其拖入"類別y系列"。在"圖表格式"頁，分別為x和y系列，填寫相應的顯示名稱。

E. 選擇預覽，或運行報表，即可看到統計圖表。

4. 使用腳本

可以使用腳本，是BIRT的一大特色。在BIRT中，數據源、數據集和報表項，都可以書寫腳本。具體做法：選擇數據源、數據集和報表項任意一種對象，然后選擇"腳本"頁面。如選擇數據源user后，對應的腳本輸入頁面：

選擇對應的事件，然后在下方的腳本輸入框中輸入腳本即可。如對于第一個例子，我們需要統計用戶地址是"No.5 St."的用戶數：

A. 選擇數據集，然后選擇"腳本"，進入數據集的腳本編輯窗口。

B. 選擇事件"afterOpen"，在腳本窗口內輸入：count=0;

C. 選擇事件"onFetch"，在腳本窗口內輸入：if( row["addr"]== "No.5 St.") count++;

D. 選擇報表，在腳本窗口選擇事件"onRender"，輸入：this.caption=count;

E. 預覽，或運行報表后，會在報表的標題輸出count的數值。

另外，BIRT也支持使用java來作為報表項的事件處理程序。具體做法，請參見BIRT的幫助文檔。

5. 庫和模板

除了腳本使開發者可以自定義報表的行為外，BIRT還提供了庫和模板機制來重用設計，加快報表的開發。在TheServerSide上有一篇相當詳細的文檔：Using Eclipse BIRT Report Libraries and Templates。

應用集成

BIRT與現有應用的集成非常簡單，由于BIRT主要是web應用，本節以web應用為例進行說明。

1. 從Eclipse BIRT官方網站下載birt-runtime-2_0_0.zip。

2. 解壓之后，只需要其中的web view example目錄下的內容。

3. 復制以下第三方軟件包到web view example目錄：

4. 將web view example目錄發布到web容器中，如tomcat，改名：birtApp。

5. 啟動tomcat，并訪問birtApp。在首頁中選擇"View Example"，如果成功發布，系統將提示成功。

6. 發布設計完成的報表文件，在birtApp中創建reports目錄，用于存放報表設計文件。

7. 在應用中通過：http://localhost:8080/birtApp/frameset?__report=報表文件路徑，就可以訪問報表了。

這個web應用支持2個動作：

• frameset，以frameset的形式顯示報表。這個界面包含一些frame，如頁面導航，報表主體在其中的一個frame中顯示；使用形式：
  http://localhost:8080/birtApp/frameset?__report=報表文件路徑&參數=........
• run，報表以一個單獨的html頁面或pdf顯示，由于這種形式沒有frmaeset，因此使用者必須自己提供相應的參數，如報表參數，頁號等。使用形式：
  http://localhost:8080/birtApp/run?__report=報表文件路徑&參數=........

對于以上2個動作，以下列出可用的參數：

雖然本節所說的是針對web應用的集成，但是這種方法同樣也可與非web應用集成。此時，我們可以采取一種變通的方法：在非web應用中使用內嵌的web容器，如jetty，也可達到同樣的效果。這種做法和Eclipse的做法類似。還記得在報表設計時使用"報表 -> 運行報表"嗎？那個彈出的窗體，實際就是一個web頁面。

結論

與一些老牌報表軟件相比，BIRT可能仍顯稚嫩。然而，它也不乏其獨到之處，如腳本控制、庫和模板。加之有世界領先的報表廠商Actuate支持，實際上 BIRT的ROM（Report Object Model）就是Actuate捐獻的，我們有充分的理由對BIRT的前景表示樂觀。

參考資料

• BIRT官方網站 http://www.eclipse.org/birt/phoenix/
  
  
• BIRT and POJOs as datasources example http://tools.osmosis.gr/blog/archives/2005/06/birt_and_object.html
  
  
• Using Eclipse BIRT Report Libraries and Templates http://www.theserverside.com/articles/article.tss?l=EclipseBRT
  

關于作者