JasperReport和IReport报表开发的功能介绍
目录

1 简介 4

2 JasperReport和IReport的安装与配置 4

2.1 JDK的下载、安装和配置 4

2.2 ANT的下载、安装和配置 5

2.3 Jasperreport的下载、安装和配置 6

2.4 iReport的安装和配置 7

3 主要功能和实现过程 7

3.1 XML解析 8

3.2编译报表设计 8

3.3 Report Design 预览 9

3.4报表填充 10

3.5查看报表 11

3.6打印报表 11

3.7导出报表 11

3.8对象的载入和保存 11

4 iReport的使用指南 12

4.1一个简单的报表 12

4.2报表预览 13

4.3使用数据库的数据生成报表 15

5 报表设计 18

5.1DTD Reference 18

5.2XML编码 19

5.3报表属性 19

6 报表数据 21

6.1表达式 21

6.2参数 22

6.3数据源 24

6.4查询报表 25

6.5字段 26

6.6变量 28

7 Report Sections 31

7.1 Main Report Sections 31

7.2 数据分组 36

8 脚本程序 38

9 报表元素 38

9.1文本元素 40

9.2图像元素 45

9.3超链接 48

9.4元素组 48

10 子报表 49

10.1子报表参数 50

10.2子报表数据源 50

11高级JasperReports应用 50

11.1 XML报表的导入和设计 50

11.2实例化数据源接口 50

11.3自定义查看器 50

11.4导出新的格式 51

1 简介

Jasperreport是一款报表打印组件，是开放源代码组织sf.net中的一个java报表打印工程，是一款功能强大的报表生成工具。它既可以将报表内容在显示器上输出，也可以通过打印机打印出来，同时它还支持使用PDF、HTML和XML等多种文件格式进行存储。在不久的将来，诸如CSV、XLS、RTF等格式也将会被兼容。

iReport也是开源组织sf.net中的一款免费软件，其主要作用是用来以可视化的方式设计生成JasperReport所使用的报表格式文件，因为JasperReport本身并未提供很好的可视化报表设计工具，iReport的出现正好弥补了这个缺陷。

2 JasperReport和IReport的安装与配置

2.1 JDK的下载、安装和配置

下载

JDK的最新版本可以从SUN 公的官方网站上下载得到，网址为http://java.sun.com ，JDK共分为3 个版本，J2ME,J2SE,J2EE，因为是在计算机上使用，我们需要下载使用 J2SE SDK，如果您的计算机是用来做软件开发，需要下载J2SE SDK，如果是用来运行已经编译好的JAVA 程序的，可以只下载J2SE JRE 即可。

下载JDK 时SUN 公司会要求你同意一个JDK 的使用许可协议，选接受协议后，会出

现选择适合不同的操作系统平台使用的JDK 版本选择的界面，您可以根据自己使用的操作

系统平台选择适合的JDK 版本。

安装

以Windows 平台的安装为例，在安装的过程中一路Next 即可，同时请注意记录下JDK

安装后的目录，稍后进行配置时要用到。

配置

以在Windows xp平台配置J2SE SDK 为例，鼠标右键点击桌面上的“我的电脑”图标，在弹出的菜单中选择属性，选择“高级”选项，选择“环境变量”。

点击“系统变量”下的新增按钮，在对话框中的变量名处输入大写的JAVA_HOME，在变量值处输入的JDK 安装目录。

点击“确定”完成第一步的配置，接下来以同样的方法配置系统环境变量CLASSPATH，在CLASSPATH的变量值处输入%JAVA_HOME%\lib\tools.jar; %JAVA_HOME%\lib\dt.jar，当然，也可以直接输入绝对路径，但建议使用%JAVA_HOME%的方式。

再接下来还要修改系统环境变量PATH,增加%JAVA_HOME%\bin 目录。

至此JDK 的配置也完成.

打开一个命令行窗口，键入set classpath 与set java_home 应该可 以看到正确的配置信息，同时，输入javac -version 看系统能否找到JAVA 的编译器。

2.2 ANT的下载、安装和配置

ant 是个很好用的工具，虽然对于JasperReport 和iReport 来说ant 并不是必须的，但还是建议以使用ant 的方式来应用。

ANT的下载和安装

ant 是apache 组织的一个子项目，可以从http://ant.apache.org 下载得到，Windows 平台

的可以下载ZIP 格式的安装文件，下载完成以后解压缩到某个目录，建议使用根目录下的直

接子目录作为ant 解压缩以后目录，ant 无需安装，解压缩文件以后就算安装完成。

Ant的配置

与设置JDK相同的操作过程打开系统环境变量设置窗口，增加ANT_HOME环境变量，变量值为解压缩以后的ant 所在目录

在系统的环境变量Path 中增加%ANT_HOME%\bin 目录

新开一个命令行窗口，输入ant 后如果出现如下图所示内容即算正确完成ant 的配置。

2.3 Jasperreport的下载、安装和配置

Jasperreport的下载和安装

因为JasperReport 是sf.net 的开源项目，最新的JasperReport 版本可以在sf.net 中找到，同时，为了方便世界各国程序员下载，sf.net 还设有许多的镜像站点供你选择。

强烈建议下载jasperreport 的source.zip，因为这里面包含了很多的示例程序，对于想深入研究jasperreport 的人来说会有很大的帮助。如果不想对JasperReport 有太多的深入了解，只需要下载.jar 文件就能正常开发应用了。

没有必要单独为JasperReport.jar 文件设置目录，建议放在系统中%JAVA_HOME%\lib\目录中。

Jasperreport的配置

将JasperReport-x.x.x.jar 文件添加到操作系统的环境变量ClASSPATH 中即可完成JasperReport 的配置。

2.4 iReport的安装和配置

iReport的安装

iReport 在Windows 平台也是以.zip 形式的文件提供的，直接解压缩后就算完成了安装

如果是2.x版的，且您决定以ant 的方式运行iReport 程序，需要修改一下iReport 目录中的ireport.bat 文件中的内容，第一次运行ireport.bat 会生成javadoc，在确定已正确生成javadoc 文件后可以将生成doc 的那一段注释掉以便以后可以快速的启动iReport 程序。3.0 版无需修改ireport.bat 文件。

iReport 的使用

在有ant 环境的下运行iReport，直接运行iReport 目录中的ireport.exe 即可。

在没有ant 的环境下运行iReport，2.X 版本使用iReport 目录中的noant 目录中的startup.bat 运行，3.0 版本使用bin 目录中的startup.bat 运行。

3 主要功能和实现过程

    现在我们将对XML报表设计进行分析，编译，装填数据，预览结果和导出到其他格式的过程。

Jasperreport的实例

下面是Jasperreport工具，将XML报表转变成的各种类型报表的流程图：

3.1 XML解析

    JasperReport使用SAX2.0 API对XML文件进行解析。然而，这并不是必须的，用于可以在执行其自行决定使用哪一种XML解析器。

JasperReport使用org.xml.sax.helpers.XMLReaderFactory类的createXMLReader()来获得解析器实例。在这种情况下，就像在SAX2.0文档中说的那样，在运行期，把Java系统属性org.xml.sax.driver的值设定为SAX driver类的全限定名是必要的。

设置系统属性有两种方法：

第一种方法是在你启动Java虚拟机的时候，在命令行窗口使用-D开关：

java -Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser MySAXApp sample.xml

在JasperReport提供的所有例子中，都采用ANT构建工具来执行不同的任务。我们通过使用内置的 task中的元素来提供这一系统属性；

第二种设置系统属性的方法是使用

java.lang.System.setProperty(String key, String value)

System.setProperty(“org.xml.sax.driver”,“ org.apache.xerces.parsers.SAXParser”);

Jsp/compile.jsp和web-inf/class/servlets/CompileServlet.java文件提供了这方面的例子。

3.2 编译报表设计

    为了生成一个报表，用户首先需要完成报表的设计，生成方法或采用直接编辑XML文件，或通过程序生成一个net.sf.jasper.engine.design.JasperDesign对象。在此，主要采用编辑XML文件的方法，因为这种方法在目前是使用JasperReport类库的最好的方法。

    XML报表设计是JasperReport用来生成报表的初级材料。这是因为XML中的内容需要被编译并载入到JasperDesign对象中，这些对象将在报表引擎向其中填入数据之前，必须经过编译过程。

    报表编译过程的主要目的是生成并装载含有所有报表表达式的类的字节码。这个动态生成的类将会被用来在装填数据，并在给所有报表表达式求值的时候使用。具体例子是，如果你用iReport生成一个报表名字叫SimpleSheetTest，它的XML设计文件名叫SimpleSheetTest.jrxml，同时和它在同一目录下iReport会自动生成一个文件名为SimpleSheetTest.java，里面主要是一些报表元素，如Field，Parameters，Variables的定义，以及一些求值表达式。当然，像上面提到的，这个文件在你直接使用JasperReport API的时候是看不到的，因为它是在执行期生成的一个Class。要想看到它的办法是：在IDE（JBuilder，Eclipse）中单步执行程序，在报表打印的阶段，你将能跟踪到这个类，它的名字就是“你的报表名.java”，按上面的例子就是SimpleSheetTest.java，这和iReport是一致的。当然也可以像下面说的那样，到生成这个类的临时目录里找到它。

在这个类生成过程之前，JasperReport引擎需要验证报表设计的一致性，哪怕存在一处验证检查失败都不会继续运行下面的工作。

对于这个包含了所有报表表达式的类的字节码，我们至少需要关心三个方面的内容：临时工作目录、Java 编译器的使用、Classpath

   为了能够编译Java源文件，这个文件必须被创建并且被保存到磁盘上。Java编译过程的输出是一个.class文件，这个包含所有报表表达式的类在这个工作目录里被创建并编译，这也是为什么JasperReport需要访问这个临时目录的原因。当报表的编译过程结束之后，这些临时的类文件将被自动删除，而生成的字节码将保存在net.sf.jasper.engine.JasperReport对象中。如果需要的话，这个类可以将自己序列化并保存到磁盘上。这就是iReport的做法。

    缺省情况下，这个临时工作目录就是启动JVM时的当前目录，这却取决于JVM的系统属性user.dir。通过更改系统属性jasper.report.compile.temp，用户可以很容易更改这个工作目录。在Web环境下，特别是当你不想让含有启动Web Server的批处理文件的目录和报表编译过程的临时工作目录混在一起的时候，修改这个属性就可以了。

上面提到的第二个方面涉及用来编译报表表达式类的Java编译器。首先，报表引擎将试图使用sun.tools.javac.Main类来编译Java源文件。这个类包含在tools.jar中，当且仅当这个jar文件在JDK安装目录下的bin/目录中，或在classpath中时，sun.tools.javac.Main才能正常使用。

如果JasperReport不能成功装载sun.tools.javac.Main文件，程序将动态执行java编译过程，就像我们通常用命令行那样，使用JDK安装目录下的bin/目录下的javac.exe。这就是为什么将JDK安装目录/lib/下的tools.jar文件copy到JasperReport工程的lib/目录下是一个可选的操作（optional operation）。如果tools.jar不在classpath中，JasperReport将显示错误信息并继续上面提到的操作。

  当编译Java源文件的时候，最重要的事情莫过于classpath。如果Java编译器不能在指定的classpath中找到它试图编译的所有相关类的源文件，则整个过程将失败并停止，错误信息将在控制台显示出来。同样的事情也将发生在JasperReport试图编译报表表达式类的时候。所以，在runtime为编译过程提供正确的classpath是非常重要的。例如，我们我们需要确认在classpath中，我们提供了在报表表达式中可能用到的类（custom class）。

    在这个方面也有一个缺省的行为。如果没有为编译report class特殊指定classpath，引擎将会使用系统属性java.class.path的值来确定当前的JVM classpath。如果你指定了系统属性jasper.reports.compile.class.path的值，你可以用你定义的classpath来覆盖缺省行为。

   大多数情况下，编译一个report只需要简单的调用JasperReport类库中的JasperCompileManager.compileReport(myXmlFileName);即可。调用之后将生成编译好的report design并存储在.jasper文件中，这个文件将会保存在和提供XML report design文件相同的目录中。

3.3 Report Design 预览

       JasperReport类库并没有提供高级的GUI工具来辅助进行设计工作。但是目前已经有至少4个project试图提供这样的工具。然而，JasperReport本身提供了一个很有用的可视化组件来帮助报表设计者在编译的时候预览报表设计（其实不如直接用IReport方便）。

net.sf.jasper.view.JasperDesigner是一个基于Swing的Java应用程序，它可以载入并显示XML形式或编译后的报表设计。尽管它不是一个复杂的GUI应用程序，缺乏像拖拽可视化报表元素这样的高级功能，但是它仍然是一个有用的工具。所有JasperReport工程提供的例子都利用了这个报表查看器。

       如果你已经安装了ANT，想要查看一个简单的报表设计，你只需要到相应的文件夹下输入如下命令：

ant viewDesignXML 或者 ant viewDesign
       如果你没安装ANT，要达到上面的效果就不是很容易，因为JasperReport本身需要一些其他辅助的jar包（在JasperReport安装目录/lib下），在运行的时候，你需要把这些jar包都包含到你的classpath里面，并且正确设计系统属性，如上面提到的org.xml.sax.driver。我可以展示一下在windows下的例子：

>java -classpath ./;../../../lib/commons-digester.jar;

../../../lib/commons-beanutils.jar;../../../lib/commons-collections.jar;

../../../lib/xerces.jar;../../../lib/jasperreports.jar

-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser

dori.jasper.view.JasperDesignViewer -XML -FFirstJasper.xml

3.4报表填充

      报表填充过程是JasperReport library最重要的功能。它体现了这个软件最主要的目的，因为这一过程可以自由的操作数据集，以便可以产生高质量的文档。有3种材料需要装填过程中作为输入提供给JasperReport：report design、参数、数据源

      这一过程的输出通常是一个单一的最终要被查看，打印或导出到其他格式的文档。

要进行这一过程，我们需要采用net.sf.jasper.engine.JasperFillManager类。这个类提供了一些方法来让我们填充报表设计，report design的来源可以是本地磁盘，输入流，或者直接就是一个已存在于内存中的net.sf.jasper.engine.JasperReport类。输出的产生是于输入类型相对应的，也就是说，如果JasperFillManager接到一个report design的文件名，填充结束后生成的report将会是一个放在磁盘上的文件；如果JasperFillManager收到的是一个输入流，则生成的report将会被写到一个输出流中。

有些时候，这些JasperFillManager提供的方法不能满足某些特定的应用的要求，例如可能有人希望他的report design被作为从classpath中得到的资源，并且输出的报表作为一个文件存放在一个指定的磁盘目录下。遇到这种情况时，开发人员需要考虑在将报表设计传递给报表装填过程之前，用net.sf.jasper.engine.util.JRLoader类来装载report design对象。这样，他们就能获得像报表名这样的report design属性，于是开发者就能生成最终文档的名字，并将它存放到所需的位置上。

      在现实中，有许多报表装填的情境，而装填管理器仅试图覆盖其中最常被使用到的部分。然而对于想要自己定制装填过程的人来说，只要采用上面所说的方法，任何开发者都可以达到满意的结果。

报表参数通常作为java.util.Map的value提供给装填管理器，参数名为其键值。

作为装填过程所需的第三种数据源，有如下两种情况：

通常，引擎需要处理net.sf.jasper.engine.JRDataSource接口的一个实例，通过这个实例，引擎可以在装填过程中获取所需数据。JasperFillManager提供的方法支持所有的JRDataSource对象。

      然而，这个管理器还提供一些接受java.sql.Connection对象作为参数的方法集，来取代所需的数据源对象。这是因为在很多情况下，报表生成所需的数据都来源于某个关系型数据库中的表。

在报表中，用户可以提供SQL查询语句来从数据库中取回报表数据。在执行期，engine唯一需要做的是获得JDBC connection对象，并使用它来连接想要连接的数据库，执行SQL查询并取回报表数据。在后台，引擎将使用一个特殊的JRDataSource对象，但是它对于调用它的程序来说是透明的。

JasperReport工程提供了相关的例子，它们采用HSQL数据库服务器（在工程文件中，有一个相应的文件夹），要运行这些例子你需要首先启动该服务器，方法是：在/demo/hsqldb目录下输入如下命令：>ant 或者 >ant runServer

       没装ANT就麻烦点：>java -classpath ./;../../lib/hsqldb.jar org.hsqldb.Server

一下代码片断显示了query例子是如何装填数据的：

//Preparing parameters

Map parameters = new HashMap();

parameters.put("ReportTitle", "Address Report");

parameters.put("FilterClause", "'Boston', 'Chicago', 'Oslo'");

parameters.put("OrderClause", "City");

//Invoking the filling process

JasperFillManager.fillReportToFile(fileName, parameters, getConnection());

3.5 查看报表

      报表填充阶段的输出通常是一个JasperPrint对象，如果把它保存在磁盘上，通常以一个.jrprint文件的形式存在。JasperReport拥有一个内置的查看器，用来查看用内置的XML导出器获得的XML格式的报表文件。这个查看器就是以前提到过的net.sf.jasper.niew.JRViewer，用户可以通过继承这个类来定制自己所需的查看器。JasperReport工程中自带的例子webapp中，你可以阅读JRViewerPlus类的代码来获取进一步内容。

3.6 打印报表

      JasperReport类库的主要目标，就是生成可打印的文档。而且多数应用程序生成的报表都是需要打印到纸张上。我们可以用net.sf.jasper.engine.JasperPrintManager来打印JasperReport生成的文档。当然，报表也同样可以在被导出到其他格式如PDF，HTML之后再被打印。通过JasperPrintManager提供的方法，我们可以打印整个文档，打印单个文档或打印某一范围内的文档，可以显示打印对话框也可以不显示。下面的例子演示了不显示对话框，打印整个文档的方法：JasperPrintManager.printReport(myReport,false);

3.7 导出报表

      在一些应用程序环境下，将JasperReport生成的文档从其特有的格式导出到其他更为流行的格式如PDF，HTML是非常有用的。这样一来，其他人就可以在没有安装JasperReport的情况下查看这些报表，特别是当这些文档要通过网络发送出去的时候。

JasperReport提供了JasperExportManager类来支持此项功能。这项功能将会在以后不断加入对新的格式的支持。目前，JasperReport主要支持导出PDF，HTML和XML类型的文档，下面是导出的代码片断：JasperExportManager.exortReportToHtmlFile(myReport);

       注意：想要将自己的报表导出到其他格式的用户，需要实现JRExporter的接口，或继承相应的JRAbstractExporter类。

3.8 对象的载入和保存

      当使用JasperReport的时候，你经常会与序列化的对象，如以编译的报表设计，或已生成的报表打交道。有时，你需要手动载入从不同的source如input stream或你用类库核心功能产生的序列化类。JasperReport提供了两个特殊的工具类来提供上述操作的能力，这些类通常供报表引擎自己使用：

net.sf.jasper.engine.util.JRLoader

net.sf.jasper.engine.util.JRSaver

      第一个类提供了一些方法让我们能够从不同类型的数据源如文件，URL，input stream和classpath里面获取序列化对象。最令人感兴趣的方法是loadObjectFormLocation(String)。它已经在上一章中介绍过了，这里不再赘述。

      与上面的对象载入工具相反的部分是JRSaver类，它可以帮助程序员将自己的类序列化之后存放到本地磁盘或通过Output Stream发送到网络上去。

       有时，开发人员可能想要载入已经生成好的report，或最终的已经被导出到XML格式的JasperReport文档，这与上面所说的直接load序列化对象有所不同。这时，我们需要载入的是将载入的XML内容进行编译，并生成JasperPrint对象，而并非仅仅是载入序列化对象。这时，我们可以通过net.sf.jasper.engine.xml.JRPrintXmlLoader类的一些静态方法，通过编译从XML文件中读取的内容构建出一个位于内存中的文档对象。

4 iReport的使用指南

4.1一个简单的报表

如上面左图所示新建一个文档，如右图设置报表的名称、大小等属性。

依照上图的标识，分别设计报表的各部分，可以通过以下快捷方式来插入图形、静态文字、动态文字图片等元素，设计如下图

报表设计完毕，选择菜单栏中的“建立”下拉菜单，选择其中“编译”，对报表尽进行编译，如有错误，会在底端提示，若无错误，则生成.Jrxml文件。编译成功之后，选择“执行报表”，进行预览。

4.2 报表预览

Ireport默认是用其自带的iReport JasperViewer进行预览。我们可以选择其他的预览方式，通过选择菜单栏中的“Option”下拉菜单，选择其中的“选项”，选择External Programs选项卡，如下图所示，对各个预览工具进行配置

配置之后，可以通过选择菜单栏中的“建立”下拉菜单，选择以配置好的预览方式，之后选择“执行报表”，就可以用相应的应用程序对其进行预览。

4.3 使用数据库的数据生成报表

4.3.1连接数据库

选择菜单栏中的“data”下拉菜单，选择“连结/资料来源”，

选择“New”新建一个连接，配置如下图，其中experiment是已建立的数据库名称

单击“Test”，测试数据库连接是否成功，若成功，有以下对话框

若不成功，有类似于下图的相应的对话框

测试成功，单击“save”保存新建连接。

4.3.2设置SQL查询语句

选择菜单栏中的“data”下拉菜单，选择“报表查询”，

之后在相应地方编写SQL语句。编写完毕，单击“OK”保存并退出编写。

4.3.3字段在报表设计器中的使用

点击工具栏中的在报表中的“Details”段中用鼠标拖拽到适合的大小，右击该

字段框，选择属性，在选择Text Fiel选项卡，如下图：

选中Text Field 项，如果没有设置正确的字段名称，则Textfield expression 中的内容将显示

蓝色，手工修改Textfield expression 中的内容为正确的字段名称，格式为$F{字段名称}，正

确修改后将变为绿色显示。

4.3.4编译与预览带有字段的报表

对下面报表进行编译，其中数据已经在数据库中预先设好

编译报表可以选择菜单栏中“建立”下拉菜单中的“编译”，也可以直接点击工具栏中的图标，如果编译过程正确完成，iReport 设计器的下面会显示如下内容：

带有字段的报表进行预览有两种方式，一种是不使用数据库中的数据，默认所有字

段值为null 的方式，预览方法为选择“建立”菜单中的“执行报表”，也可以直接点击工具栏中的图标；第二种方式为使用数据库中的数据的方式，预览方法为选择“建立”菜单中的“执行报表（使用动态连接）”，也可以直接点击工具栏中的图标。下图进行预览：

5 报表设计

报表设计体现了一个模板，JasperReport引擎利用这个模板将同台生成的内容传递给打印机，屏幕或Web。存储在数据库中的数据在报表装填的过程中被组织起来，根据已有的报表设计来获得可以进行打印的，面向页面的（page oriented）文档。

总而言之，一个报表设计包含了所有的结构相关信息和将数据提供给报表所涉及的各个方面。这些信息涉及将在文档中显示出来的各种text或图像元素的位置和内容，自定义计算（custom calculation），数据组织，报表生成时的数据操作，等等。

报表设计通常都定义在一个拥有特殊格式的XML文档中，并且在被填充数据之前要经历JasperReport的编译过程。然而JasperReport也允许用户通过JasperReport提供的API构造in-memory报表对象，例如noxmldesign就是很好的例子。

5.1 DTD Reference

    当使用XML文件进行报表设计的时候，JasperReport将使用内置的DTD文件来验证其受到的XML内容的有效性。如果XML验证通过，则说明所提供的报表设计符合JasperReport所需要的XML结构和语法规则，其引擎能够生成经过编译的report design。

    有效的XML文档总是在验证时指向JasperReport的内部DTD文件。如果没有提供DTD文档的引用，报表的编译过程将会突然结束。这对所有人来说都是一个负担，因为DTD引用通常是相同的，并且这些引用可能会简单的被从以前的报表设计中copy过来。在一开始，你需要将这个引用从给定的例子中copy过来。

    正如以前说的一样，报表引擎仅能识别指向其内部DTD文件的的引用。你不能随便从类库的源文件中将那些DTD文件copy到别的地方，再在你的报表设计文件中指向你copy的那些DTD文件。如果你想那样做的话，你将需要调整类库中某些类，包括dori.jasper.engine.xml.JRXmlDigester类的某些代码。如果你遇到像引擎无法找到其内部的DTD文件而导致的无法载入资源的问题，请确定你已经在使用外部DTD文件之前排除了所有可能发生的情况。遇到这样的问题是不太可能的，因为资源载入机制会随着时间不断改进。

JasperReport只有两种合法的XML报表设计的DTD引用，他们是：

"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

或者：

"http://www.jasperreports.com/dtds/jasperreport.dtd">

     XML报表设计的根元素是，下面是一个普通的JasperReports XML报表设计文件的样子：

"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

...

前三点描述了该报表设计的属性和设置，下面省略的部分则描述了各种报表设计要素如报表参数、字段、变量、组和报表栏等。

5.2 XML 编码

    当要生成不同语言的XML报表设计的时候，在XMl文件的首部的编码属性需要特别关注一下。缺省情况下，如果这个属性的值没被订制，则XML解析器将会使用“UTF-8”作为XML文件的编码格式。这一点是非常重要的，因为报表设计通常包含了静态的本地化文本。

对于大多数西欧语言来说，ISO-8859-1编码，也就是我们常说的LATIN1将会很好的处理如法语中重音符号的显示问题。

在编辑XML文件的时候，要找到某种特殊语言的编码类型，你可以查看XML document.FIXME。

5.3 报表属性

    我们上面已经看到，XML报表设计的根元素。这一节我们将介绍报表设计对象的Property的细节以及这些属性所对应的XML attributes

报表名称

    每一个报表都必须有一个名称。这个名称是相当重要的，因为类库需要它来生成文件，尤其是当编译，装填，导出报表的默认行为被使用的时候，这个名的作用更为重要。这个名称是以元素的name attribute的形式提供的，并且是强制必须填写。

列数

       JasperReport允许生成每页的列数超过一列的报表，正如下面的图片，展示了拥有两列的报表：

默认情况下，报表引擎生成每页一列的报表。

打印顺序

    对于拥有超过一列的报表，为其提供列将被以什么顺序填充是很重要的。你可以使用元素的printOrder attribute来进行设置。有如下两种情况：

● Verticaln Filling：这个选项将导致列是自顶向下被填充（printOrder=”Vertical”）

● Horizontal filling：列将自左向右被填充（printOrder=”Horizontal”）

缺省设置将是printOrder=Vertical
页面大小

    有两个attribute是用来提供要生成的文档大小的：pageWith，pageHeight。像所有其他显示元素位置和尺寸的attribute一样，这两个attribute是以像素为单位的。JasperReport采用Java默认的每英寸72点的设置。这意味着pageWith=”595”将大约是8.26英寸，这大概是A4纸的尺寸。

默认的纸张大小是A4纸：pageWith=”595” pageHeight=”842”

Page Orientation（默认设置为Portrait）

    orientation属性用来设置文档打印格式是“Portrait”还是“Landscape”。JasperReport允许用户在从“Portrait”切换到“Landscape”的时候调整液面的宽度和高度。我们先看一个例子：我们假定要生成一个A4纸的报表，采用“Protrait”格式：

    pageWidth=”595” pageHeight=”842” orientation=”Portrait”

    如果我们决定用A4纸的“Landscape”布局，首先要调整相应的页面宽度和高度：

    pageWidth=”842” pageHeight=”595” orientation=”Landscape”

    这是因为JasperReport需要确切知道它所要绘制的报表页的宽度和高度，而不只看我们提供的orientation属性，至少在报表装填的时候是这样。orientation属性仅在报表打印时有用，来通知打印机或某些exporters页面的orientation设置。

页边距

    一旦页面大小确定下来，用户就可以在生成报表的时候设定报表的边距。有四个属性来完成这项工作：topMargin，LeftMargin，bottomMargin和rightMargin。缺省的设置是上下边距20像素，左右边距30像素。

列宽和列间距（Column Size and Spacing）

    一个报表可能含有多列，我们可以通过上面提到的columnCount属性得到报表列数。JasperReport需要知道列的宽度和列间距的大小。有两个属性用于这项工作：columnWidth和columnSpacing。当我们对报表设计进行编译的时候，编译器会对这项设置进行有效性检查（validation check）--看列的宽度和列间距是否符合给定的页面宽度和页边距。因为缺省的列数为一，所以缺省的列间距为0像素，并且缺省的列宽等于页面宽度减去左右边距所得的值。在上面A4的例子中，列宽即为555像素。

空数据源时的行为

    有时我们提供给我们的报表的数据源可能会没有任何记录。whenNoDataType属性可以让你选择当所提供的数据源中没有数据的时候入和察看生成的报表。如下有三种不同的可能性，你可以任选其一：

● Empty Document：生成的报表不含有页面（no page in it）。当你试图装载这样的文档（whenNoDataType=”NoPages”）的时候，Viewer 可能会抛出一个错误。

● Blank page：表示生成的报表将仅含有一个空白页（whenNoDataType=”BlankPage”）

● All sections displayed：除了detail部分的其他部分将在生成的文档中显示出来（whenNoDataType=”AllSectionNoDetail”）。

缺省的设置是whenNoDataType=”NoPages”。

标题和摘要的放置（Title and Summary Sections Placement）

       如果你想让title部分和summary部分在单独的一页里显示，你所需要做的事情就是让下面的一个或两个属性的值为“true”：isTitleNewPage，isSummaryNewPage。这两个属性缺省情况下为false。

注意:即使你选择了在最后一页的剩余部分显示summary，如果列数超过一列，并且第二列已经在最后一页出现的时候（没试过，等有机会试验一下），新的一页将会被自动生成。

脚本类（Scriptlet Class）

       scirptletClass属性用于设置用于当前报表的scriptlet类的名字。在后面会对Scriptlet进行详细讨论。如果你没为这个属性提供任何值，报表引擎将会使用dori.jasper.engine.JRDefaultScriptlet的实例。

6 报表数据

    当谈到报表装填过程的时候，有三样东西需要作为输入提供给报表引擎：报表设计（report design），参数值（parameter values）和报表的数据源（data source）。

在先前的介绍，我们已经看到了有关报表设计的某些方面，现在我们要更加详细的关注其他两方面的内容：参数（parameter）和报表数据源。他们描绘了报表引擎在装填报表过程中所用到的仅有的数据来源。像你用其他报表工具所希望的一样，这些数据将会根据报表设计中的定义的模板（template）被组织起来，并被用来生成准备打印的、面向页面的文档。

6.1 表达式（expressions）

    表达式是JasperReports的一个非常有用的特性。他们可以用来声明执行各种执行各种计算（calculations）的报表变量（report variables），进行报表的数据组织，定制报表文本字段（text field）的内容或者进一步定制报表对象的appearance。

所有报表表达式基本上都是Java表达式，他们可以以特殊的语法引用报表参数（parameter），报表字段（field）和报表变量（variable）。

在XML报表设计中，有一些用于定义表达式的元素：, ,,,, 等。

因为所有的JasperReport表达式都是真正（real）的Java表达式，只要你用完整的类名（包括包名）来引用这些表达式，你就可以在任何class中使用他们。当你编译报表和装填数据的时候，你应该确定你在报表表达式中使用的类已经写入了classpath。

报表参数引用是通过$P{}序列引入的，例如：

$P{ReportTitle}

    这个例子假定我们在报表设计中有一个名为ReportTitle的报表参数，这个参数是一个java.lang.String类。当报表进行装填的时候，文本字段将会显示这个参数的值。

为了在一个表达式中使用报表字段，字段名必须放在$F{}的括号中。例如，如果我们想要在一个文本字段中显示两个数据源字段的连接值（concatenated values）,我们可以定义 如下表达式：

$F{FirstName} + " " + $F{LastName}

表达式可以更加复杂：

$F{FirstName} + " " + $F{LastName} + " was hired on " +

(new SimpleDateFormat("MM/dd/yyyy")).format($F{HireDate}) + "."

    正如你所看到的一样，参数、字段和变量引用都是通过用JasperReport的特殊语法从一个真正地Java对象中引入的。（实际上是一个JREvaluator对象，该对象是在运行其生成的动态对象，并不能在本地磁盘上见到它的身影，不过如果你使用iReport的话，你就可以在生成报表文件的同一目录下看到它的本来面目）

下面这个例子给我们显示了怎样从一个java.lang.String类型的报表字段中选取并显示第一个字符：

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

6.2 参数（Parameters）

     Parameters是传递给报表装填操作的对象引用。这些参数主要作用于把那些不能从报表数据源中获得的数据传给报表引擎。例如，我们可能要把执行报表装填过程的用户名字专递给报表引擎，如果我们想让它显示在报表上或者在我们想在报表的title上动态的改变它，我们就可以以参数的形式传给报表引擎。

在一个报表设计中声明一个参数是很简单的，它只要求指定参数的名称和所属类:

这里所提供的报表参数值可以被用到各种报表表达式中，在报表SQL查询中，甚至可以用到报表的scriptlet类里。

下面是构成参数定义的全部组件（XML元素）：

参数名

     name属性是参数的一个强制属性。JasperReport的命名习惯和Java语言的命名习惯是类似的，这意味着参数名应该是一个单词，其中不含特殊字符（如分号）。

参数类型

    报表参数的第二个强制属性是提供参数值的类型名。这个类型属性可以使任意的值，只要这个类型的名字在报表编译期和装填期能在classpath中找到即可。

提供给参数的值

    在GUI引用程序中，建立一个报表参数集，让用户在执行装填过程之前输入某些应用程序需要用户输入的报表参数是很有用的。可选参数isForPropting参数用来声明是否显示提示信息让用户输入某些参数。下面的例子中，声明了一个文本参数，当需要用户输入参数值的时候，这个文本参数用来在一个已定制的对话框中描述需要用户输入什么样的参数：

Please type here the report comments if any

]]>

注意：相信大家都知道表示“内容”将不被XML解析器解析，也就是说，你可以在“内容”里加入XML的特殊字符，如>，等等。

参数的默认值（parameter default value）

    通常参数值都是使用java.util.Map对象传给装填过程的，其中参数名作为Key。这样，你就不用每次都为每个参数提供一个value了，可以批量放到Map对象里一起传给装填管理器。如果你没有为参数提供一个value，引擎就认为它是null。但是如果你为它提供了一个默认值，则引擎将在你没提供这个参数值的情况下使用这个默认值。如果你在装填时没提供数据，下面的java.util.Date将在装填是被引擎使用来表示当天日期：

new java.util.Date()

在参数的默认表达式中，我们可以使用先前定义的报表参数。

6.2.1 内置的报表参数

    每一个报表设计中都含有一些预先定义的报表参数，这些内置的参数的描述如下：

Parameter REPORT_PARAMETERS_MAP

    这是一个内置的参数，这个参数总是指向一个java.util.Map对象，该对象保存了用户调用报表装填过程时传递给报表引擎的用户定的参数。

Parameter REPORT_CONNECTION

    这个报表参数指向一个java.sql.Connection对象，这个对象被提供给报表引擎用来通过JDBC来执行SQL报表查询。将master报表使用的JDBC Connection对象传递给subreport是非常有用的，有关这方面信息请查看subreport例子.

Parameter REPORT_DATASOURCE

    在报表装填的时候，我们可以或者直接由应用程序中提供，或由报表引擎从所提供的JDBC　Connection在后台create而获得一个数据源。这个内置的参数允许我们在报表表达式中或scriptlet中访问报表数据源，而不论我们为什么要这么做。

Parameter REPORT_SCRIPTLET

即使报表不使用scriptlet，这个内置的参数仍将指向一个net.sf.jasper.engine.JRAbstracStriptlet实例，该实例实际是一个net.sf.jasper.engine.JRDefaultScriptlet对象。

但是当使用scriptlet时，报表装填过程所生成的这个指向scriptlet类实例的引用允许我们调用其中的某些特殊函数，使用或控制scriptlet对象在装填过程中已经准备好的数据。在scriptlet例子中你可以看到更详细的使用过程。

6.3 Data Source（数据源）

在进行报表装填的时候，JasperReport引擎迭代的从用户提供的数据源中提取record，并根据报表设计所提供的模版生成报表的各个部分（section）。通常情况下，引擎需要接收一个dori.jasper.engine.JRDataSource对象作为报表数据源。但是像我们即将看到的那样，当报表数据存储于关系型数据库的时候，JasperReport有了让用户提供一个JDBC链接对象来替代通常的数据源对象的特性。JRDataSource接口非常简单，如果我们想要实现它只需要实现下面两个方法：

public Boolean next() throw JRException;

public Object getFieldValue(JRField jrField) throw JRException

    在报表装填的时候，next()方法将被报表引擎调用，迭代的从数据源中获取数据。第二个方法用来为每个在当前数据源记录（data source record）中的报表字段（report field）提供value。

    应当知道，从数据源取得数据的唯一方法是使用report field。一个数据源对象更像是一个二维表，表中含有数据。这个二维表的行是一条一条的record，而每一列都映射为一个report field。所以我们可以在report表达式中使用数据源。JasperReport提供了一些缺省的JRDataSource实现，我们来具体看一下：

Class dori.jasper.engine.JRResultSetDataSource

    这是一个非常有用的缺省实现，因为他外覆（wrap）了java.sql.ResultSet对象。由于多数报表的生成都采用关系数据库中存储的数据，所以这个类是被使用得最为广泛的数据源对象。然而在以下的两种情况下您可以不必在装填过程中自己生成这个对象：

    如果你选择在你的报表中用SQL查询来获得在关系数据库的某个table中的数据，报表引擎将会通过执行给定的SQL查询并且将返回的java.sql.ResultSet外覆为一个dori.jasper.engine.JRResultSetDataSource实例来执行这项操作。引擎唯一需要的是一个java.sql.Connection对象来执行查询操作。这时你可以提供connection对象来作为通用数据源对象（usual data source object）。例子有：jasper，scriptlet，subreport和query。

当然你可以在应用程序中即JasperReport之外执行SQL查询。这样的话，你可以手动的外覆java.sql.ResultSet，再调用报表装填过程之前实例化这个数据源对象。当使用这种类型的数据源的时候，你需要为在result set中的每一列生命一个report field。report field的名字和类型必须和列的名字和类型匹配。

Class dori.jasper.engine.JREcptyDataSource

    这个类主要用于当生成报表的数据不是来自数据源，而是来自参数或重要的仅是数据源中virtual records的数量的时候。例子fonts，images，shapes和unicode都使用了这个类来装填报表，来模拟数据源中没有一条记录，所有字段都为null的情况。

Class dori.jasper.engine.data.JRTableModelDataSource

    这个JRDataSource接口的缺省实现外覆了javax.swing.table.TableModel对象，它可以用在Java Swing应用程序中从已经显示到屏幕上的table中得数据来生成报表。

通常有两种方法来使用这种数据源：

通常，为了要从中取得数据，你需要为javax.swing.table.TableModel对象的每一列生命一个report field。但是有些情况下会出现问题，比如report field的命名需要遵照Java命名规范来声明变量，而table的列名则不需要。幸运的是，你仍然可以通过列的索引而不是它的名字来将report field与列进行映射。例如，一个列名为“Produce Description”不可能被映射到名为“Produce Description”的report field上，因为report field名中含有空格，这将引起一个编译错误。但是如果你知道这个列示table model对象的第三列（index=2），那么你就可以命名相应的字段“COLUMN_2”并无误地使用这一列的数据。例子有：

Class dori.jasper.engine.data.JRBeanDataSource

    这个类外覆了一个JavaBeans数组，并且通过反射来获取report field的值。在这种数据源中，一个JavaBean对象描述了一条记录。如果我们有一个名为“ProductDescription”的report field，在获取这个字段的值的时候，程序将会试图通过反射机制调用一个当前JavaBeans对象中]名为getProductDescription()的方法。对于boolean字段，当调用get前缀的属性不能返回其属性值的时候，程序将会试图使用is前缀的方法来获得属性值。

Class dori.jasper.engine.data.JRBeanCollectionDataSource

       这个类和上一个类非常类似，它也是使用反射机制和JavaBean命名规范，但是它外覆了一个java.util.Collection对象而不是一个JavaBean对象数组。在datasource例子中你可以看到进一步的用法。

6.4 报表查询（Report Query）

     要为报表装填数据，我们需要为报表引擎提供所需的数据，或者至少告诉它怎样去获取数据。JasperReport通常需要接受一个net.sf.jasper.engine.JRDataSource对象作为报表的数据源，同时作为更为强大的功能，JasperReport能直接用JDBC从关系数据库总获取数据。类库允许用户在他们的报表设计中提供SQL查询以便可以自运行期从数据库中提取数据。要做到这一点，你只需要在装填的时候为装填管理器的fillReport()方法提供一个java.sql.Connection而不是JRDataSource对象即可。

在报表中，可以使用元素来引入查询。如果这个元素存在，则出现在报表参数声明之后，报表field之前。

如下是一个SQL查询的例子：

    为了更好的定制从数据库中取回的数据集（data set），一个重要的方面是在报表查询字符串中报表参数的使用（use of report parameters）。在查询中，这些参数可能会像动态过滤器（dynamic filter）一样工作，它们用特殊的语法被引入进来为报表提供数据，很像report expression。

如下有两种在查询中的使用参数的方法：

1. 像通常的java.sql.PreparedStatement的参数那样使用，用如下语法：

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

]]>

2. 有时，我们需要使用参数来动态更改SQL查询的某些部分，或将整个SQL查询作为参数提供给装填过程。在这种情况下，语法稍微有些不同，向下面的例子，注意“！”

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

]]>

    在这个例子中，这个引入了参数值得特殊的语法确定了我们为这些参数所提供的值将会替代查询中的参数引用（$P!{}的内容）。这些参数将被传给使用java.sql.PrepqredStatement对象的数据库服务器。

事实上，报表引擎首先处理$P!{}参数引用，通过使用他们的值来获取最重的SQL查询，并且仅当这件事完成之后，引擎才会将剩下的普通的$P{}参数引用传递给usual IN parameters。

第二种用于SQL查询的参数引用允许你在运行期传递整个SQL查询语句:

$P!{MySQLQuery}

注意：你不能在参数值中再加入参数引用，也就是说，参数引用不能嵌套使用。

更详细的信息可以参看工程所带的例程：jasper，subreport，scriptlet，webapp以及最有学习价值的query。

6.5 字段

报表字段是数据从数据源传到报表设计和使用报表表达式中的数据的唯一路径，以此来获得所要的输出。

声明报表字段时，你必须确保所选的数据源在报表的装填时间能提供所有这些已声明的字段。例如，万一你用了dori.jasper.engine.JRResultSetDataSource接口，并且使用报表查询时发生这种情况，你必须确保报表查询执行后的结果集中每一种字段都占有一列，并且相应的每一列都必须与传值给它的字段具有相同的名字和相同的数据类型。

这是一个字段声明的语法，字段的声明需要对应与数据库表中的某一字段。我们考虑一个名为Employees的表，其表结构如下：

报表字段需要下面这样定义：

如果我们声明的字段在结果集中没有相应的栏对应，执行时就会抛出异常（如果你用iReport，在编译时也会抛出异常）。然而执行SQL查询之后返回的结果集中包含的列不需要与报表字段一一对应（即列可以多于字段，只是在显示的时候不显示出来罢了）。

下面描述一个报表字段定义的各个组成元素：

Field Name（字段名）

Name attribute是强制属性，你可以在表达式中通过它来引用该字段。声明的字段名，应该是单词，而且不含特殊字符如点和分号。

Field Class（字段类型）

报表字段的第二个属性描述了字段值的类型。其缺省为java.lang.String类型，但你如下类型可选：

java.lang.Object

java.lang.Boolean

java.lang.Byte

java.util.Date

java.sql.Timestamp

java.lang.Double

java.lang.Float

java.lang.Integer

java.io.InputStream

java.lang.Long

java.lang.Short

java.math.BigDecimal

如果某些数据源含有一些自定义的类型，则该类型所对应的字段应该声明为java.lang.Object。但是与参数定义不同的是，你只能选择上述列表中的类型名。

Field Description（字段描述）

这额外的文本块证明是非常有用的，例如实现自定义数据源时。你可以在其中存一个关键词或你可能需要的信息，这是为了确保在运行时能从自定义数据源找回字段值

使用Field Description这个选项，你可以轻松的越过字段名的约束。当要从数据源找回字段值时，可以使用field description 代替字段名来获取相应数据。

PERSON NAME

6.6 变量

报表变量是建立在报表表达式之上的一些特殊对象。它们是用表达式定义的，用来执行某些运算，来简化报表中频繁出现或使用的某些项目（如页号，页码，某些列的累加和等等）。

一个变量可以引用其他变量，当且仅当这些被引用的变量已经在报表中被定义过。因此，在报表设计中，变量的声明次序是很重要的。

Variable Name（变量名）

就像变量和字段，变量的name attribute是强制性的并且允许在报表表达式中允许用这个名字来引用该变量。我们提到的对参数和字段的命名约束同样也适用与变量。

Variable Class

Class attribute 包含了变量值所属类的类名，默认是java.lang.String。无论在报表的编译期还是报表的装填期，只要你所选的类型的类在classpath中可以找到，你就可以声明该类型的报表变量。

Reset Type

变量的值可以在每一次迭代(iteration)被改变, 但也可以在装填过程中的某一特定的时间（specified moments）通过它的初始的value表达式恢复其初始值。这种行为是由ResetType attribute 来控制的。ResetType attribute 指出了在报表装填过程中变量何时需要重新初始化。

下面是变量的5种reset type ：

● No Reset：变量从不用它的初始值表达式来初始化，变量只通过运算变量表达式来获得值（resetType=”None”）。

● Report Level Reset:变量只在报表装填过程的起始使用变量的初始值表达式来进行初始化，并且只有这一次。（resetType=”Report”）。

● Page Level Reset：变量在每一页的起始时被重新初始化。（resetType=”Page”）。

● Column Level Reset：变量在每一新列的开始被初始化。（resetType=”Column”）。

● Group Level Reset：变量将在每次resetGroup attributes 提供的break的地方被重新初始化。（resetType=”Group”）。

默认情况是resetType=”Report”。

Reset Group

resetGroup attribute 包含报表组的名称并且仅与resetType=”Group”的resetType属性相关联。

6.6.1 运算（Calculations）

像以上所提到的，变量能执行内置的计算类型（build-in types of calculation）。下面将列出变量的calculation attribute 的所有可能的值：

Calculation Nothing

这是变量执行的缺省计算。它意味着变量值在数据源的每次迭代（注：文章中提到的数据源的迭代都是指：例如，在报表装填的时候，引擎执行SQL查询返回的ResultSet中含有若干记录，每次迭代都是指从ResultSet中获得一条记录，并将这条记录的值赋给已经声明的字段）时都被重新计算（这里的计算只是简单的通过变量表达式给变量赋值）。

Calculation Count

在每次数据源的迭代的时候，一个计数（count）变量将会把用主表达式（main expression）计算所得的非空（not null）值累加起来。计数变量（Count variables）必须是一个数字类型的变量，但是它的主表达式可以是一个非数字型表达式（non-numeric expression），因为报表引擎不关心表达式类型，而仅仅将这些非空的返回值得数目累加起来—就好像一个累加器一样。

只有变量的初始值表达式必须是数字型的，并且需要和变量的类型相同，因为这个值将会在初始化的时候被直接赋给变量。

Calculation Sum

如果你选了这种计算类型并且确保变量是数字类型的，则报表引擎将会把变量主表达式的返回值累加起来。我们不能计算java.lang.String or java.util.Date类型的报表变量。

Calculation Average

对于数据源中的每一条记录，报表引擎可以计算通过对变量表达式求值所得的一些列结果的平均值（series of values obtained by evaluating the variable’s expression）。这种类型的计算的也只能是数字类型的变量。

为了计算平均值，报表引擎在后台创建了一个helper报表变量，此变量的作用是计算values的累加和，然后可以通过它来计算平均值。这个helper sum variables的命名规则是在与它对应的变量名之后加上后缀“_SUM”。例如你给某个数字类型的表达式声明了一个平均计算变量名为“MyAverageVariable”，则报表引擎将会创建一个报表变量MyAverageVariable_SUM来帮助计算平均值。你可以在其他表达式中使用这个helper变量，就像你使用其他你声明的变量一样。

报表引擎为了计算平均值，也需要一个计数变量来与辅助加法变量对应。对“Report”,”Page”和”Column“这三种resetype，它用了内置的计数变量，这些我们在接下来的一个部分将会讲到。而对于resetType=”Group”的情况，它在后台创建了一个helper计数变量，其名称为原始的平均变量名加上后缀”_COUNT”。

Calculation Lowest and Highest

对于每一个数据源记录来说，如果你想在一系列从赋值表达式中获得得最大或最小的value，你就需要选择这种类型的计算。

Calculation StandardDeviation and Variance

在一些特殊的报表中，你可能会需要执行一些高级的数字运算，而JasperReport已经内置了对的一些经过变量表达式赋值所得到的value的标准偏差和方差进行计算的算法。和前面计算均值的方法一样，报表引擎首先建立一些helper变量来获得相应于当前一系列值的计数和累加和，这些变量命名方式和上面一样，这里不再赘述。

Calculation System

当你不想要报表引擎去干预你的变量运算时，你可以选择这个选项。这意味着你要通过使用JasperReports 的scriptlets功能来亲自计算变量的值。

对于这种类型的运算，引擎唯一做的事就是从数据源的迭代中保存你已经计算好计算的那些值。

例子：

下面是一个简单的报表变量声明，用来计算名为“Quantity”的数字字段的值的总和：

$F{Quantity}

如果你想要每一页的该字段值的和，下面显示的是所要求的变量声明：

calculation="Sum">

$F{Quantity}

new Double(0)

在上面的这个例子中，我们的page sum variable 将会在每一新页的开头被初始为0。

6.6.2 Built-in Report Variables（内置报表变量）

有如下的几种内置系统变量可以直接用在表达式中：

Variable Page_NUMBER

该变量保存当前的页号。在报表装填结束的时候，该变量值保存最终文档的总页数。所以要在JasperReport的文本字段中显示页号和总页数你都可以用它。

通过使用JasperReports 的text field 元素的一个名为evaluationTime 的特性，该变量就可以同时显示当前页码和页面总数。在大多数的例子中都会有上述这种情况。

Variable COLUMN_NUMBER

该变量表示当前的列码。例如，一个报表页面中有三列，则在isTitleNewPage和其他相关属性不干涉的情况下，报表的第二页中的列码应该是#4，#5，#6。

Variable REPORT_COUNT

当数据源迭代结束之后，该报表变量值表示的是处理的记录的总个数。

Variable PAGE_COUNT

该报表变量用来表示在当前页中处理的记录总个数。

Variable COLUMN_COUNT

该报表变量用来表示在当前列中处理的记录总个数。

Variable GroupName_COUNT

当声明了一个报表组，引擎会自动创建一个计数变量来计算组成当前组的记录数目，即在组和组的rupture之间所处理的记录的数目。（注：这里的GroupName是泛指组名，即任意一个组的名字）

该变量名字的来源就是相应的组名加上后缀“_COUNT”，它像其他的报表变量一样可以用在任何报表表达式中。

7 Report Sections

在建一个报表设计时，我们需要定义它的每个section的内容和设计。报表设计的整体结构基于下面几个部分：