JasperReports報表表達式

報表表達式是JasperReports使我們能夠顯示在報表上的數據計算的強大功能。計算出數據不是一個靜態數據,並且不受特別的報表參數或數據源字段傳遞的數據。報表表達式是由組合報表參數,字段和靜態數據。默認情況下,Java語言是用於編寫報表的表達式。其他腳本語言如Groovy腳本語言,JavaScript或BeanShell腳本,報表表達式是由JasperReports編譯器支持。

本章將解釋如何報表表達式工作假設他們一直只用Java語言編寫的。在JRXML報表模板,那裏有定義表達式幾個元素,如下所示:

聲明表達式

基本上,所有的報表表達式是可以參考的報表字段,報表變量和報表參數Java表達式。

字段引用表達式

使用在表達式中一個報表字段參考,字段的名稱必須放在$F{ 和 }字符序列之間,如下圖所示。 

$F{Name}

下面是一段代碼從我們現有的jrxml文件,從報表設計 章節中瞭解:

<textFieldExpression class="java.lang.String"> <![CDATA[$F{country}]]>

變量引用表達式

引用在表達式中的變量,我們必須把像在下面的例子中的變量名放在$V {和}之間:

"Total height : " + $V{SumOfHeight} + " ft."

參數參考表達

引用在表達式中的一個參數,該參數的名稱應放在$ P{和}之間,如下面的例子:

"ReportTitle : " + $P{Title}

下面是一段代碼從現有的jrxml文件,這用來表示參數在表達式中引用。 

<textField isBlankWhenNull="true" bookmarkLevel="1"> <reportElement x="0" y="10" width="515" height="30"/> <textElement textAlignment="Center"> <font size="22"/> <textFieldExpression class="java.lang.String"> <![CDATA[$P{ReportTitle}]]> <![CDATA["Title"]]> <textField isBlankWhenNull="true"> <reportElement x="0" y="40" width="515" height="20"/> <textElement textAlignment="Center"> <font size="10"/> <textFieldExpression class="java.lang.String"> <![CDATA[$P{Author}]]>

正如在上面看到,參數,字段和變量引用,其實是真正的Java對象。從參數,字段或在報表模板所作的變量聲明知道他們的類,甚至可以在表達式中調用的對象引用的方法。

下面的示例演示如何提取並顯示java.lang.String報表字段的第一個字母 "Name":

$F{Name}.substring(0, 1)

資源包參考表達

引用在表達式中的資源,關鍵要$R{和}之間放像下面的例子:

$R{report.title}

基於運行時提供的語言環境和report.title鍵,報表模板相關的資源包加載。因此,報表標題是從資源包中提取字符串值顯示。更多關於國際化可以在國際化一章中找到。

計算器

計算器是JasperReports,其計算表達式和增量變量或數據集在報表填充時間的實體。在編譯過程中,信息被產生並存儲在由編譯器在編譯報表。在報表,填充時間此信息用於構建net.sf.jasperreports.engine.fill.JRCalculator類的一個實例。

Java源文件生成,並通過對飛基於Java的報表編譯器編譯。這個生成的類是JRCalculator子類,並通過將其編譯產生的字節碼存儲在JasperReport對象的內部。bytcode被加載在報表填充時間和由此產生的類被實例化,以獲得所需的表達式求值計算器對象。

條件表達式

定義變量表達式時,Jasper報表不支持if-else語句。相反,可以使用三元運算符{cond}? {語句1}:{語句2}。可以嵌套這個操作符Java表達式裏面獲得基於多個條件所需的輸出。

在報表條件表達式的示例

讓我們修改現有報告的模板(第報表設計),並增加對country條件表達式。修訂後的報表模板(jasper_report_template.jrxml)如下。將其保存到 C: oolsjasperreports-5.0.1 est 目錄:

<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" name="jasper_report_template" pageWidth="595" pageHeight="842" columnWidth="515" leftMargin="40" rightMargin="40" topMargin="50" bottomMargin="50"> <parameter name="ReportTitle" class="java.lang.String"/> <parameter name="Author" class="java.lang.String"/> <![CDATA[]]> <field name="country" class="java.lang.String"> <![CDATA[country]]> <field name="name" class="java.lang.String"> <![CDATA[name]]> <sortField name="country" order="Descending"/> <sortField name="name"/> <band height="70"> <line> <reportElement x="0" y="0" width="515" height="1"/> </line> <textField isBlankWhenNull="true" bookmarkLevel="1"> <reportElement x="0" y="10" width="515" height="30"/> <textElement textAlignment="Center"> <font size="22"/> </textElement> <textFieldExpression class="java.lang.String"> <![CDATA[$P{ReportTitle}]]> </textFieldExpression> <anchorNameExpression><![CDATA["Title"]]> </anchorNameExpression> </textField> <textField isBlankWhenNull="true"> <reportElement x="0" y="40" width="515" height="20"/> <textElement textAlignment="Center"> <font size="10"/> </textElement> <textFieldExpression class="java.lang.String"> <![CDATA[$P{Author}]]> </textFieldExpression> </textField> </band> <band height="23"> <reportElement mode="Opaque" x="0" y="3" width="535" height="15" backcolor="#70A9A9" /> <bottomPen lineWidth="1.0" lineColor="#CCCCCC" /> <![CDATA[]]> <reportElement x="414" y="3" width="121" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle"> <font isBold="true" /> <![CDATA[Country]]> <reportElement x="0" y="3" width="136" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle"> <font isBold="true" /> <![CDATA[Name]]> <band height="16"> <reportElement mode="Opaque" x="0" y="0" width="535" height="14" backcolor="#E5ECF9" /> <bottomPen lineWidth="0.25" lineColor="#CCCCCC" /> <![CDATA[]]> <reportElement x="414" y="0" width="121" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle"> <font size="9" /> <textFieldExpression class="java.lang.String"> <![CDATA[$F{country}.isEmpty() ? "NO COUNTRY" : $F{country}]]> <reportElement x="0" y="0" width="136" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle" /> <textFieldExpression class="java.lang.String"> <![CDATA[$F{name}]]>

Java代碼填充報表如下。該文件的內容 C: oolsjasperreports-5.0.1 estsrccomyiibaiJasperReportFill.java 如下所述。

package com.yiibai; import java.util.ArrayList; import java.util.HashMap; import java.util.Map; import net.sf.jasperreports.engine.JRException; import net.sf.jasperreports.engine.JasperFillManager; import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource; public class JasperReportFill { @SuppressWarnings("unchecked") public static void main(String[] args) { String sourceFileName = "C://tools/jasperreports-5.0.1/test/jasper_report_template.jasper"; DataBeanList DataBeanList = new DataBeanList(); ArrayList<DataBean> dataList = DataBeanList.getDataBeanList(); JRBeanCollectionDataSource beanColDataSource = new JRBeanCollectionDataSource(dataList); Map parameters = new HashMap(); /**
* Passing ReportTitle and Author as parameters
*/ parameters.put("ReportTitle", "List of Contacts"); parameters.put("Author", "Prepared By Manisha"); try { JasperFillManager.fillReportToFile( sourceFileName, parameters, beanColDataSource); } catch (JRException e) { e.printStackTrace(); } } }

POJO文件的內容 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBean.java 情況如下:

package com.yiibai; public class DataBean { private String name; private String country; public String getName() { return name; } public void setName(String name) { this.name = name; } public String getCountry() { return country; } public void setCountry(String country) { this.country = country; } }

將增加country字段在Java bean列表爲空的新紀錄。該文件的內容C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBeanList.java 情況如下:

package com.yiibai; import java.util.ArrayList; public class DataBeanList { public ArrayList<DataBean> getDataBeanList() { ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>(); dataBeanList.add(produce("Manisha", "India")); dataBeanList.add(produce("Dennis Ritchie", "USA")); dataBeanList.add(produce("V.Anand", "India")); dataBeanList.add(produce("Shrinath", "California")); dataBeanList.add(produce("Tanmay", "")); return dataBeanList; } /**
* This method returns a DataBean object,
* with name and country set in it.
*/ private DataBean produce(String name, String country) { DataBean dataBean = new DataBean(); dataBean.setName(name); dataBean.setCountry(country); return dataBean; } }

報表生成

我們將編譯和執行使用我們常規Ant構建過程上面的文件。build.xml文件中的內容(根據目錄保存:C: oolsjasperreports-5.0.1 est)情況如下。導入文件 - baseBuild.xml,並應放置在同一目錄build.xml。

<project name="JasperReportTest" default="viewFillReport" basedir="."> <import file="baseBuild.xml" /> <target name="viewFillReport" depends="compile,compilereportdesing,run" description="Launches the report viewer to preview
the report stored in the .JRprint file."> <java classname="net.sf.jasperreports.view.JasperViewer" fork="true"> <arg value="-F${file.name}.JRprint" /> <classpath refid="classpath" /> <target name="compilereportdesing" description="Compiles the JXML file and
produces the .jasper file."> <taskdef name="jrc" classname="net.sf.jasperreports.ant.JRAntCompileTask"> <classpath refid="classpath" /> <jrc destdir="."> <fileset dir="."> <include name="*.jrxml" /> <classpath refid="classpath" />

接下來,讓我們打開命令行窗口並轉到build.xml文件放置的目錄。最後執行的命令 ant -Dmain-class=com.yiibai.JasperReportFill (viewFullReport是默認的目標),如下所示:

C: oolsjasperreports-5.0.1 est>ant -Dmain-class=com.yiibai.JasperReportFill
Buildfile: C: oolsjasperreports-5.0.1 estuild.xml

clean-sample:
[delete] Deleting directory C: oolsjasperreports-5.0.1 estclasses
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper_report_template.jasper
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper_report_template.jrprint

compile:
[mkdir] Created dir: C: oolsjasperreports-5.0.1 estclasses
[javac] C: oolsjasperreports-5.0.1 estaseBuild.xml:28:
warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last;
set to false for repeatable builds
[javac] Compiling 3 source files to C: oolsjasperreports-5.0.1 estclasses

compilereportdesing:
[jrc] Compiling 1 report design files.
[jrc] log4j:WARN No appenders could be found for logger
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory).
[jrc] log4j:WARN Please initialize the log4j system properly.
[jrc] log4j:WARN See
http://logging.apache.org/log4j/1.2/faq.htmll#noconfig for more info.
[jrc] File : C: oolsjasperreports-5.0.1 estjasper_report_template.jrxml ... OK.

run:
[echo] Runnin class : com.yiibai.JasperReportFill
[java] log4j:WARN No appenders could be found for logger
(net.sf.jasperreports.extensions.ExtensionsEnvironment).
[java] log4j:WARN Please initialize the log4j system properly.

viewFillReport:
[java] log4j:WARN No appenders could be found for logger
(net.sf.jasperreports.extensions.ExtensionsEnvironment).
[java] log4j:WARN Please initialize the log4j system properly.

BUILD SUCCESSFUL
Total time: 5 minutes 5 seconds

C: oolsjasperreports-5.0.1 est>

正如上文編譯的結果,JasperViewer窗口打開如下面的屏幕:

Jasper

在這裏,可以看到,因爲沒有通過該字段country任何數據的最後一條記錄,「NO COUNTRY」正在打印。