一． JasperReports簡(jiǎn)介
JasperReports是一個(gè)強力的報表產(chǎn)生工具，他有能力描述豐富內容到屏幕上、到打印機或到PDF, HTML, XLS, CSV和XML文件。它完全用Java編寫(xiě)的，并可在各種Java應用（包括J2EE或WEB應用）中用來(lái)產(chǎn)生動(dòng)態(tài)內容。它的主要目的是以一種簡(jiǎn)單而靈活的方式來(lái)幫助創(chuàng )建導向的頁(yè)面。
JasperReports組織根據在一個(gè)XML文件中定義的報表設計通過(guò)JDBC來(lái)接受來(lái)自一個(gè)關(guān)系數據庫中的數據. 為了以數據來(lái)填充報表，報表設計必須首先被編譯。
描述報表設計的XML文件的編譯通過(guò)執行dori.jasper.engine.JasperManager 類(lèi)暴露的compileReport()方法。
通過(guò)編譯，報表設計被裝載入一個(gè)報表設計對象中，然后系列化并存儲在磁盤(pán)上(dori.jasper.engine.JasperReport)。當應用程序想以數據來(lái)填充特定的報表設計時(shí)會(huì )使用這個(gè)已系列化的對象。事實(shí)上，報表設計的編譯意指描述報表設計的XML文件中定義的所有Java表達式的編譯。為了檢查報表設計的一致性，在編譯時(shí)做各種檢驗。結果被準備用來(lái)填 充報表設計，然后被用來(lái)以不同的數據集來(lái)產(chǎn)生文檔 。
為了填充一個(gè)報表設計，可使用由dori.jasper.engine.JasperManager類(lèi)暴露的 fillReportXXX()方法。這些方法接受作為參數的報表設計對象,或描述特定報表設計對象的文件, 在一個(gè)系列化的格式中,和一個(gè)從其中接受數據填 充報表的數據庫JDBC鏈接。
結果是一個(gè)描述準備用來(lái)打印文檔的對象(dori.jasper.engine.JasperPrint)并可被以一個(gè)系列化格式存儲在磁盤(pán)上。 為以后使用，或可被分發(fā)到打印機，到屏幕或可被轉換到一個(gè)PDF, HTML, XLS, CSV 或XML文檔。
二． JasperReports快速使用流程
1. 主要類(lèi)
運行JasperReports 時(shí)使用的主要類(lèi)
dori.jasper.engine.JasperCompileManager
dori.jasper.engine.JasperFillManager
dori.jasper.engine.JasperPrintManager
dori.jasper.engine.JasperExportManager
這些類(lèi)表現JasperReports引擎的正面（façade）, 他們有各種靜態(tài)方法簡(jiǎn)化API功能的訪(fǎng)問(wèn)并用來(lái)編譯一個(gè)XML報表設計、填充報表、打印它或輸出到PDF, HTML和 XML文件。
dori.jasper.view.JasperViewer
這個(gè)可用來(lái)觀(guān)察產(chǎn)生的報表。
dori.jasper.view.JasperDesignViewer
這個(gè)可用來(lái)觀(guān)察報表設計。
2. 編譯報表設計
報表設計由一個(gè)具有在jasperreport.dtd 文件中定義的結構的XML文件來(lái)表現。為了根據這樣的報表設計來(lái)產(chǎn)生報表，需要編譯它。
編譯可通過(guò)使用由dori.jasper.engine.JasperCompileManager 類(lèi)暴露的compileReportXXX()方法來(lái)完成。
當編譯一個(gè)報表設計時(shí)，引擎會(huì )創(chuàng )建一個(gè)包括所有報表表示式的Java類(lèi)文件，這個(gè)類(lèi)是使用Java編譯器編譯并在結果.jasper文件中存儲字節碼。
默認情況下，JasperReports使用目前JVM類(lèi)路徑來(lái)編譯報表文件(java.class.path系統屬性)并以目前工作目錄作為產(chǎn)生文件的臨時(shí)存放位置。
為了定制報表編譯過(guò)程，JasperReports充許通過(guò)提供一個(gè)值給系統屬性jasper.reports.compile.class.path來(lái)覆蓋默認行為,這將被用報表類(lèi)編譯的類(lèi)路徑，賦一個(gè)值給系統屬性jasper.reports.compile.temp，這個(gè)將被用作臨時(shí)目錄
XML驗證默認是打開(kāi)的，可通過(guò)設定系統屬性jasper.reports.compilation.xml.validation 為false來(lái)關(guān)閉。
如果你想使用一個(gè)不同的Java編譯器，如jikes,你可以使用jasper.reports.compiler系統屬性來(lái)提供編譯器程序的名字。在你使用jikes情況下，請確信你將rt.jar文件加入到類(lèi)路徑中，可通過(guò)上面提及的系統屬性 jasper.reports.compile.class.path。
You can see some of those in action in the supplied "webapp" samples. Check the jsp/compile.jsp and WEB-INF/classes/servlets/CompileServlet.java files.
3. 觀(guān)察報表設計
報表設計可通過(guò)使用dori.jasper.view.JasperDesignViewer應用程序來(lái)察看。在其main()方法中，它接收那些包括報表設計的文件的名字來(lái)觀(guān)看。這可以是XML文件或編譯過(guò)的報表設計。
4. 填充報表
一個(gè)編譯過(guò)的報表設計可通過(guò)調用dori.jasper.engine.JasperFillManager 類(lèi)的fillReportXXX()方法來(lái)產(chǎn)生報表。
5. 觀(guān)看報表
產(chǎn)生的報表可通使用dori.jasper.view.JasperViewer應用來(lái)觀(guān)看。在其main()方法中它接受包括報表的文件的名字來(lái)觀(guān)看。
6. 打印報表
產(chǎn)生的報表可使用doriJasper.engine.JasperPrintManager 類(lèi)暴露的靜態(tài)方法printReport(), printPage()或printPages()來(lái)打印。
7.導出到PDF, HTML 或XML格式
在已經(jīng)填充一個(gè)報表后，我們也可以通過(guò)使用dori.jasper.engine.JasperExportManager類(lèi)的exportReportXXX()方法來(lái)以 PDF, HTML或XML格式導出它。
三． 技術(shù)指南簡(jiǎn)述
1.報表設計
一個(gè)報表設計描述一個(gè)被JasperReports引擎用來(lái)分發(fā)動(dòng)態(tài)內容到打印機，到屏幕或到WEB的模板。存儲在數據庫中的數據根據報表設計被組織達到準備到打印，頁(yè)面導向文檔。
報表設計是在XML文件中定義并且必有一個(gè)特別的結構。此結構是在一個(gè)由JasperReports 引擎一起提供的DTD文件中聲明的(XML類(lèi)型定義文件jasperreport.dtd)。然后編譯XML文件，為了在后面的報表填充操作中使用他們。
為了創(chuàng )建一個(gè)簡(jiǎn)單的報表設計，我們不得不編輯一個(gè)有以下結構的XML文件：
<?xml version="1.0"?>
<!DOCTYPE jasperReport PUBLIC "-//JasperReports//DTD Report Design//EN"
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">
<jasperReport name="name_of_the_report" ... >
...
</jasperReport>
2.參數
參數是傳入到報表填充操作的對象引用
參數可的構造SQL查詢(xún)
3.數據源
JasperReports使用一個(gè)叫JRDataSource的接口來(lái)支持各種類(lèi)型的數據源
4.字段
報表字段代表從數據源映射數據到報表產(chǎn)生程序的唯一途徑
5.表達式
表達式是JasperReports的強大特點(diǎn)，它們可被聲明的報表變量使用來(lái)執行各種計算。
6.變量
報表變量是才一個(gè)表達式開(kāi)始時(shí)建立的特殊的對象。
變量可以在相應的表達式中執行內置類(lèi)型的計算，如：count，sum，average，lowest，highest等
7.報表區
當我們建立一個(gè)報表設計時(shí)，我們需要定義報表區的內容和布局。報表設計的整個(gè)結構基于以下報表區<title>, <pageHeader>, <columnHeader>, <groupHeader>, <detail>, <groupFooter>, <columnFoter>, <pageFooter>, <summary>.
8.組
組代表了在報表上組織數據的一個(gè)靈活的方式，當我們填充一個(gè)報表時(shí)，JasperReports引擎可字段檢測組表達式<groupFooter> 和 <groupHeader>等是否完整。
9.字體和Unicode支持
你可以用任何語(yǔ)言來(lái)創(chuàng )建你的報表。
10. Scriptlets
Scriptlets是java代碼序列，在每次報表事件發(fā)生時(shí)被執行。通過(guò) scriptlets，用戶(hù)可以影響被報表變量存儲的值。
當我們創(chuàng )建一個(gè)JasperReports scriptlet類(lèi)時(shí)，開(kāi)發(fā)者要實(shí)現或重載幾個(gè)方法，象：beforeReportInit(), afterReportInit(), beforePageInit(), afterPageInit(), beforeGroupInit(), afterGroupInit()等，這些方法當填充報表時(shí)在適當的時(shí)候被報表引擎調用。
11.子報表
子報表是報表產(chǎn)生工具的重要特征，它允許更復雜報表的創(chuàng )建并簡(jiǎn)化設計工作。
子報表在創(chuàng )建主從報表時(shí)非常有用。
聯(lián)系客服
