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

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

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

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

那么如何使用呢?打開
SQL
語句對話框,參考“
5.3
創(chuàng)建
SQL
查詢語句”,這時候的
SQL
語句應該是:
SELECT *
FROM bugs? where proname=$P{ProjectName} order by proname,modulename
注意其中的紅體字部分,就是把剛才定義的變量運用到SQL語句了。這樣當應用提供參數時,只要指定提供給這個參數,那么報表解釋引擎即可替換這些變量然后再執(zhí)行SQL語句,在第二部分提到編程時,會提供參數設定代碼。
5.7
、添加變量和使用變量
變量的定義類似參數,通過【預覽】-【報表變量】開啟報表變量列表對話框(工具條上可以找到相應的工具),如圖,圖中定義的變量的作用是:定義一個
Bug
的計數器,數據類型是
java.lang.Integer,
使用
Count
函數進行統(tǒng)計字段
tester
,作用范圍是模塊組,也就是統(tǒng)計模塊的
Bug
量。其中的
tester
可以改成其他非組對象,比如
proname
是組對象,就不要用作這里的統(tǒng)計參數。以上提供的是自定義變量,其實iReport系統(tǒng)還有提供一些內嵌(
Buildin
)的變量,比如頁碼,行記錄數等,視需要而使用。
6
、最后的報表
6.1
、完成后的報表
6.2
、預覽報表
?
點擊動態(tài)運行報表,出現如圖內容:
7
、總結
第一部分只是介紹了如何制作一個動態(tài)數據報表,其實
iReport
還有提供很多的特性供開發(fā)人員使用,比如柱狀圖、餅圖、及各種形狀的圖形等,滿足企業(yè)絕大部分應用的需求。希望你能繼續(xù)研究并充分利用。
????
????關于使用
Oracle
數據庫作為數據源的內容:提供與使用的
Oracle
版本對應的
JDBC
驅動,把驅動放置在
iReport
的
lib
目錄,配置數據庫的
JDBC
連接時如圖:其它操作基本沒有區(qū)別。
8、補充內容
8.1、實現表格
可以在Detial中加入必要線條實現表格,配合columnFooter、columnHeader、Detial這3個位置實現,您可以試試畫線的位置!
轉自-阿木Blog