报表变量是建立在报表表达式之上的特殊对象。报表变量简化以下任务:
-
报表,其中大量使用在整个报告模板表达式。这些表达式可以通过使用报表变量只能声明一次。
-
计数,求和,平均,最低,最高,方差等:报表变量可以基于像对应的表达式的值执行各种计算
如果变量是在报表设计定义,那么这些可以通过在表达式中的新变量引用。因此,在该变量是在报表设计中声明的顺序是非常重要的。
变量声明
变量声明如下:
<variable name="CityNumber" class="java.lang.Integer" incrementType="Group" incrementGroup="CityGroup" calculation="Count"> <variableExpression> <![CDATA[Boolean.TRUE]]> </variableExpression> </variable>
如上面所看到的,<variable>元素包含属性的数量。这些属性总结如下:
name属性
类似的参数和字段,</variable>元素的name属性是强制性的。它允许引用由它的声明的名称在报表表达式中的变量。
class属性
class属性也是强制性的,它指定了变量值的类名。它的默认值是java.lang.String。这是可以改变的,在classpath可用的任何类无论是在报表编译时间和报告充填时间。无论报告值的类型,引擎采用该$V {}标记是用来报告表达,从而不必要手动投射。
计算方法
这个属性决定的变量填充报表时要执行什么计算。下面的小节描述所有的<variable>元素的计算属性的可能值。
-
Average: 变量的值是变量表达式的每一个非空值的平均值。有效期仅为数值变量。
-
Count: 该变量的值是变量表达式非空实例的数量。
-
First: 变量的值是变量表达式的第一个实例的值。随后的值将被忽略。
-
Highest: 变量的值是变量表达式的最高值。
-
Lowest: 该变量的值是变量表达式在报表中的最低值。
-
Nothing: 不进行计算的变量。
-
StandardDeviation: 该变量的值是所有非空值匹配报表表达式的标准偏差。有效期仅为数值变量。
-
Sum: 该变量的值是由报表表达式返回所有非空值的总和。
-
System: 该变量的值是一个自定义计算(计算该变量自己的值,使用JasperReports小脚本功能)
-
Variance: 该变量的值是一个报表变量的表达式求值返回的所有非空值的方差。
增量FACTORYCLASS
此属性确定填充报表上的当前记录时,用于计算变量的值的类。默认值是任何类实现net.sf.jasperreports.engine.fill.JRIncrementerFactory。工厂类将被用于由发动机来实例化对象的增量在运行时根据该变量中设置的计算属性。
INCREMENTTYPE
这个决定何时重新计算变量的值。此属性使用的值,如下:
-
Column: 该变量的值重新计算各列的结尾
-
Group: 当指定incrementGroup改变该组的变量值重新计算。
-
None: 该变量的值重新计算每个记录。
-
Page: 该变量的值被重新计算在每一页的末尾。
-
Report: 该变量的值被重新计算一次,在报表的末尾。
INCREMENTGROUP
这决定了该变量的值被重新计算,当incrementType是组的名称。这需要在JRXML报表模板中声明的任何组的名称。
RESETTYPE
这决定了当一个变量的值被复位。此属性使用的值,如下:
-
Column: 该变量的值复位在每一列的开头。
-
Group: 该变量的值是当指定incrementGroup修改组复位。
-
None: 该变量的值不会被重置。
-
Page: 该变量的值复位在每一页的开头。
-
Report: 该变量的值复位只有一次,在报表的开头。
RESETGROUP
这决定了该变量的值复位,当resetType是组的名称。该属性的值是在JRXML报表模板中声明的任何组的名称。
内置报表变量
有一些内置的系统变量,准备在表达式中使用,如下所示:
Variable Name | 描述 |
---|---|
PAGE_NUMBER | 这个变量的值是它的当前页码。它可以被用来同时显示当前页面的数量和使用JasperReports文本字段的元素,evaluationTime属性的一种特殊的功能的总页数。 |
COLUMN_NUMBER | 这个变量包含了当前的列号 |
REPORT_COUNT | 此报表变量包含的处理记录的总数。 |
PAGE_COUNT | 这个变量包含了生成当前页面时所处理的记录数。 |
COLUMN_COUNT | 这个变量包含了生成当前列时所处理的记录数。 |
GroupName_COUNT | 这个变量的名称是从它所对应的组,后缀为_COUNT序列的名称派生的。这个变量包含的记录在当前组的数量。 |
例子
让一个变量(countNumber)加入到现有的报表模板(第报表设计)。我们将前缀数到每个记录。修订后的报告模板(jasper_report_template.jrxml)如下。将其保存到C:\tools\jasperreports-5.0.1\test 目录:
<?xml version="1.0"?> <!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"> <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"/> <queryString> <![CDATA[]]> </queryString> <field name="country" class="java.lang.String"> <fieldDescription> <![CDATA[country]]> </fieldDescription> </field> <field name="name" class="java.lang.String"> <fieldDescription> <![CDATA[name]]> </fieldDescription> </field> <variable name="countNumber" class="java.lang.Integer" calculation="Count"> <variableExpression> <![CDATA[Boolean.TRUE]]> </variableExpression> </variable> <title> <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=