Jasperreport和iReport詳細(xì)功能介紹.doc

JasperReport和IReport報表開發(fā)的功能介紹目錄1 簡介42 JasperReport和IReport的安裝與配置42.1 JDK的下載、安裝和配置42.2 ANT的下載、安裝和配置52.3 Jasperreport的下載、安裝和配置62.4 iReport的安裝和配置73 主要功能和實(shí)現(xiàn)過程73.1 XML解析83.2編譯報表設(shè)計83.3 Report Design 預(yù)覽93.4報表填充103.5查看報表113.6打印報表113.7導(dǎo)出報表113.8對象的載入和保存114 iReport的使用指南124.1一個簡單的報表124.2報表預(yù)覽134.3使用數(shù)據(jù)庫的數(shù)據(jù)生成報表155 報表設(shè)計185.1DTD Reference185.2XML編碼195.3報表屬性196 報表數(shù)據(jù)216.1表達(dá)式216.2參數(shù)226.3數(shù)據(jù)源246.4查詢報表256.5字段266.6變量287 Report Sections317.1 Main Report Sections317.2 數(shù)據(jù)分組368 腳本程序389 報表元素389.1文本元素409.2圖像元素459.3超鏈接489.4元素組4810 子報表4910.1子報表參數(shù)5010.2子報表數(shù)據(jù)源5011高級JasperReports應(yīng)用5011.1 XML報表的導(dǎo)入和設(shè)計5011.2實(shí)例化數(shù)據(jù)源接口5011.3自定義查看器5011.4導(dǎo)出新的格式511 簡介Jasperreport是一款報表打印組件，是開放源代碼組織中的一個java報表打印工程，是一款功能強(qiáng)大的報表生成工具。它既可以將報表內(nèi)容在顯示器上輸出，也可以通過打印機(jī)打印出來，同時它還支持使用PDF、HTML和XML等多種文件格式進(jìn)行存儲。在不久的將來，諸如CSV、XLS、RTF等格式也將會被兼容。iReport也是開源組織中的一款免費(fèi)軟件，其主要作用是用來以可視化的方式設(shè)計生成JasperReport所使用的報表格式文件，因?yàn)镴asperReport本身并未提供很好的可視化報表設(shè)計工具，iReport的出現(xiàn)正好彌補(bǔ)了這個缺陷。2 JasperReport和IReport的安裝與配置 2.1 JDK的下載、安裝和配置下載JDK的最新版本可以從SUN 公的官方網(wǎng)站上下載得到，網(wǎng)址為 ，JDK共分為3 個版本，J2ME,J2SE,J2EE，因?yàn)槭窃谟嬎銠C(jī)上使用，我們需要下載使用 J2SE SDK，如果您的計算機(jī)是用來做軟件開發(fā)，需要下載J2SE SDK，如果是用來運(yùn)行已經(jīng)編譯好的JAVA 程序的，可以只下載J2SE JRE 即可。下載JDK 時SUN 公司會要求你同意一個JDK 的使用許可協(xié)議，選接受協(xié)議后，會出現(xiàn)選擇適合不同的操作系統(tǒng)平臺使用的JDK 版本選擇的界面，您可以根據(jù)自己使用的操作系統(tǒng)平臺選擇適合的JDK 版本。安裝以Windows 平臺的安裝為例，在安裝的過程中一路Next 即可，同時請注意記錄下JDK安裝后的目錄，稍后進(jìn)行配置時要用到。配置以在Windows xp平臺配置J2SE SDK 為例，鼠標(biāo)右鍵點(diǎn)擊桌面上的“我的電腦”圖標(biāo)，在彈出的菜單中選擇屬性，選擇“高級”選項(xiàng)，選擇“環(huán)境變量”。點(diǎn)擊“系統(tǒng)變量”下的新增按鈕，在對話框中的變量名處輸入大寫的JAVA_HOME，在變量值處輸入的JDK 安裝目錄。點(diǎn)擊“確定”完成第一步的配置，接下來以同樣的方法配置系統(tǒng)環(huán)境變量CLASSPATH，在CLASSPATH的變量值處輸入%JAVA_HOME%libtools.jar; %JAVA_HOME%libdt.jar，當(dāng)然，也可以直接輸入絕對路徑，但建議使用%JAVA_HOME%的方式。再接下來還要修改系統(tǒng)環(huán)境變量PATH,增加%JAVA_HOME%bin 目錄。至此JDK 的配置也完成.打開一個命令行窗口，鍵入set classpath 與set java_home 應(yīng)該可以看到正確的配置信息，同時，輸入javac -version 看系統(tǒng)能否找到JAVA 的編譯器。 2.2 ANT的下載、安裝和配置ant 是個很好用的工具，雖然對于JasperReport 和iReport 來說ant 并不是必須的，但還是建議以使用ant 的方式來應(yīng)用。ANT的下載和安裝ant 是apache 組織的一個子項(xiàng)目，可以從 下載得到，Windows 平臺的可以下載ZIP 格式的安裝文件，下載完成以后解壓縮到某個目錄，建議使用根目錄下的直接子目錄作為ant 解壓縮以后目錄，ant 無需安裝，解壓縮文件以后就算安裝完成。Ant的配置與設(shè)置JDK相同的操作過程打開系統(tǒng)環(huán)境變量設(shè)置窗口，增加ANT_HOME環(huán)境變量，變量值為解壓縮以后的ant 所在目錄在系統(tǒng)的環(huán)境變量Path 中增加%ANT_HOME%bin 目錄新開一個命令行窗口，輸入ant 后如果出現(xiàn)如下圖所示內(nèi)容即算正確完成ant 的配置。 2.3 Jasperreport的下載、安裝和配置Jasperreport的下載和安裝因?yàn)镴asperReport 是 的開源項(xiàng)目，最新的JasperReport 版本可以在 中找到，同時，為了方便世界各國程序員下載， 還設(shè)有許多的鏡像站點(diǎn)供你選擇。強(qiáng)烈建議下載jasperreport 的source.zip，因?yàn)檫@里面包含了很多的示例程序，對于想深入研究jasperreport 的人來說會有很大的幫助。如果不想對JasperReport 有太多的深入了解，只需要下載.jar 文件就能正常開發(fā)應(yīng)用了。沒有必要單獨(dú)為JasperReport.jar 文件設(shè)置目錄，建議放在系統(tǒng)中%JAVA_HOME%lib目錄中。Jasperreport的配置將JasperReport-x.x.x.jar 文件添加到操作系統(tǒng)的環(huán)境變量ClASSPATH 中即可完成JasperReport 的配置。 2.4 iReport的安裝和配置iReport的安裝iReport 在Windows 平臺也是以.zip 形式的文件提供的，直接解壓縮后就算完成了安裝如果是2.x版的，且您決定以ant 的方式運(yùn)行iReport 程序，需要修改一下iReport 目錄中的ireport.bat 文件中的內(nèi)容，第一次運(yùn)行ireport.bat 會生成javadoc，在確定已正確生成javadoc 文件后可以將生成doc 的那一段注釋掉以便以后可以快速的啟動iReport 程序。3.0 版無需修改ireport.bat 文件。iReport 的使用在有ant 環(huán)境的下運(yùn)行iReport，直接運(yùn)行iReport 目錄中的ireport.exe 即可。在沒有ant 的環(huán)境下運(yùn)行iReport，2.X 版本使用iReport 目錄中的noant 目錄中的startup.bat 運(yùn)行，3.0 版本使用bin 目錄中的startup.bat 運(yùn)行。3 主要功能和實(shí)現(xiàn)過程 現(xiàn)在我們將對XML報表設(shè)計進(jìn)行分析，編譯，裝填數(shù)據(jù)，預(yù)覽結(jié)果和導(dǎo)出到其他格式的過程。Jasperreport的實(shí)例下面是Jasperreport工具，將XML報表轉(zhuǎn)變成的各種類型報表的流程圖： 3.1 XML解析 JasperReport使用SAX2.0 API對XML文件進(jìn)行解析。然而，這并不是必須的，用于可以在執(zhí)行其自行決定使用哪一種XML解析器。JasperReport使用org.xml.sax.helpers.XMLReaderFactory類的createXMLReader()來獲得解析器實(shí)例。在這種情況下，就像在SAX2.0文檔中說的那樣，在運(yùn)行期，把Java系統(tǒng)屬性org.xml.sax.driver的值設(shè)定為SAX driver類的全限定名是必要的。設(shè)置系統(tǒng)屬性有兩種方法：第一種方法是在你啟動Java虛擬機(jī)的時候，在命令行窗口使用-D開關(guān)：java -Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser MySAXApp sample.xml在JasperReport提供的所有例子中，都采用ANT構(gòu)建工具來執(zhí)行不同的任務(wù)。我們通過使用內(nèi)置的 task中的元素來提供這一系統(tǒng)屬性；第二種設(shè)置系統(tǒng)屬性的方法是使用java.lang.System.setProperty(String key, String value)System.setProperty(“org.xml.sax.driver”,“ org.apache.xerces.parsers.SAXParser”);Jsp/compile.jsp和web-inf/class/servlets/CompileServlet.java文件提供了這方面的例子。 3.2 編譯報表設(shè)計 為了生成一個報表，用戶首先需要完成報表的設(shè)計，生成方法或采用直接編輯XML文件，或通過程序生成一個net.sf.jasper.engine.design.JasperDesign對象。在此，主要采用編輯XML文件的方法，因?yàn)檫@種方法在目前是使用JasperReport類庫的最好的方法。 XML報表設(shè)計是JasperReport用來生成報表的初級材料。這是因?yàn)閄ML中的內(nèi)容需要被編譯并載入到JasperDesign對象中，這些對象將在報表引擎向其中填入數(shù)據(jù)之前，必須經(jīng)過編譯過程。 報表編譯過程的主要目的是生成并裝載含有所有報表表達(dá)式的類的字節(jié)碼。這個動態(tài)生成的類將會被用來在裝填數(shù)據(jù)，并在給所有報表表達(dá)式求值的時候使用。具體例子是，如果你用iReport生成一個報表名字叫SimpleSheetTest，它的XML設(shè)計文件名叫SimpleSheetTest.jrxml，同時和它在同一目錄下iReport會自動生成一個文件名為SimpleSheetTest.java，里面主要是一些報表元素，如Field，Parameters，Variables的定義，以及一些求值表達(dá)式。當(dāng)然，像上面提到的，這個文件在你直接使用JasperReport API的時候是看不到的，因?yàn)樗窃趫?zhí)行期生成的一個Class。要想看到它的辦法是：在IDE（JBuilder，Eclipse）中單步執(zhí)行程序，在報表打印的階段，你將能跟蹤到這個類，它的名字就是“你的報表名.java”，按上面的例子就是SimpleSheetTest.java，這和iReport是一致的。當(dāng)然也可以像下面說的那樣，到生成這個類的臨時目錄里找到它。在這個類生成過程之前，JasperReport引擎需要驗(yàn)證報表設(shè)計的一致性，哪怕存在一處驗(yàn)證檢查失敗都不會繼續(xù)運(yùn)行下面的工作。對于這個包含了所有報表表達(dá)式的類的字節(jié)碼，我們至少需要關(guān)心三個方面的內(nèi)容：臨時工作目錄、Java 編譯器的使用、Classpath 為了能夠編譯Java源文件，這個文件必須被創(chuàng)建并且被保存到磁盤上。Java編譯過程的輸出是一個.class文件，這個包含所有報表表達(dá)式的類在這個工作目錄里被創(chuàng)建并編譯，這也是為什么JasperReport需要訪問這個臨時目錄的原因。當(dāng)報表的編譯過程結(jié)束之后，這些臨時的類文件將被自動刪除，而生成的字節(jié)碼將保存在net.sf.jasper.engine.JasperReport對象中。如果需要的話，這個類可以將自己序列化并保存到磁盤上。這就是iReport的做法。 缺省情況下，這個臨時工作目錄就是啟動JVM時的當(dāng)前目錄，這卻取決于JVM的系統(tǒng)屬性user.dir。通過更改系統(tǒng)屬性pile.temp，用戶可以很容易更改這個工作目錄。在Web環(huán)境下，特別是當(dāng)你不想讓含有啟動Web Server的批處理文件的目錄和報表編譯過程的臨時工作目錄混在一起的時候，修改這個屬性就可以了。上面提到的第二個方面涉及用來編譯報表表達(dá)式類的Java編譯器。首先，報表引擎將試圖使用sun.tools.javac.Main類來編譯Java源文件。這個類包含在tools.jar中，當(dāng)且僅當(dāng)這個jar文件在JDK安裝目錄下的bin/目錄中，或在classpath中時，sun.tools.javac.Main才能正常使用。如果JasperReport不能成功裝載sun.tools.javac.Main文件，程序?qū)討B(tài)執(zhí)行java編譯過程，就像我們通常用命令行那樣，使用JDK安裝目錄下的bin/目錄下的javac.exe。這就是為什么將JDK安裝目錄/lib/下的tools.jar文件copy到JasperReport工程的lib/目錄下是一個可選的操作（optional operation）。如果tools.jar不在classpath中，JasperReport將顯示錯誤信息并繼續(xù)上面提到的操作。 當(dāng)編譯Java源文件的時候，最重要的事情莫過于classpath。如果Java編譯器不能在指定的classpath中找到它試圖編譯的所有相關(guān)類的源文件，則整個過程將失敗并停止，錯誤信息將在控制臺顯示出來。同樣的事情也將發(fā)生在JasperReport試圖編譯報表表達(dá)式類的時候。所以，在runtime為編譯過程提供正確的classpath是非常重要的。例如，我們我們需要確認(rèn)在classpath中，我們提供了在報表表達(dá)式中可能用到的類（custom class）。 在這個方面也有一個缺省的行為。如果沒有為編譯report class特殊指定classpath，引擎將會使用系統(tǒng)屬性java.class.path的值來確定當(dāng)前的JVM classpath。如果你指定了系統(tǒng)屬性pile.class.path的值，你可以用你定義的classpath來覆蓋缺省行為。 大多數(shù)情況下，編譯一個report只需要簡單的調(diào)用JasperReport類庫中的JasperCompileMpileReport(myXmlFileName);即可。調(diào)用之后將生成編譯好的report design并存儲在.jasper文件中，這個文件將會保存在和提供XML report design文件相同的目錄中。 3.3 Report Design 預(yù)覽 JasperReport類庫并沒有提供高級的GUI工具來輔助進(jìn)行設(shè)計工作。但是目前已經(jīng)有至少4個project試圖提供這樣的工具。然而，JasperReport本身提供了一個很有用的可視化組件來幫助報表設(shè)計者在編譯的時候預(yù)覽報表設(shè)計（其實(shí)不如直接用IReport方便）。net.sf.jasper.view.JasperDesigner是一個基于Swing的Java應(yīng)用程序，它可以載入并顯示XML形式或編譯后的報表設(shè)計。盡管它不是一個復(fù)雜的GUI應(yīng)用程序，缺乏像拖拽可視化報表元素這樣的高級功能，但是它仍然是一個有用的工具。所有JasperReport工程提供的例子都利用了這個報表查看器。 如果你已經(jīng)安裝了ANT，想要查看一個簡單的報表設(shè)計，你只需要到相應(yīng)的文件夾下輸入如下命令：ant viewDesignXML 或者 ant viewDesign 如果你沒安裝ANT，要達(dá)到上面的效果就不是很容易，因?yàn)镴asperReport本身需要一些其他輔助的jar包（在JasperReport安裝目錄/lib下），在運(yùn)行的時候，你需要把這些jar包都包含到你的classpath里面，并且正確設(shè)計系統(tǒng)屬性，如上面提到的org.xml.sax.driver。我可以展示一下在windows下的例子：java -classpath ./;./././lib/commons-digester.jar;./././lib/commons-beanutils.jar;./././lib/commons-collections.jar;./././lib/xerces.jar;./././lib/jasperreports.jar-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParserdori.jasper.view.JasperDesignViewer -XML -FFirstJasper.xml 3.4報表填充 報表填充過程是JasperReport library最重要的功能。它體現(xiàn)了這個軟件最主要的目的，因?yàn)檫@一過程可以自由的操作數(shù)據(jù)集，以便可以產(chǎn)生高質(zhì)量的文檔。有3種材料需要裝填過程中作為輸入提供給JasperReport：report design、參數(shù)、數(shù)據(jù)源 這一過程的輸出通常是一個單一的最終要被查看，打印或?qū)С龅狡渌袷降奈臋n。要進(jìn)行這一過程，我們需要采用net.sf.jasper.engine.JasperFillManager類。這個類提供了一些方法來讓我們填充報表設(shè)計，report design的來源可以是本地磁盤，輸入流，或者直接就是一個已存在于內(nèi)存中的net.sf.jasper.engine.JasperReport類。輸出的產(chǎn)生是于輸入類型相對應(yīng)的，也就是說，如果JasperFillManager接到一個report design的文件名，填充結(jié)束后生成的report將會是一個放在磁盤上的文件；如果JasperFillManager收到的是一個輸入流，則生成的report將會被寫到一個輸出流中。有些時候，這些JasperFillManager提供的方法不能滿足某些特定的應(yīng)用的要求，例如可能有人希望他的report design被作為從classpath中得到的資源，并且輸出的報表作為一個文件存放在一個指定的磁盤目錄下。遇到這種情況時，開發(fā)人員需要考慮在將報表設(shè)計傳遞給報表裝填過程之前，用net.sf.jasper.engine.util.JRLoader類來裝載report design對象。這樣，他們就能獲得像報表名這樣的report design屬性，于是開發(fā)者就能生成最終文檔的名字，并將它存放到所需的位置上。 在現(xiàn)實(shí)中，有許多報表裝填的情境，而裝填管理器僅試圖覆蓋其中最常被使用到的部分。然而對于想要自己定制裝填過程的人來說，只要采用上面所說的方法，任何開發(fā)者都可以達(dá)到滿意的結(jié)果。報表參數(shù)通常作為java.util.Map的value提供給裝填管理器，參數(shù)名為其鍵值。作為裝填過程所需的第三種數(shù)據(jù)源，有如下兩種情況：通常，引擎需要處理net.sf.jasper.engine.JRDataSource接口的一個實(shí)例，通過這個實(shí)例，引擎可以在裝填過程中獲取所需數(shù)據(jù)。JasperFillManager提供的方法支持所有的JRDataSource對象。 然而，這個管理器還提供一些接受java.sql.Connection對象作為參數(shù)的方法集，來取代所需的數(shù)據(jù)源對象。這是因?yàn)樵诤芏嗲闆r下，報表生成所需的數(shù)據(jù)都來源于某個關(guān)系型數(shù)據(jù)庫中的表。在報表中，用戶可以提供SQL查詢語句來從數(shù)據(jù)庫中取回報表數(shù)據(jù)。在執(zhí)行期，engine唯一需要做的是獲得JDBC connection對象，并使用它來連接想要連接的數(shù)據(jù)庫，執(zhí)行SQL查詢并取回報表數(shù)據(jù)。在后臺，引擎將使用一個特殊的JRDataSource對象，但是它對于調(diào)用它的程序來說是透明的。JasperReport工程提供了相關(guān)的例子，它們采用HSQL數(shù)據(jù)庫服務(wù)器（在工程文件中，有一個相應(yīng)的文件夾），要運(yùn)行這些例子你需要首先啟動該服務(wù)器，方法是：在/demo/hsqldb目錄下輸入如下命令：ant 或者 ant runServer 沒裝ANT就麻煩點(diǎn)：java -classpath ./;././lib/hsqldb.jar org.hsqldb.Server一下代碼片斷顯示了query例子是如何裝填數(shù)據(jù)的：/Preparing parametersMap parameters = new HashMap();parameters.put(ReportTitle, Address Report);parameters.put(FilterClause, Boston, Chicago, Oslo);parameters.put(OrderClause, City);/Invoking the filling processJasperFillManager.fillReportToFile(fileName, parameters, getConnection(); 3.5 查看報表 報表填充階段的輸出通常是一個JasperPrint對象，如果把它保存在磁盤上，通常以一個.jrprint文件的形式存在。JasperReport擁有一個內(nèi)置的查看器，用來查看用內(nèi)置的XML導(dǎo)出器獲得的XML格式的報表文件。這個查看器就是以前提到過的net.sf.jasper.niew.JRViewer，用戶可以通過繼承這個類來定制自己所需的查看器。JasperReport工程中自帶的例子webapp中，你可以閱讀JRViewerPlus類的代碼來獲取進(jìn)一步內(nèi)容。 3.6 打印報表 JasperReport類庫的主要目標(biāo)，就是生成可打印的文檔。而且多數(shù)應(yīng)用程序生成的報表都是需要打印到紙張上。我們可以用net.sf.jasper.engine.JasperPrintManager來打印JasperReport生成的文檔。當(dāng)然，報表也同樣可以在被導(dǎo)出到其他格式如PDF，HTML之后再被打印。通過JasperPrintManager提供的方法，我們可以打印整個文檔，打印單個文檔或打印某一范圍內(nèi)的文檔，可以顯示打印對話框也可以不顯示。下面的例子演示了不顯示對話框，打印整個文檔的方法：JasperPrintManager.printReport(myReport,false); 3.7 導(dǎo)出報表 在一些應(yīng)用程序環(huán)境下，將JasperReport生成的文檔從其特有的格式導(dǎo)出到其他更為流行的格式如PDF，HTML是非常有用的。這樣一來，其他人就可以在沒有安裝JasperReport的情況下查看這些報表，特別是當(dāng)這些文檔要通過網(wǎng)絡(luò)發(fā)送出去的時候。JasperReport提供了JasperExportManager類來支持此項(xiàng)功能。這項(xiàng)功能將會在以后不斷加入對新的格式的支持。目前，JasperReport主要支持導(dǎo)出PDF，HTML和XML類型的文檔，下面是導(dǎo)出的代碼片斷：JasperExportManager.exortReportToHtmlFile(myReport); 注意：想要將自己的報表導(dǎo)出到其他格式的用戶，需要實(shí)現(xiàn)JRExporter的接口，或繼承相應(yīng)的JRAbstractExporter類。 3.8 對象的載入和保存 當(dāng)使用JasperReport的時候，你經(jīng)常會與序列化的對象，如以編譯的報表設(shè)計，或已生成的報表打交道。有時，你需要手動載入從不同的source如input stream或你用類庫核心功能產(chǎn)生的序列化類。JasperReport提供了兩個特殊的工具類來提供上述操作的能力，這些類通常供報表引擎自己使用：net.sf.jasper.engine.util.JRLoadernet.sf.jasper.engine.util.JRSaver 第一個類提供了一些方法讓我們能夠從不同類型的數(shù)據(jù)源如文件，URL，input stream和classpath里面獲取序列化對象。最令人感興趣的方法是loadObjectFormLocation(String)。它已經(jīng)在上一章中介紹過了，這里不再贅述。 與上面的對象載入工具相反的部分是JRSaver類，它可以幫助程序員將自己的類序列化之后存放到本地磁盤或通過Output Stream發(fā)送到網(wǎng)絡(luò)上去。 有時，開發(fā)人員可能想要載入已經(jīng)生成好的report，或最終的已經(jīng)被導(dǎo)出到XML格式的JasperReport文檔，這與上面所說的直接load序列化對象有所不同。這時，我們需要載入的是將載入的XML內(nèi)容進(jìn)行編譯，并生成JasperPrint對象，而并非僅僅是載入序列化對象。這時，我們可以通過net.sf.jasper.engine.xml.JRPrintXmlLoader類的一些靜態(tài)方法，通過編譯從XML文件中讀取的內(nèi)容構(gòu)建出一個位于內(nèi)存中的文檔對象。4 iReport的使用指南4.1一個簡單的報表 如上面左圖所示新建一個文檔，如右圖設(shè)置報表的名稱、大小等屬性。依照上圖的標(biāo)識，分別設(shè)計報表的各部分，可以通過以下快捷方式來插入圖形、靜態(tài)文字、動態(tài)文字圖片等元素，設(shè)計如下圖報表設(shè)計完畢，選擇菜單欄中的“建立”下拉菜單，選擇其中“編譯”，對報表盡進(jìn)行編譯，如有錯誤，會在底端提示，若無錯誤，則生成.Jrxml文件。編譯成功之后，選擇“執(zhí)行報表”，進(jìn)行預(yù)覽。4.2 報表預(yù)覽Ireport默認(rèn)是用其自帶的iReport JasperViewer進(jìn)行預(yù)覽。我們可以選擇其他的預(yù)覽方式，通過選擇菜單欄中的“Option”下拉菜單，選擇其中的“選項(xiàng)”，選擇External Programs選項(xiàng)卡，如下圖所示，對各個預(yù)覽工具進(jìn)行配置配置之后，可以通過選擇菜單欄中的“建立”下拉菜單，選擇以配置好的預(yù)覽方式，之后選擇“執(zhí)行報表”，就可以用相應(yīng)的應(yīng)用程序?qū)ζ溥M(jìn)行預(yù)覽。4.3 使用數(shù)據(jù)庫的數(shù)據(jù)生成報表4.3.1連接數(shù)據(jù)庫選擇菜單欄中的“data”下拉菜單，選擇“連結(jié)/資料來源”， 選擇“New”新建一個連接，配置如下圖，其中experiment是已建立的數(shù)據(jù)庫名稱單擊“Test”，測試數(shù)據(jù)庫連接是否成功，若成功，有以下對話框若不成功，有類似于下圖的相應(yīng)的對話框測試成功，單擊“save”保存新建連接。4.3.2設(shè)置SQL查詢語句選擇菜單欄中的“data”下拉菜單，選擇“報表查詢”，之后在相應(yīng)地方編寫SQL語句。編寫完畢，單擊“OK”保存并退出編寫。4.3.3字段在報表設(shè)計器中的使用點(diǎn)擊工具欄中的在報表中的“Details”段中用鼠標(biāo)拖拽到適合的大小，右擊該字段框，選擇屬性，在選擇Text Fiel選項(xiàng)卡，如下圖： 選中Text Field 項(xiàng)，如果沒有設(shè)置正確的字段名稱，則Textfield expression 中的內(nèi)容將顯示藍(lán)色，手工修改Textfield expression 中的內(nèi)容為正確的字段名稱，格式為$F字段名稱，正確修改后將變?yōu)榫G色顯示。4.3.4編譯與預(yù)覽帶有字段的報表對下面報表進(jìn)行編譯，其中數(shù)據(jù)已經(jīng)在數(shù)據(jù)庫中預(yù)先設(shè)好編譯報表可以選擇菜單欄中“建立”下拉菜單中的“編譯”，也可以直接點(diǎn)擊工具欄中的圖標(biāo)，如果編譯過程正確完成，iReport 設(shè)計器的下面會顯示如下內(nèi)容：帶有字段的報表進(jìn)行預(yù)覽有兩種方式，一種是不使用數(shù)據(jù)庫中的數(shù)據(jù)，默認(rèn)所有字段值為null 的方式，預(yù)覽方法為選擇“建立”菜單中的“執(zhí)行報表”，也可以直接點(diǎn)擊工具欄中的圖標(biāo)；第二種方式為使用數(shù)據(jù)庫中的數(shù)據(jù)的方式，預(yù)覽方法為選擇“建立”菜單中的“執(zhí)行報表（使用動態(tài)連接）”，也可以直接點(diǎn)擊工具欄中的圖標(biāo)。下圖進(jìn)行預(yù)覽：5 報表設(shè)計報表設(shè)計體現(xiàn)了一個模板，JasperReport引擎利用這個模板將同臺生成的內(nèi)容傳遞給打印機(jī)，屏幕或Web。存儲在數(shù)據(jù)庫中的數(shù)據(jù)在報表裝填的過程中被組織起來，根據(jù)已有的報表設(shè)計來獲得可以進(jìn)行打印的，面向頁面的（page oriented）文檔?？偠灾粋€報表設(shè)計包含了所有的結(jié)構(gòu)相關(guān)信息和將數(shù)據(jù)提供給報表所涉及的各個方面。這些信息涉及將在文檔中顯示出來的各種text或圖像元素的位置和內(nèi)容，自定義計算（custom calculation），數(shù)據(jù)組織，報表生成時的數(shù)據(jù)操作，等等。報表設(shè)計通常都定義在一個擁有特殊格式的XML文檔中，并且在被填充數(shù)據(jù)之前要經(jīng)歷JasperReport的編譯過程。然而JasperReport也允許用戶通過JasperReport提供的API構(gòu)造in-memory報表對象，例如noxmldesign就是很好的例子。 5.1 DTD Reference 當(dāng)使用XML文件進(jìn)行報表設(shè)計的時候，JasperReport將使用內(nèi)置的DTD文件來驗(yàn)證其受到的XML內(nèi)容的有效性。如果XML驗(yàn)證通過，則說明所提供的報表設(shè)計符合JasperReport所需要的XML結(jié)構(gòu)和語法規(guī)則，其引擎能夠生成經(jīng)過編譯的report design。 有效的XML文檔總是在驗(yàn)證時指向JasperReport的內(nèi)部DTD文件。如果沒有提供DTD文檔的引用，報表的編譯過程將會突然結(jié)束。這對所有人來說都是一個負(fù)擔(dān)，因?yàn)镈TD引用通常是相同的，并且這些引用可能會簡單的被從以前的報表設(shè)計中copy過來。在一開始，你需要將這個引用從給定的例子中copy過來。 正如以前說的一樣，報表引擎僅能識別指向其內(nèi)部DTD文件的的引用。你不能隨便從類庫的源文件中將那些DTD文件copy到別的地方，再在你的報表設(shè)計文件中指向你copy的那些DTD文件。如果你想那樣做的話，你將需要調(diào)整類庫中某些類，包括dori.jasper.engine.xml.JRXmlDigester類的某些代碼。如果你遇到像引擎無法找到其內(nèi)部的DTD文件而導(dǎo)致的無法載入資源的問題，請確定你已經(jīng)在使用外部DTD文件之前排除了所有可能發(fā)生的情況。遇到這樣的問題是不太可能的，因?yàn)橘Y源載入機(jī)制會隨著時間不斷改進(jìn)。JasperReport只有兩種合法的XML報表設(shè)計的DTD引用，他們是：或者： XML報表設(shè)計的根元素是，下面是一個普通的JasperReports XML報表設(shè)計文件的樣子： . 前三點(diǎn)描述了該報表設(shè)計的屬性和設(shè)置，下面省略的部分則描述了各種報表設(shè)計要素如報表參數(shù)、字段、變量、組和報表欄等。 5.2 XML 編碼 當(dāng)要生成不同語言的XML報表設(shè)計的時候，在XMl文件的首部的編碼屬性需要特別關(guān)注一下。缺省情況下，如果這個屬性的值沒被訂制，則XML解析器將會使用“UTF-8”作為XML文件的編碼格式。這一點(diǎn)是非常重要的，因?yàn)閳蟊碓O(shè)計通常包含了靜態(tài)的本地化文本。對于大多數(shù)西歐語言來說，ISO-8859-1編碼，也就是我們常說的LATIN1將會很好的處理如法語中重音符號的顯示問題。 在編輯XML文件的時候，要找到某種特殊語言的編碼類型，你可以查看XML document.FIXME。 5.3 報表屬性 我們上面已經(jīng)看到，XML報表設(shè)計的根元素。這一節(jié)我們將介紹報表設(shè)計對象的Property的細(xì)節(jié)以及這些屬性所對應(yīng)的XML attributes報表名稱 每一個報表都必須有一個名稱。這個名稱是相當(dāng)重要的，因?yàn)轭悗煨枰鼇砩晌募?，尤其是?dāng)編譯，裝填，導(dǎo)出報表的默認(rèn)行為被使用的時候，這個名的作用更為重要。這個名稱是以元素的name attribute的形式提供的，并且是強(qiáng)制必須填寫。列數(shù) JasperReport允許生成每頁的列數(shù)超過一列的報表，正如下面的圖片，展示了擁有兩列的報表：默認(rèn)情況下，報表引擎生成每頁一列的報表。打印順序 對于擁有超過一列的報表，為其提供列將被以什么順序填充是很重要的。你可以使用元素的printOrder attribute來進(jìn)行設(shè)置。有如下兩種情況：l Verticaln Filling：這個選項(xiàng)將導(dǎo)致列是自頂向下被填充（printOrder=”Vertical”）l Horizontal filling：列將自左向右被填充（printOrder=”Horizontal”）缺省設(shè)置將是printOrder=Vertical頁面大小 有兩個attribute是用來提供要生成的文檔大小的：pageWith，pageHeight。像所有其他顯示元素位置和尺寸的attribute一樣，這兩個attribute是以像素為單位的。JasperReport采用Java默認(rèn)的每英寸72點(diǎn)的設(shè)置。這意味著pageWith=”595”將大約是8.26英寸，這大概是A4紙的尺寸。默認(rèn)的紙張大小是A4紙：pageWith=”595” pageHeight=”842” Page Orientation（默認(rèn)設(shè)置為Portrait） orientation屬性用來設(shè)置文檔打印格式是“Portrait”還是“Landscape”。JasperReport允許用戶在從“Portrait”切換到“Landscape”的時候調(diào)整液面的寬度和高度。我們先看一個例子：我們假定要生成一個A4紙的報表，采用“Protrait”格式： pageWidth=”595” pageHeight=”842” orientation=”Portrait” 如果我們決定用A4紙的“Landscape”布局，首先要調(diào)整相應(yīng)的頁面寬度和高度： pageWidth=”842” pageHeight=”595” orientation=”Landscape” 這是因?yàn)镴asperReport需要確切知道它所要繪制的報表頁的寬度和高度，而不只看我們提供的orientation屬性，至少在報表裝填的時候是這樣。orientation屬性僅在報表打印時有用，來通知打印機(jī)或某些exporters頁面的orientation設(shè)置。頁邊距 一旦頁面大小確定下來，用戶就可以在生成報表的時候設(shè)定報表的邊距。有四個屬性來完成這項(xiàng)工作：topMargin，LeftMargin，bottomMargin和rightMargin。缺省的設(shè)置是上下邊距20像素，左右邊距30像素。列寬和列間距（Column Size and Spacing） 一個報表可能含有多列，我們可以通過上面提到的columnCount屬性得到報表列數(shù)。JasperReport需要知道列的寬度和列間距的大小。有兩個屬性用于這項(xiàng)工作：columnWidth和columnSpacing。當(dāng)我們對報表設(shè)計進(jìn)行編譯的時候，編譯器會對這項(xiàng)設(shè)置進(jìn)行有效性檢查（validation check）-看列的寬度和列間距是否符合給定的頁面寬度和頁邊距。因?yàn)槿笔〉牧袛?shù)為一，所以缺省的列間距為0像素，并且缺省的列寬等于頁面寬度減去左右邊距所得的值。在上面A4的例子中，列寬即為555像素?？諗?shù)據(jù)源時的行為 有時我們提供給我們的報表的數(shù)據(jù)源可能會沒有任何記錄。whenNoDataType屬性可以讓你選擇當(dāng)所提供的數(shù)據(jù)源中沒有數(shù)據(jù)的時候入和察看生成的報表。如下有三種不同的可能性，你可以任選其一：l Empty Document：生成的報表不含有頁面（no page in it）。當(dāng)你試圖裝載這樣的文檔（whenNoDataType=”NoPages”）的時候，Viewer 可能會拋出一個錯誤。l Blank page：表示生成的報表將僅含有一個空白頁（whenNoDataType=”BlankPage”）l All sections displayed：除了detail部分的其他部分將在生成的文檔中顯示出來（whenNoDataType=”AllSectionNoDetail”）。缺省的設(shè)置是whenNoDataType=”NoPages”。 標(biāo)題和摘要的放置（Title and Summary Sections Placement） 如果你想讓title部分和summary部分在單獨(dú)的一頁里顯示，你所需要做的事情就是讓下面的一個或兩個屬性的值為“true”：isTitleNewPage，isSummaryNewPage。這兩個屬性缺省情況下為false。注意:即使你選擇了在最后一頁的剩余部分顯示summary，如果列數(shù)超過一列，并且第二列已經(jīng)在最后一頁出現(xiàn)的時候（沒試過，等有機(jī)會試驗(yàn)一下），新的一頁將會被自動生成。腳本類（Scriptlet Class） scirptletClass屬性用于設(shè)置用于當(dāng)前報表的scriptlet類的名字。在后面會對Scriptlet進(jìn)行詳細(xì)討論。如果你沒為這個屬性提供任何值，報表引擎將會使用dori.jasper.engine.JRDefaultScriptlet的實(shí)例。6 報表數(shù)據(jù) 當(dāng)談到報表裝填過程的時候，有三樣?xùn)|西需要作為輸入提供給報表引擎：報表設(shè)計（report design），參數(shù)值（parameter values）和報表的數(shù)據(jù)源（data source）。在先前的介紹，我們已經(jīng)看到了有關(guān)報表設(shè)計的某些方面，現(xiàn)在我們要更加詳細(xì)的關(guān)注其他兩方面的內(nèi)容：參數(shù)（parameter）和報表數(shù)據(jù)源。他們描繪了報表引擎在裝填報表過程中所用到的僅有的數(shù)據(jù)來源。像你用其他報表工具所希望的一樣，這些數(shù)據(jù)將會根據(jù)報表設(shè)計中的定義的模板（template）被組織起來，并被用來生成準(zhǔn)備打印的、面向頁面的文檔。 6.1 表達(dá)式（expressions） 表達(dá)式是JasperReports的一個非常有用的特性。他們可以用來聲明執(zhí)行各種執(zhí)行各種計算（calculations）的報表變量（report variables），進(jìn)行報表的數(shù)據(jù)組織，定制報表文本字段（text field）的內(nèi)容或者進(jìn)一步定制報表對象的appearance。所有報表表達(dá)式基本上都是Java表達(dá)式，他們可以以特殊的語法引用報表參數(shù)（parameter），報表字段（field）和報表變量（variable）。在XML報表設(shè)計中，有一些用于定義表達(dá)式的元素：, , 等。因?yàn)樗械腏asperReport表達(dá)式都是真正（real）的Java表達(dá)式，只要你用完整的類名（包括包名）來引用這些表達(dá)式，你就可以在任何class中使用他們。當(dāng)你編譯報表和裝填數(shù)據(jù)的時候，你應(yīng)該確定你在報表表達(dá)式中使用的類已經(jīng)寫入了classpath。報表參數(shù)引用是通過$P序列引入的，例如： $PReportTitle 這個例子假定我們在報表設(shè)計中有一個名為ReportTitle的報表參數(shù)，這個參數(shù)是一個java.lang.String類。當(dāng)報表進(jìn)行裝填的時候，文本字段將會顯示這個參數(shù)的值。為了在一個表達(dá)式中使用報表字段，字段名必須放在$F的括號中。例如，如果我們想要在一個文本字段中顯示兩個數(shù)據(jù)源字段的連接值（concatenated values）,我們可以定義如下表達(dá)式： $FFirstName + + $F