soufan

posted @ 2006-12-21 17:13 soufan 閱讀(4091) | 評論 (0) | 編輯收藏

1．簡介

JasperReport是一個(gè)強(qiáng)大的開源報(bào)表工具，它可以傳送豐富的報(bào)表內(nèi)容到顯示器、打印機(jī)或者PDF、HTML、XLS、CSV、XML文件。它完全使用Java編寫，可以在各種Java應(yīng)用中用來創(chuàng)建動態(tài)報(bào)表內(nèi)容。它的主要目標(biāo)是用簡單靈活的方法幫助創(chuàng)建便于打印的分頁文檔。

JasperReport根據(jù)一個(gè)xml報(bào)表設(shè)計(jì)文件來組織從JDBC獲得的關(guān)系數(shù)據(jù)庫數(shù)據(jù)。要用數(shù)據(jù)填充報(bào)表，首先必須編譯報(bào)表。編譯xml的報(bào)表設(shè)計(jì)文件是用JasperManager類的compileReport()方法完成的。

通過編譯，報(bào)表設(shè)計(jì)被加載到一個(gè)報(bào)表設(shè)計(jì)對象（net.sf.jasperreports.engine.JasperReport類的實(shí)例）中并被序列化然后保存。在應(yīng)用程序用數(shù)據(jù)填充報(bào)表時(shí)使用該序列化文件。實(shí)際上，報(bào)表編譯完成了報(bào)表設(shè)計(jì)中所有的java表達(dá)式的編譯。很多檢查工作在編譯期間進(jìn)行以確保報(bào)表設(shè)計(jì)的完整性，編譯后的文件是待填充的報(bào)表，以方便應(yīng)用程序用各種數(shù)據(jù)集來產(chǎn)生不同的報(bào)表文檔。

要填充報(bào)表，可以使用JasperManager類的fillReportXXX()方法。這些方法接受一個(gè)參數(shù)代表報(bào)表設(shè)計(jì)——可以是一個(gè)JasperDesign對象，也可以是一個(gè)存放該類對象的文件名——還有一個(gè)獲得填充報(bào)表數(shù)據(jù)的JDBC連接。報(bào)表填充的結(jié)果是一個(gè)表示待打印文檔的對象（net.sf.jasperreports.engine.JasperPrint類的實(shí)例），可以被序列化保存以后繼續(xù)使用，或者傳送給打印機(jī)、顯示器，或者導(dǎo)出成PDF、HTML、XLS、CSV或者XML文件。

2．報(bào)表設(shè)計(jì)

一個(gè)報(bào)表設(shè)計(jì)表示一個(gè)模版用來被JasperReport引擎填充數(shù)據(jù)并傳送到屏幕、打印機(jī)或者Web。數(shù)據(jù)庫的數(shù)據(jù)根據(jù)報(bào)表設(shè)計(jì)被組織來填充報(bào)表以得到待打印的分頁文檔。報(bào)表設(shè)計(jì)都保存到一個(gè)特定結(jié)構(gòu)的一個(gè)XML文件中，文件結(jié)構(gòu)定義在一個(gè)JasperReport引擎可以識別的DTD文件中。然后這些xml文件會被編譯以準(zhǔn)備報(bào)表填充操作。

創(chuàng)建一個(gè)報(bào)表設(shè)計(jì)（模版），必須按照如下結(jié)構(gòu)編輯一個(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>

3．報(bào)表參數(shù)

報(bào)表參數(shù)是傳遞給報(bào)表填充操作的對象的引用，為報(bào)表引擎?zhèn)鬟f它無法在數(shù)據(jù)源中找到的數(shù)據(jù)是非常有用的。例如，我們可以將登陸執(zhí)行報(bào)表填充操作的用戶名傳給引擎，這樣我們可以在報(bào)表上顯示制表人或者動態(tài)改變報(bào)表的標(biāo)題。

一個(gè)使用報(bào)表參數(shù)的重要作用是完成報(bào)表的動態(tài)查詢語句，以使報(bào)表獲得的數(shù)據(jù)更加符合要求，這些參數(shù)就像報(bào)表數(shù)據(jù)的過濾器。

在報(bào)表中聲明參數(shù)非常簡單，只需要指定名稱和類型（java類）：

<parameter name="ReportTitle" class="java.lang.String"/>

<parameter name="MaxOrderID" class="java.lang.Integer"/>

<parameter name="SummaryImage" class="java.awt.Image"/>

可以用兩種方法在查詢語句中使用報(bào)表參數(shù)：

1. 就像通常在java.sql.PreparedStatement中使用參數(shù)一樣：

SELECT * FROM Orders WHERE OrderID <= $P{MaxOrderID} ORDER BY ShipCountry

2. 有時(shí)需要用參數(shù)來動態(tài)改變SQL查詢的部分語句或者將整個(gè)SQL語句作為參數(shù)傳給報(bào)表，在這種情況下，語法有一點(diǎn)不同，如下：

SELECT * FROM Orders ORDER BY $P!{OrderByClause}

還有一些報(bào)表內(nèi)建的系統(tǒng)參數(shù)可以直接在表達(dá)式中使用：

REPORT_PARAMETERS_MAP

REPORT_CONNECTION

REPORT_DATA_SOURCE

REPORT_SCRIPTLET

4．數(shù)據(jù)源

JasperReport只是各種類型的數(shù)據(jù)源，并提供一個(gè)JRDataSource的接口。該有一個(gè)缺省的實(shí)現(xiàn)類（JRResultSetDataSource class）包裝了ResultSet對象，允許使用任何通過JDBC連接的數(shù)據(jù)庫。使用JDBC數(shù)據(jù)源時(shí)，即可以通過將數(shù)據(jù)庫連接傳給報(bào)表填充引擎并在報(bào)表定義中指定一個(gè)SQL查詢語句（參考dtd定義中的<queryString>元素）來提供數(shù)據(jù)，也可以直接用ResultSet作參數(shù)生成JRResultSetDataSource對象來提供數(shù)據(jù)。

對于其他的數(shù)據(jù)源，也不會太麻煩，只需要實(shí)現(xiàn)JRDataSource接口來創(chuàng)建自己的數(shù)據(jù)源類。

5．字段

報(bào)表字段提供了唯一映射數(shù)據(jù)源中數(shù)據(jù)到報(bào)表數(shù)據(jù)的方式。如果數(shù)據(jù)源是ResultSet對象，報(bào)表字段必須對應(yīng)ResultSet對象中的列，就是說報(bào)表字段必須和對應(yīng)的列有相同的名字和匹配的類型。

例如，我們要創(chuàng)建的報(bào)表需要用Employees表的數(shù)據(jù)，該表結(jié)構(gòu)如下：

Column Name Datatype Length
--------------------------------------
EmployeeID int 4
LastName varchar 20
FirstName varchar 10
HireDate datetime 8
我們可以在報(bào)表設(shè)計(jì)文件中定義如下的字段：

<field name="EmployeeID" class="java.lang.Integer"/>
<field name="LastName" class="java.lang.String"/>
<field name="FirstName" class="java.lang.String"/>
<field name="HireDate" class="java.util.Date"/>
如果我們生命一個(gè)報(bào)表字段在ResultSet中沒有對應(yīng)的列，則會在運(yùn)行時(shí)拋出異常。當(dāng)然ResultSet中的列沒有被聲明為報(bào)表字段不會影響報(bào)表的數(shù)據(jù)填充，但是他們?nèi)匀皇强梢栽L問的。

6．表達(dá)式

表達(dá)式是JasperReport的一個(gè)很強(qiáng)大有用的特性。用表達(dá)式可以：聲明報(bào)表變量來完成各種計(jì)算，為數(shù)據(jù)分組，指定報(bào)表文本字段內(nèi)容或?qū)ζ渌麍?bào)表對象的顯示進(jìn)行更靈活的定制?；旧?，所有的報(bào)表表達(dá)式都是Java表達(dá)式，并且可以引用報(bào)表字段和報(bào)表變量。

在報(bào)表設(shè)計(jì)的xml文件中有諸多定義表達(dá)式的元素：<variableExpression>, <initialValueExpression>, <groupExpression>, <printWhenExpression>, <imageExpression> 和<textFieldExpression>。

要在在表達(dá)式中引用報(bào)表字段，字段名必須寫在$F{和}符號之間。例如，如果我們要在一個(gè)文本域中連接兩個(gè)字段，我們可以像下面定義表達(dá)式：

<textFieldExpression>
$F{FirstName} + " " + $F{LastName}
</textFieldExpression>
表達(dá)式可以更復(fù)雜：

<textFieldExpression>
$F{FirstName} + " " + $F{LastName} + " was hired on " +
(new SimpleDateFormat("MM/dd/yyyy")).format($F{HireDate}) + "."
</textFieldExpression>
要在表達(dá)式中引用一個(gè)變量，必須將變量名寫在$V{和}符號之間，如下：

<textFieldExpression>
"Total quantity : " + $V{QuantitySum} + " kg."
</textFieldExpression>
對于報(bào)表參數(shù)也是同樣的語法，只不過參數(shù)名必須寫在$P{和}符號之間：

<textFieldExpression>
"Max Order ID is : " + $P{MaxOrderID}
</textFieldExpression>

7．變量

報(bào)表變量是在表達(dá)式之前構(gòu)建的專用對象。變量只聲明一次，而可以在整個(gè)報(bào)表設(shè)計(jì)中重復(fù)使用，并在對應(yīng)的表達(dá)式中完成大量的計(jì)算，從而簡化了報(bào)表設(shè)計(jì)。在表達(dá)式中，一個(gè)變量可以引用其它變量，但是被引用變量必須在引用變量之前聲明。所以變量的聲明順序?qū)?bào)表設(shè)計(jì)也是很重要的。

變量還可以聲明來完成引擎內(nèi)建計(jì)算的求值，如：count、sum、average、lowest、highest、variance等等。一個(gè)完成Quantity字段sum計(jì)算的變量定義如下：

<variable name="QuantitySum"

class="java.lang.Double" calculation="Sum">

<variableExpression>$F{Quantity}</variableExpression>

</variable>

我們還可以通過制定初始化級別來改變計(jì)算過程，默認(rèn)的級別是Report就是變量僅在報(bào)表開始處初始化一次，一直到報(bào)表結(jié)束完成計(jì)算。我們可以選擇更低的級別讓變量在每個(gè)Page、Column或者Group級別重新初始化。假如我們想計(jì)算計(jì)算每頁的總數(shù)，變量聲明如下：

<variable name="QuantitySum" class="java.lang.Double"
resetType="Page" calculation="Sum">
<variableExpression>$F{Quantity}</variableExpression>
<initialValueExpression>new Double(0) </initialValueExpression>
</variable>
變量將在每一頁的開始處被初始化為0。

引擎還提供了如下的內(nèi)建變量可以在表達(dá)式中直接使用：

PAGE_NUMBER
COLUMN_NUMBER
REPORT_COUNT
PAGE_COUNT
COLUMN_COUNT
GroupName_COUNT

8．報(bào)表區(qū)域

在創(chuàng)建報(bào)表模板時(shí)，我們需要定義報(bào)表區(qū)域的內(nèi)容和風(fēng)格。一個(gè)完全的報(bào)表模板包括如下幾個(gè)區(qū)域：<title>, <pageHeader>, <columnHeader>, <groupHeader>, <detail>, <groupFooter>, <columnFoter>, <pageFooter>, <summary>。區(qū)域是報(bào)表的重要組成部分，它有指定的高度和寬度，并且可以容納直線、矩形、圖片或者文本域等報(bào)表對象。我們用<band>標(biāo)簽在報(bào)表模板xml文件中定義報(bào)表區(qū)域的內(nèi)容和風(fēng)格。下面是一個(gè)PageHeader區(qū)域的定義，它僅僅包含一條直線和一個(gè)靜態(tài)文本：

<pageHeader>
<band height="30">
<rectangle>
<reportElement x="0" y="0" width="555" height="25"/>
<graphicElement/>
</rectangle>
<staticText>
<reportElement x="0" y="0" width="555" height="25"/>
<textElement textAlignment="Center">
<font fontName="Helvetica" size="18"/>
</textElement>
<text>Northwind Order List</text>
</staticText>
</band>
</pageHeader>

9．分組

組表示一種分組組織數(shù)據(jù)的方式。填充報(bào)表數(shù)據(jù)時(shí)，JasperReport引擎計(jì)算所有定義的分組表達(dá)式檢查是否出現(xiàn)組邊界（表達(dá)式的值改變），如果遇到組邊界則將<groupFooter>和<groupHeader>報(bào)表區(qū)域加入報(bào)表。

報(bào)表可以包含任意多的分組，組在報(bào)表中的聲明順序很重要，因?yàn)榻M之間相互包含。一個(gè)組包含其后聲明組依此類推，一個(gè)大的組遇到邊界，所有的子組都將被重新初始化。一個(gè)報(bào)表組跟其數(shù)據(jù)分組表達(dá)式一起定義，同時(shí)還需要定義兩個(gè)報(bào)表分組區(qū)域：分組頭區(qū)域和分組尾區(qū)域。

關(guān)于分組的詳細(xì)信息參考分組的報(bào)表示例。

10．字體和Unicode支持

現(xiàn)在你可以用任何語言來創(chuàng)建報(bào)表。<font>元素的新屬性允許在Java字體和PDF字體間映射。PDF使用特定的字體集使得以前的JasperReport版本沒有辦法使用它們。新的屬性使用戶可以指定什么PDF字體用來顯示不同的字符集（pdfFontName屬性），什么編碼類型（pdfEncoding屬性）和是否將字體嵌入PDF文檔（isPdfEmbedded）。

為了簡化字體集的使用，增加了一個(gè)新屬性<reportFont>。報(bào)表字體是報(bào)表級別的字體定義用來作為報(bào)表中其他顯示對象的默認(rèn)字體。因?yàn)閷H字符集的支持不知為何被綁定到iText庫，你可以在iText documentation.文當(dāng)中找到更多關(guān)于如何用不同的語言不同的字符集創(chuàng)建PDF文檔的信息。

11． Scriptlets

所有的報(bào)表顯示數(shù)據(jù)來自報(bào)表變量和報(bào)表字段，這些數(shù)據(jù)可以用報(bào)表變量和表達(dá)式來處理。

有時(shí)候報(bào)表需要對變量進(jìn)行特殊處理，一些變量可能在報(bào)表的某個(gè)事件中（報(bào)表開始、換頁或者換列）被重新初始化，而且，變量在每次從數(shù)據(jù)源中獲得數(shù)據(jù)時(shí)（每一行）都被計(jì)算。而僅僅用簡單變量表達(dá)式無法實(shí)現(xiàn)所有的復(fù)雜功能，這時(shí)就要使用Scriptlet。

因?yàn)镾criptlet主要和報(bào)表變量一起工作，完全控制scriptlet的執(zhí)行時(shí)機(jī)非常重要。JasperReport允許根據(jù)報(bào)表事件定制Java編碼BEFORE或者AFTER：Report、Page、Column和Group的初始化來執(zhí)行Scriptlet。

要使用Scriptlet，開發(fā)者只需要通過繼承net.sf.jasperreports.engine.JRAbstractScriptlet或者net.sf.jasperreports.engine.JRDefaultScriptlet來創(chuàng)建Scritplet類。該定制的Scriptlet類會被指定為<jasperReport>的scritpletClass屬性的值。創(chuàng)建Scriptlet時(shí)開發(fā)這需要實(shí)現(xiàn)或者重載如beforeReportInit(), afterReportInit(), beforePageInit(), afterPageInit(), beforeGroupInit(), afterGroupInit(),等方法。這些方法將在填充數(shù)據(jù)時(shí)被引擎在適當(dāng)?shù)臅r(shí)候調(diào)用。

有一個(gè)叫做REPORT_SCRIPTLET的默認(rèn)報(bào)表參數(shù)表示對報(bào)表引擎在填充數(shù)據(jù)時(shí)實(shí)例化的Scriptlet對象的引用。它可以在整個(gè)報(bào)表的任何表達(dá)式中使用來調(diào)用Scriptlet的特定方法使整個(gè)報(bào)表機(jī)制更加靈活。

12．子報(bào)表
子報(bào)表是報(bào)表工具的重要特性，它允許創(chuàng)建更復(fù)雜的報(bào)表并簡化設(shè)計(jì)工作。自報(bào)表在創(chuàng)建主從報(bào)表時(shí)特別有用。

soufan

常用鏈接

留言簿(1)

隨筆檔案

搜索

最新評論

閱讀排行榜

評論排行榜

(原)Java 專業(yè)人士必備的書籍和網(wǎng)站列表


		Roy Miller 是一名獨(dú)立軟件開發(fā)培訓(xùn)師、程序員兼作家，他在充滿挑戰(zhàn)、快節(jié)奏的咨詢公司里從事了十多年軟件開發(fā)和項(xiàng)目管理工作。他最初在 Andersen Consulting（現(xiàn)在是 Accenture）公司工作，在那里，他管理團(tuán)隊(duì)實(shí)現(xiàn)了許多系統(tǒng)，從主機(jī)記帳系統(tǒng)到星形模式數(shù)據(jù)集市。最近三年來，他在北卡羅來納州 Holly Springs 的 RoleModel Software, Inc. 公司工作，在那里他專業(yè)地運(yùn)用著 Java 技術(shù)，并擔(dān)任開發(fā)人員兼 Extreme Programming (XP) 培訓(xùn)師。他與人合著了 Addison-Wesley XP 系列的 Extreme Programming Applied: Playing to Win 一書，最近他寫了 Managing Software for Growth: Without Fear, Control and the Manufacturing Mindset 一書，來幫助經(jīng)理和管理層理解：像 XP 這樣的敏捷構(gòu)建方法為什么比傳統(tǒng)的方法更有效。2003 年，他創(chuàng)辦了自己的公司：The Other Road，該公司幫助其他公司了解如何向 XP 和被他稱為 Extreme Business (XB) 的方法轉(zhuǎn)換。