JasperReport?用戶指南(轉貼)?
一.????JasperReports簡介
JasperReports是一個強力的報表產生工具,他有能力描述豐富內容到屏幕上、到打印機或到PDF,?HTML,?XLS,?CSV和XML文件。它完全用Java編寫的,并可在各種Java應用(包括J2EE或WEB應用)中用來產生動態內容。它的主要目的是以一種簡單而靈活的方式來幫助創建導向的頁面。
JasperReports組織根據在一個XML文件中定義的報表設計通過JDBC來接受來自一個關系數據庫中的數據.?為了以數據來填充報表,報表設計必須首先被編譯。
描述報表設計的XML文件的編譯通過執行dori.jasper.engine.JasperManager?類暴露的compileReport()方法。
通過編譯,報表設計被裝載入一個報表設計對象中,然后系列化并存儲在磁盤上(dori.jasper.engine.JasperReport)。當應用程序想以數據來填充特定的報表設計時會使用這個已系列化的對象。事實上,報表設計的編譯意指描述報表設計的XML文件中定義的所有Java表達式的編譯。為了檢查報表設計的一致性,在編譯時做各種檢驗。結果被準備用來填?充報表設計,然后被用來以不同的數據集來產生文檔?。
為了填充一個報表設計,可使用由dori.jasper.engine.JasperManager類暴露的?fillReportXXX()方法。這些方法接受作為參數的報表設計對象,或描述特定報表設計對象的文件,?在一個系列化的格式中,和一個從其中接受數據填?充報表的數據庫JDBC鏈接。
結果是一個描述準備用來打印文檔的對象(dori.jasper.engine.JasperPrint)并可被以一個系列化格式存儲在磁盤上。?為以后使用,或可被分發到打印機,到屏幕或可被轉換到一個PDF,?HTML,?XLS,?CSV?或XML文檔。
二.????JasperReports快速使用流程
1.????主要類
運行JasperReports?時使用的主要類
dori.jasper.engine.JasperCompileManager
dori.jasper.engine.JasperFillManager
dori.jasper.engine.JasperPrintManager
dori.jasper.engine.JasperExportManager
這些類表現JasperReports引擎的正面(fa?ade),?他們有各種靜態方法簡化API功能的訪問并用來編譯一個XML報表設計、填充報表、打印它或輸出到PDF,?HTML和?XML文件。
dori.jasper.view.JasperViewer
這個可用來觀察產生的報表。
dori.jasper.view.JasperDesignViewer
這個可用來觀察報表設計。
2.?編譯報表設計
報表設計由一個具有在jasperreport.dtd?文件中定義的結構的XML文件來表現。為了根據這樣的報表設計來產生報表,需要編譯它。
編譯可通過使用由dori.jasper.engine.JasperCompileManager?類暴露的compileReportXXX()方法來完成。
當編譯一個報表設計時,引擎會創建一個包括所有報表表示式的Java類文件,這個類是使用Java編譯器編譯并在結果.jasper文件中存儲字節碼。?
默認情況下,JasperReports使用目前JVM類路徑來編譯報表文件(java.class.path系統屬性)并以目前工作目錄作為產生文件的臨時存放位置。
為了定制報表編譯過程,JasperReports充許通過提供一個值給系統屬性jasper.reports.compile.class.path來覆蓋默認行為,這將被用報表類編譯的類路徑,賦一個值給系統屬性jasper.reports.compile.temp,這個將被用作臨時目錄?
XML驗證默認是打開的,可通過設定系統屬性jasper.reports.compilation.xml.validation?為false來關閉。
如果你想使用一個不同的Java編譯器,如jikes,你可以使用jasper.reports.compiler系統屬性來提供編譯器程序的名字。在你使用jikes情況下,請確信你將rt.jar文件加入到類路徑中,可通過上面提及的系統屬性?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.?觀察報表設計?
報表設計可通過使用dori.jasper.view.JasperDesignViewer應用程序來察看。在其main()方法中,它接收那些包括報表設計的文件的名字來觀看。這可以是XML文件或編譯過的報表設計。?
4.?填充報表?
一個編譯過的報表設計可通過調用dori.jasper.engine.JasperFillManager?類的fillReportXXX()方法來產生報表。
5.?觀看報表?
產生的報表可通使用dori.jasper.view.JasperViewer應用來觀看。在其main()方法中它接受包括報表的文件的名字來觀看。
6.?打印報表
產生的報表可使用doriJasper.engine.JasperPrintManager?類暴露的靜態方法printReport(),?printPage()或printPages()來打印。
7.導出到PDF,?HTML?或XML格式
在已經填充一個報表后,我們也可以通過使用dori.jasper.engine.JasperExportManager類的exportReportXXX()方法來以?PDF,?HTML或XML格式導出它。
三.????技術指南簡述
1.報表設計
一個報表設計描述一個被JasperReports引擎用來分發動態內容到打印機,到屏幕或到WEB的模板。存儲在數據庫中的數據根據報表設計被組織達到準備到打印,頁面導向文檔。
報表設計是在XML文件中定義并且必有一個特別的結構。此結構是在一個由JasperReports?引擎一起提供的DTD文件中聲明的(XML類型定義文件jasperreport.dtd)。然后編譯XML文件,為了在后面的報表填充操作中使用他們。
為了創建一個簡單的報表設計,我們不得不編輯一個有以下結構的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查詢
3.數據源?
JasperReports使用一個叫JRDataSource的接口來支持各種類型的數據源
4.字段
報表字段代表從數據源映射數據到報表產生程序的唯一途徑
5.表達式
表達式是JasperReports的強大特點,它們可被聲明的報表變量使用來執行各種計算。
6.變量
報表變量是才一個表達式開始時建立的特殊的對象。
變量可以在相應的表達式中執行內置類型的計算,如:count,sum,average,lowest,highest等
7.報表區
當我們建立一個報表設計時,我們需要定義報表區的內容和布局。報表設計的整個結構基于以下報表區<title>,?<pageHeader>,?<columnHeader>,?<groupHeader>,?<detail>,?<groupFooter>,?<columnFoter>,?<pageFooter>,?<summary>.
8.組
組代表了在報表上組織數據的一個靈活的方式,當我們填充一個報表時,JasperReports引擎可字段檢測組表達式<groupFooter>?和?<groupHeader>等是否完整。
9.字體和Unicode支持
你可以用任何語言來創建你的報表。
10.?Scriptlets
Scriptlets是java代碼序列,在每次報表事件發生時被執行。通過?scriptlets,用戶可以影響被報表變量存儲的值。
當我們創建一個JasperReports?scriptlet類時,開發者要實現或重載幾個方法,象:beforeReportInit(),?afterReportInit(),?beforePageInit(),?afterPageInit(),?beforeGroupInit(),?afterGroupInit()等,這些方法當填充報表時在適當的時候被報表引擎調用。
11.子報表
子報表是報表產生工具的重要特征,它允許更復雜報表的創建并簡化設計工作。
子報表在創建主從報表時非常有用。
1??首先看看
???http://plateau.sicool.com/main.html上的三篇
???iReport和Jasperreport整合開發報表向導(一)(二)(三)
???看完理解并自己運行一下,OK,你入門了
2??去找一份TheJasperReportsUltimateGuide.1.0.pdf,看完之后你就能
???了解JasperReport生成的基本過程及原理
3??當然是Java研究的這個論壇
???http://www.javaresearch.org/forum/forum.jsp?column=316&start=0&thRange=15
???多往后翻翻看看帖子,很多你要問的問題都能找到答案,還有好幾篇前輩的理會等等?
???都是寶貴的經驗
4??JasperReport最好的資料是什么??
???解壓jasperreports-0.5.0-project.zip?后
???目錄jasperreports\demo\samples下的例子,看看這些例子是你關于這個報表工具提升?
???能力的最好最快的方式,下面我簡要說一下各個例子說的是什么以及有什么用
????alterdesign?該例子演示了報表編譯后,在報表展現的時候如何動態的控制其中的元素
????????????????比如讓某一個矩形變色或其他
????antcompile??演示如何讓?ant?來編譯
????chart???????演示了如何在報表中添加圖像,JasperReport是用Scriptlet的方式
????????????????往報表中添加圖像,而Scriptlet是調用也是開源的jfreechart的Api來
????????????????生成圖形,去jfreechart看一下,該工具能的圖形生成能力也很強
????datasource??演示了如何在報表中使用各種數據源,能夠使用beanarray
????????????????beancollection,也可以用自定義的數據源,只要繼承了JRDataSource的
????????????????兩個接口,這個能給用戶提供非常大的靈活性,報表的數據不用局限于一
????????????????條Sql語句,也可以使用存儲過程,對生成報表中的數據也可以排序,二
????????????????次檢索,等等
????fonts???????各種字體的演示
????horizontal??演示了水平分欄的報表,演示報表中分了三欄,其中還用到了
????????????????textFieldExpression,就像if語句的效果來選擇輸出的內容
????hyperlink???演示了各種樣式的鏈接
????images??????演示了如何在報表中加入圖像以及圖像的顯示方式
????jasper??????演示了分組分欄的報表,演示中用了2次group
????jcharts?????演示了調用另一個開源的API?jcharts來往報表中加入分析圖形,原理同
????????????????上chart,如果jfreechart都還不能滿足你分析圖形的要求,那到jcharts
????????????????里找找看吧,說不定有
????landscape???演示橫向的報表
????nopagebreak?演示比如在IE中不分頁的方式打印出報表的內容,通過這個演示也可以
????????????????了解報表輸出如何配置參數
????noreport????演示了如何直接通過java程序生成JasperPrint對象來輸出
????noxmldesign?演示了如何直接通過java程序生成JasperDesign對象來動態的生成報
????????????????表,根據這個例子,用戶可以作出自定義選列的報表,當然比較麻煩,
????????????????而且肯定自己要補充他的API庫
????????????????(JasperReport真是強大啊,呵呵)????
????pdfencrypt??演示了pdf的輸出方式,可以給pdf文件加密碼,其實就是pdf輸出方式的
????????????????參數配置,具體有那些參數可配置,去看看API吧
????printservice演示了如何直接打印報表
????query???????演示了如何讓查詢的sql動態起來,比如你可以通過一個Jsp頁面傳
????????????????報表的sql的where條件,order條件,甚至整個sql語句
????rotation????演示了文字縱向顯示的報表
????scriptlet???演示了如何繼承JRDefaultScriptlet,并加入自己的處理語句,這個功能
????????????????可是很強大的哦,看看這些接口
????????????????beforeReportInit()??afterReportInit()??beforePageInit()
????????????????afterPageInit()??beforeColumnInit()??afterColumnInit()?
????????????????beforeGroupInit(String?groupName)
????????????????afterGroupInit(String?groupName)??
????????????????看看這些名字就知道你能完成那些功能,比如顯示一列數據后,馬上跟
????????????????上該列數據的分析圖形,當然你也可以加上自己的方法并在報表中調用
????shapes??????演示了JasperReport中自帶的圖形,及能配置的參數
????????????????當然你也能繼承或者覆寫JasperReport中的Api生成你要的圖形,
????stretch?????演示了如何處理報表中數據拉伸以及帶來周圍的線及框的拉伸,
????????????????你能了解到雖然黑框式表格不是JasperReport中缺省的展現方式,
????????????????但在JasperReport中不難實現
????subreport???演示了子報表,還告訴你一個報表中可以有n個子報表,子報表中還可以
????????????????嵌套子報表
????tableofcontents??演示了如何生成一個有目錄的,復雜的報表
????unicode?????演示了各種?字符編碼
????webapp??????演示了如何把報表放到一個JavaWeb項目中,可以用Jsp?Servlet
????????????????applet,筆者做了一個
????????????????有參數頁面,可以選擇html?pdf?applet輸出方式的報表,有興趣的?
????????????????我可以在后面放上代碼
5??比上面更好的資料是什么,就是JasperReport的源代碼,看懂源代碼,JasperReport
???就是在你腦子里的了,你想干什么都行了,優化代碼,覆寫,繼承他的類,實現個性
???化的功能,甚至你可以參考他的思想,升華一下,做一個你自己的報表
?