【正文】 iReport用戶(hù)手冊(cè)目錄 Giulio Toffoli 11 序言 6什么是iReport? 6功能特點(diǎn)： 7iReport 社區(qū)： 7鳴謝： 82 入門(mén) 8必要條件： 8下載： 9編譯iReport： 9基本的配置： 9創(chuàng)建JDBC連接： 12第一個(gè)報(bào)表： 13命令行選項(xiàng)： 173 JasperReports基礎(chǔ)概念 17JasperReports 17報(bào)表生命周期： 18Jrxml源代碼和jasper文件： 18數(shù)據(jù)源和打印格式： 22版本兼容性： 23表達(dá)式： 24一個(gè)簡(jiǎn)單的程序： 254 報(bào)表結(jié)構(gòu) 26Bands 26Title 27Page header 27Column header 27Group header 28Detail 28Group footer 28Column footer 28Page footer 28Last Page footer 28Summary 29Background 29報(bào)表屬性： 29列 30高級(jí)選項(xiàng)： 32腳本： 32更多… 33Title on a new page選項(xiàng)： 33Summary on a new page選項(xiàng)： 35Floating column footer 選項(xiàng)： 35打印順序： 35無(wú)數(shù)據(jù)打?。ㄈ绻麤](méi)有數(shù)據(jù)時(shí)）： 36i18n： 36Resource Bundle Base name 36XML源文件的編碼設(shè)置： 375 報(bào)表元素 37選擇并插入元素到報(bào)表中： 37布置和元素順序 40使用元素樹(shù)管理元素： 43基本屬性： 43線 46矩形 46橢圓 47圖象 47文本元素 50靜態(tài)文本 51文本域 51子報(bào)表 55專(zhuān)用元素 56圖表 56條形碼 56超連接 58Reference 59LocalAnchor 59LocalPage 59RemoteAnchor 59RemotePage 596 字體 59字體 59擴(kuò)展字體 60編碼 61使用Unicode字符 61報(bào)表字體 617 字段，參數(shù)和變量 62字段 62SQL查詢(xún)的字段注冊(cè) 63JavaBean的字段注冊(cè) 64JRExtendedBeanDataSource的字段注冊(cè) 65字段和文本域 65參數(shù) 66在查詢(xún)中使用參數(shù) 67使用程序傳遞參數(shù) 67內(nèi)置參數(shù) 69變量 69內(nèi)置變量 718 Bands and groups 71Bands 71Groups 729 Subreport 77創(chuàng)建子報(bào)表 78連接子報(bào)表到父報(bào)表 78參數(shù)的通道 78指定數(shù)據(jù)源 79指定子報(bào)表 80一步一步舉例 80返回參數(shù) 8610 數(shù)據(jù)源 87iReport中的數(shù)據(jù)源 88JDBC連接 89ClassNotFoundException 91URL不正確 91連接參數(shù)不正確 91使用JDBC連接 91字段注冊(cè) 92JRDataSource接口 93JavaBean作為數(shù)據(jù)源 93JavaBean的一個(gè)字段作為數(shù)據(jù)源 95XML數(shù)據(jù)源 96字段的注冊(cè) 98XML和子報(bào)表 100CSV數(shù)據(jù)源 104字段的注冊(cè) 105JREmptyDataSource 105實(shí)現(xiàn)一個(gè)新的JRDataSource 106用iReport實(shí)現(xiàn)個(gè)性化的JRDataSource 108JavaBean Extended數(shù)據(jù)源 11011 國(guó)際化 111Resource Bundle Base Name 111恢復(fù)本地化字符串 113格式化消息 114配置本地化報(bào)表 11412 腳本 115JRAbstractScriptlet類(lèi) 115iReport處理腳本 117用腳本部署報(bào)表 11813 模板 119模版結(jié)構(gòu)： 119使用通用模板 12114 圖表 123創(chuàng)建一個(gè)簡(jiǎn)單的圖表 123級(jí)Series 128自動(dòng)級(jí) 129手動(dòng)級(jí) 130圖表類(lèi)型和屬性 132餅圖 1333D餅圖 133柱狀圖 1343D柱狀圖 136線圖 136區(qū)域圖 13715 插件和附加工具 137插件結(jié)構(gòu)XML文件 138 139大型編譯器插件 142文本向?qū)Р寮?14416 常規(guī)問(wèn)題解決方案 145打印百分比 145計(jì)算組的發(fā)生數(shù) 146分離detail 148插入一個(gè)頁(yè) 149交叉報(bào)表 152使用多重連接找回?cái)?shù)據(jù) 152如何使用存儲(chǔ)過(guò)程 1531 序言什么是iReport?iReport是一個(gè)能夠創(chuàng)建復(fù)雜報(bào)表的開(kāi)源項(xiàng)目，并且它能調(diào)用JasperReports庫(kù)應(yīng)用于任何一種java應(yīng)用程序。本身是分布式的且由符合GNU通用公共許可的百分之百純java編寫(xiě)。由于它豐富的圖形界面，你能夠很快的創(chuàng)建出任何一種你想要的報(bào)表。iReport能夠讓我們提高技術(shù)方面的信心，比如它能降低學(xué)習(xí)JasperReports的XML語(yǔ)法的難度，而且能夠?yàn)槭炀毜募夹g(shù)人員節(jié)省大量的時(shí)間并能開(kāi)發(fā)出非常精細(xì)的報(bào)表。，而是用Visual J++；因此這些版本都只能在微軟的Windows 系統(tǒng)運(yùn)行， J++的開(kāi)發(fā)。我的任務(wù)就將最新的版本的iReport介紹給大家，因此，我不可能應(yīng)用老的版本講解。 功能特點(diǎn)：以下將列出iRreport的一些比較突出的功能：? 百分之九十九支持JasperReports XML標(biāo)簽? 所見(jiàn)即所得的報(bào)表編輯器，也就是說(shuō)它具有創(chuàng)建矩形，線，橢圓，正文區(qū)域，標(biāo)簽，圖表，子報(bào)表，條碼等完善的工具圖標(biāo)供使用。? 嵌入式編輯器帶有燈泡提示代碼規(guī)則? 支持Unicode和非拉丁語(yǔ)言（俄文，中文，日文，韓文…） ? 文檔結(jié)構(gòu)瀏覽器? 完善的報(bào)表編譯器和輸出器? 支持所有可以通過(guò)JDBC連接的數(shù)據(jù)庫(kù)? 支持所有有效的數(shù)據(jù)源? 自動(dòng)報(bào)表創(chuàng)建向?qū)? 支持子報(bào)表? 源文件的備份? 支持文檔模版? 支持TrueType字型? 支持本地化? 可添加插件擴(kuò)展功能? 完全支持腳本? 支持圖表? 標(biāo)準(zhǔn)對(duì)象庫(kù)管理（頁(yè)碼…）? 支持拖拽? 無(wú)限制的取消/重做iReport開(kāi)發(fā)團(tuán)隊(duì)是那些來(lái)自世界各地的工程師，他們默默無(wú)聞的用他們熟練的技術(shù)和豐富的經(jīng)驗(yàn)日負(fù)一日的為iReport添加功能排除bugs。iReport 社區(qū)：iReport網(wǎng)址是。 企業(yè)的網(wǎng)址是：Help:在這里你不但可以提出要求，也可以提出技術(shù)上的問(wèn)題Open Discussion: 這個(gè)社區(qū)是用來(lái)發(fā)布注釋?zhuān)卸ㄓ懻摻Y(jié)果和提出新的功能建議的。如果你還是無(wú)法解決你的問(wèn)題，不要著急，我們還有一個(gè)特殊的跟蹤系統(tǒng)來(lái)幫助你：不保證你的提問(wèn)能很快得到答復(fù)，但是你一定能在幾天內(nèi)收到一個(gè)另你非常滿(mǎn)意的答復(fù)。這些都是免費(fèi)的，如果你享有這些，我們還是希望你能夠給我們的項(xiàng)目一些資助。如果你需要一些關(guān)于商業(yè)方面的支持，你可以寫(xiě)到： gt@.請(qǐng)將你發(fā)現(xiàn)的bug的記錄發(fā)送到：在企業(yè)網(wǎng)站上, 也可以進(jìn)一步的提出要求(RFE). 有能力的也可以提出不足并發(fā)表完整的代碼。為了能始終了解關(guān)于最新的項(xiàng)目的開(kāi)發(fā)情況你可以將你的郵件地址加到我們的郵件列表中：所有的iReport團(tuán)隊(duì)成員會(huì)以往直前地，嚴(yán)肅地，認(rèn)真地考慮所有來(lái)自于用戶(hù)們的建議，批評(píng)和忠告。鳴謝：iReport 的結(jié)晶來(lái)自于許多人。但是一些人正在被我們遺忘，我很榮幸的感謝以下為我們工程作出貢獻(xiàn)的一些人：Teodor Danciu, Alexander, Andre Legendre, Craig BSpengler, David Walters, Egon R Pereira, ErtanO, G Raghavan, Heiko Wenzel,Kees Kuip, Octavio Luna, Peter Henderson, Vinod Kumar Singh, Wade Chandler,Erica Pastorello以及所有的評(píng)論家。2 入門(mén)在這章我們將看到使用iReport之前的必要步奏，如何獲得二進(jìn)制的分發(fā)和源程序和如何編譯和安裝它。必要條件：iReport需要Sun Java 2 SDK 。 為了能編譯jasper文件就必須安裝完整的java2（JDK），不光是(JRE)這個(gè)運(yùn)行環(huán)境。如果你還想編譯iReport源代碼，你還要安裝Jakarta Ant version 。硬件方面，類(lèi)似于java的環(huán)境，iReport也占很多的RAM，所以它也需要只少256Mb 的內(nèi)存和至少20Mb的磁盤(pán)空間。下載：你可以到SourceForge網(wǎng)站上的企業(yè)主頁(yè)上下載最新發(fā)布的iReport(). 可能有幾種不同的分類(lèi)： 這是官方的zip格式的二進(jìn)制文件。 這是官方的tar gz格式的二進(jìn)制文件。 這是官方的包含源代碼的zip格式的二進(jìn)制文件。每一種都包含必須使用的第三方的庫(kù)和程序及附加文件 ，例如模板和一些html格式的基礎(chǔ)教程。如果你想要更多最新版本的源程序，你可以直接地連接CVS庫(kù)。但必須要有一個(gè)CVS客戶(hù)端（像CVS，JCVS或者WinCVS）。如果你有CVS那就執(zhí)行如下的命令行：cvs d:pserver:anonymous@:/cvsroot/ireport login （目前好象無(wú)法連接）and then all on the same line…cvs z3 d:pserver:anonymous@:/cvsroot/ireportco iReport2這樣CVS客戶(hù)端就可以將iReport的所有文件下載到本地，包括所有的文檔，庫(kù)和所有有用的編譯iReport的文件。就使用其他CVS的用戶(hù)來(lái)說(shuō)，SourceForge網(wǎng)站也自制了詳細(xì)的解釋用來(lái)檢出工程。編譯iReport：，它是被Jakarta Ant 用來(lái)編譯和啟動(dòng)iReport 和或用類(lèi)型的工程。下載 ,解壓縮到你指定的目錄，例如：c:\devel(or/usr/devel on unix system)。打開(kāi)命令提示符或shell，進(jìn)入你解壓的目錄和iReport目錄：C:\devel\ant iReport如果這個(gè)源完整的存在與目錄中，它將被編譯進(jìn)類(lèi)中iReport就能直接啟動(dòng)。基本的配置：如果選擇下載了iReport二進(jìn)制版本的，那就直接將該壓縮文件解壓縮到指定目錄，例如：c:\devel (or/usr/devel on a unix system). 打開(kāi)命令提示符或shell，進(jìn)入被解壓縮的目錄，輸入iReport目錄：C:\devel\or on unix:$ ./(in this case, it should be preceded by a “chmod +x” if the file is not executable.)第一步執(zhí)行完畢時(shí)iReport將創(chuàng)建一個(gè)名叫”.ireport”的文件在用戶(hù)的主目錄。這里的主目錄指由自己設(shè)置和配置的目錄。如果文件夾不能被創(chuàng)建，這就有可能是解壓縮造成的影響而不能夠配置成功，這時(shí)，你就要自己手動(dòng)的創(chuàng)建一個(gè)目錄。 文件拷貝到JDK的lib目錄下以及iReport的lib目錄下。如果沒(méi)有這個(gè)文件的話(huà)在編譯report時(shí)將會(huì)產(chǎn)生一些異常（carried out by using classes contained in this java library).在MacOS 。iReport的初始化配置包括：設(shè)置所要查看運(yùn)行后的文檔的格式；選擇語(yǔ)言；設(shè)置編譯后的文件目錄。其他的配置說(shuō)明將在以下進(jìn)行。為了繼續(xù)的進(jìn)行配置必須打開(kāi)ireport，然后選擇菜單選項(xiàng)中工具選項(xiàng)（menu Options → Tools.）。選擇你最熟悉的語(yǔ)言接下來(lái)點(diǎn)“Compiler”選項(xiàng)卡。2．2圖這個(gè)選項(xiàng)卡是用來(lái)設(shè)置編譯后的文件存儲(chǔ)目錄，默認(rèn)的目錄會(huì)在iReport的根目錄。一般情況下是要指定一個(gè)有效的目錄來(lái)保存編譯文件。這個(gè)目錄也可以是加載報(bào)表源時(shí)的目錄，既然這樣就選擇“Use the reports directory for piles”復(fù)選框。2．3圖完成以上列出的配置后，接下來(lái)我們還要設(shè)置報(bào)表輸出格式和查看XML源所用編輯器。重啟iReport繼續(xù)設(shè)置上圖的選項(xiàng)。創(chuàng)建一個(gè)空白報(bào)表測(cè)試一下我們的設(shè)置 (menu File → New Document), 領(lǐng)悟一下iReport所提供的功能。之后點(diǎn)工具條上的運(yùn)行按扭。如果你操作的正確，將會(huì)有一個(gè)保存jrxml文件的提示，相應(yīng)的一個(gè)jrxml文件將被創(chuàng)建，之后會(huì)發(fā)布出一個(gè)預(yù)先設(shè)置的空白頁(yè)。這就意味著你剛才的配置ok拉。創(chuàng)建JDBC連接：一個(gè)有代表性的關(guān)系數(shù)據(jù)庫(kù)可以提供最普通的數(shù)據(jù)源給一個(gè)報(bào)表。首先，我們來(lái)看看如何設(shè)置一個(gè)JDBC連接，點(diǎn)菜單Datasource Connections/Datasources 并點(diǎn)窗口的連接列表的new按扭。此時(shí)打開(kāi)一個(gè)新建連接（）窗口。在這個(gè)面板上填寫(xiě)連接名：(. “My new connection”)并選擇正確的JDBC驅(qū)動(dòng)。iReport支持大部分的JDBC驅(qū)動(dòng)URL格式。因此你能夠自動(dòng)創(chuàng)建一個(gè)URL通過(guò)在相應(yīng)的輸入框中填寫(xiě)服務(wù)器地址和數(shù)據(jù)庫(kù)名。若要完成連接你就必須輸入數(shù)據(jù)庫(kù)名和密碼用