iReport http://www.jasperreport.net

一、介绍

iReport是一个能够创建复杂报表的开源项目，它100%使用Java语言编写，是目前全球最为流行的开源报表设计器之一。

由于它丰富的图形界面，你能够很快的创建出任何一种你想要的报表。

(相关资料图)

以下是iReport一些比较突出的功能：

• 拖拽式,所见即所得的报表编辑器；

• 多样的向导来简化复杂的报表设计任务；

• 超过30个排版和格式化工具；

• 报表可转换为PDF HTML EXCEL FLASH CSV RTF TXT OpenOffice Java2D JRViewer等格式；

• 支持所有有效的数据源。如:JDBC,CVS,Hibernate,JavaBean等；

• 用户自定义数据源；

• 无限次数的撤消/重做；

• 集成脚本（scriptlet）支持；

• 内置图表支持：超过20种的图表支持。并可扩展；

• 国际化：集成超过15种语言；

• 报表模板与报表库样式管理；

• 源文件的备份；

• 文档结构浏览器。

二、开始

在本章中我们将介绍iReport运行时所需要的环境、如何下载iReport以及如何在我们的系统中安装使用。

2.1、运行环境(Requirements)

iReport运行时需要sun java2 SDK 1.5及以上版本，为了能编译我们的报表文件我们需要完整的安装JDK。

2.2、下载(Download)

iReport官方网址：http://ireport.sourceforge.net/cap3.html。

2.3、运行(Run)

将文件下载到本地解压后，您可以直接双击iReport.exe或者iReport.bat来运行程序。

注：在本文中iReport的版本是3.0.0。

三、报表结构

在本章中我们将分析一下报表的结构，看一下报表中每一部分的作用是什么，以及在生成报表的时候每一部分将产生什么样的效果。

栏(Bands)

报表被垂直分成若干个部分，每一个部分我们叫它“band”。每一个band都有自己的特性，在报表生成的时候有些会打印一次，有些会打印多次。如下图。

接下来我们就对每一种类型的band分别进行介绍。

*Title Band*：title段只在整个报表的第一页的最上面部分显示，除了第一页，不管报表中有多少个页面也不会再出现Title band中的内容。就是报表的标题。

*pageHeader Band**：***pageHeader段中的内容将会在整个报表中的每一个页面中都会出现，显示的位置在页面的上部。如果是报表的第一页，pageHeader中的内容将显示在Title Band 下面，除了第一页以外的其他所有页面中，pageHeader 中的内容将显示在页面的最上端，即页眉。

*pageFooter Band**：***显示在所在页面的最下端，即页脚。

*Detail Band**：***报表内容段，在这个Band中设计报表中需要重复出现的内容，Detail 段中的内容每页都会出现。

*columnHeader Band**：***针对Detail Band的表头段，一般情况下在这个段中画报表的表头。

*columnFooter Band**：***针对Detail Band的表尾段。

*Summary Band**：***表格的合计段，出现在整个报表的最后一页中的Detail band的后面，一般用来统计报表中某一个或某几个字段的合计值。

*lastPageFooter**：***内容将会出现在报表的最后一页的最后部分。

为了实际演示各个band的生成效果，我们可以在报表中的各个band里添加不同的对象，以测试各个band的作用。

步骤：

第一步：新建文档，报表名称命名为：MyFirstReport，然后单击“OK”。

第二步：设置JDBC连接参数

单击“Dateà连接/资料来源”，出现如下界面：

然后单击“New”，出现如下界面：

选择“Database JDBC connection”项，单击“Next”,

设置好参数，单击“Test”，如果测试成功单击“Save”保存，如果测试没有成功，请检查一下以上步骤。

第三步：单击Dataà报表查询。在query editor里输入下面的语句：

select * from tb_employee,然后单击“OK”

第四步：单击“不会变动的文字”按钮，添加各个Band内容。

在报表中的各个band分别放置如下内容：

第五步：将要显示的字段拖到“detail”栏内

第六步：单击“执行报表”查看结果：

启动报表，生成的效果如下：

最后一页：

四、报表元素

在本章中我们将介绍可以在报表中使用的对象及他们的相关属性。

我们所说的元素主要是一些图形对象，比如text，rectangle等。在iReport中没有段落、表格或分页的概念，在报表中最基本的对象主要有七个：

-Line(线段)

-Rectangle(矩形)

-Ellipse(椭圆形)

-Static text(不会变动的文字)

-Text field(文字栏位)

-Image(图像)

-Subreport(子报表)

-Crosstab()

-Chart

通过以上这些组件的组合我们可以做出各种各样复杂的报表样式。iReport提供两种特殊的图形对象：chart和barcode。

每一种类型的对象都有一些通用的属性，如高度、宽度、位置、所在的band等。除此之外还有一些针对不同元素的特殊属性。

每一个元素都必须在一个band内部，如果一个元素跨了一个以上的band，那么在编译的时候将会抛出元素位置错误的异常。

要添加一个元素到报表中，我们可以从主工具栏中选择相应的工具，然后添加到报表区域中即可。

我们可以通过双击对象或右键菜单打开元素的属性设置窗口。

属性窗口由若干个标签页构成，“Common”标签里包含每一个组件都具有的通用属性，其它的标签页是针对不同元素的属性设置。在下面的章节中，我们将对每一个对象的使用做详细的介绍。

五、字体和样式

一个style是一个预定义的属性的集合，用来控制元素的外观（比如背景色、边框线、字体等）。我们可以为我们的报表定义一个默认的style。

要为一个元素应用一个style，我们可以选择该元素并从元素的属性窗口common标签里的style列表选择你需要的style。

Fonts是用来描述text的外观特征。

5.1、字体(Font)

通常定义一个字体，我们需要做下面几件事情：

-Font name(字体名称)

-Font dimension(字体大小)

-Attribute(属性，诸如bold-faced,italics,underlined,barred)

如果我们需要导出PDF格式的报表，需要为字体添加下面的信息：

PDF Font Name：PDF字体名称（预先定义PDF字体或一个在classpath里的TIF文件的名称）。

PDF Embedded：当使用一个外部的TTF类别的字体文件生成报表时是否把它包含在PDF文件里的一个标志。

PDF Encoding：指定一个字体编码名称。

单击“格式化à报表字形”可以创建自定义的字体。

如果我们需要将报表导出成PDF格式，将会使用指定的PDF字体，其它属性将会被忽略掉。

5.2、样式(Styles)

我们可以选择主菜单的“Format Styles” 来定义一个style。如下图所示：

单击“格式化àStyles”可以创建自定义的样式。

点击“New”按钮添加一个新的style。在弹出的窗口中我们可以定义一些属性，如果我们需要某个属性的值，我们可以点击按钮来实现。

在每个元素属性窗口的“Common”标签里有一个style属性下拉框，如果我们需要为一个元素设置一个style，我们可以在这个下拉框里选择我们定义好的style，这样就可以把一个style应用到一个元素上面了。

我们可以为一个Style加一个动态的条件，当条件满足的时候采用某个style，否则就采用默认的style。举个例子，还是以数据库里的employee表为例，如果员工的工龄大于3时，我们让工龄以红色加粗的字体显示。

打开Query窗口，输入下面的查询SQL：

Select * from tb_employee

新建一个style，在弹出窗口的style conditions里新建一个conditions，在表达式窗口里输入下面的表达式：

($F{employee.workingYear}.intValue()>2?newBoolean(true):new Boolean(false))

如下图：

新建的style如下图：

接下来把员工姓名和工龄到报表当中，并将我们新建的style应用到薪水这个field上，如下图：

启动查看运行效果如下：

六、字段、参数、变量

在ireport中有三种类型的对像可以用来保存数据:Fields/Parameters/Variables.这三种对象可以用在某些地方的Expression中,通过一定的逻辑在报表生成的时候动态的更改某些值。Fields/Parameters/Variables有类型的概念，它们的类型就是一个标准的Java的Object。要使用这三种类型的对象我们必须首先创建它,创建的方法是点击“View”主菜单中，选择其中的子菜单Fields,Variables,Parameters我们可以创建不同的对象。通过这三个子菜单我们可以查看并管理Fields,Variables,Parameters对象。

会出现如下界面：

通过该窗口，我们可以创建，修改，删除这三种类型对象。

6.1、字段(Fields)

Field在ireport是专门用来组织记录。Field的创建有多种途径可以实现，我们可以根据在ireport中各种类型的数据源来创建我们所需要的Field。

6.1.1、在Fields标签页中，我们可以点击new 按钮来创建一个新的Field。

一个Field有两个必填的属性： name、type和一个可选项的description。从ireport1.0.0开始，fields可以是任何Java数据类型。这样当我们使用JavaBean作为数据源时我们可以很方便的从java.lang.Object向报表中的Field的转换工作。在对象的Expression里你可以使用下面的语法来引用一个field:

$F{field name}

例如，如果你想处理com.bstek.test.domain.Person Bean里的username 字段，可以这样去写：

((com.bstek.test.domain.Person)${username})

6.1.2、用一个SQL query来创建Field

在ireport的设计中，使用SQL query的方式来创建或记录字段的是使用最广泛的也是最直接最简单的一种方式。做此操作我们需要首先打开ReportQueryDialog窗口(点击主工具栏的 按钮),ReportQueryDialog窗口出现后，我们可以输入合适的SQL检索并创建Fields。

在打开ReportQueryDialog窗口之前请先确认我们已经有一个数据源连接处于激活状态（激活方式请查看相关章节）,插入一条查询语句，如：select * form employee

iReport将启动SQL查询引擎，根据输入的SQL将分析结果用fields的形式展示出来。在下面的窗口中选择你要的fields(可以多选)然后点击OK按钮， fields就被创建出来了。

在这个例子当中所有字段有多种类型，一般地说，fields的数据类型是构建在原始SQL 类型基础之上的，如String,Integer…

6.1.3、用JavaBean生成Fields

ireport的高级特性之一是它的数据源除了可以构建在SQL query基础之上外，还可以使用含有getter和setter方法的JavaBean（或者叫POJO）对象来创建。在这个例子中fields就是POJO类里的属性（或者是属性的属性，即子对象的属性）。

第一步：定义一个简单的Bean：

package com.asinfo.ccm.model;

public class ProductBean {

private StringproductName;

public StringgetProductName() {

​ returnproductName;

}

public voidsetProductName(String productName) {

​ this.productName= productName;

}

}

第二步：要在iReport中使用JavaBean作为数据源，首先要定义好Classpath，以使iReport能够找到我们定义的Bean，使用菜单“Options”-“Classpath”定义Classpath，定义的路径为编译后的.class文件所在路径，例如，我定义的Classpath为“C:\Documents and Settings\wzz\workspace\ccmrightinfo\WebRoot\WEB-INF\classes”。

第三步：在菜单“Data”-“Connections/Datasources”菜单中，添加数据源，将数据源类型设为“JavaBeans set data source”，设定的数据源属性如下图所示：

第四步：然后到菜单“Data”-“Report Query”中定义需要用到的 Bean属性，在“Class name”中输入自定义Bean的名称，本例中为“lld.test.ireport.ProductBean”，然后点击“Read attributes”按钮，获取Bean属性，点击“Add Selected Field(s)”添加要用的属性，如下图所示：

要把一个属性添加到field列表,只需选中需要的属性然后点击“Add field(s)”按钮。

6.2、参数(Parameters)

Parameters通常是用来在打印的时候从程序里传值到报表里。也就是说parameters通常的是起参数传递的作用。他们可以被用在一些特定的场合(比如应用中SQL 查询的条件),如report中任何一个需要从外部传入的变量等(如一个Image对象所包括的char或报表title的字符串)。

和使用Fields一样,parameters也需要在创建的时候定义它的数据类型。parameters的数据类型是标准的java的Object。

在ireport中，Parameters的机制是允许用户通过应用程序传递参数致报表当中。在jasperreort中的某个对象中的expression可以通过下面的语法来访问一个当前ireport中存在的parameter:

$P{parameter name}。

如果应用程序没有为报表中定义的parameter赋值，那么parameter将会取我们在定义它的时候设置的default value的值。parameters是一个Java Object,所以如果它的类型是Object类型，我们在其default value里写下面的表达式就是错误的:

0.123

你必须要创建一个Object,如:

New Double(0.123)

这种写法就是正确的。

6.2.1、在查询中使用Parameters

Parameters可以用来做SQL查询的条件参数的传递。如果你想根据部门编号(dept_id)得到客户的详细信息 (设计的时候我们是不知道这个部门编号的具体值是多少的).此时我们可以这样组织查询语句:

select * from employee where dept_id=$P{deptId}

此时SQL查询引擎将会采用PreparedStatement来处理传入的deptId值以此作为查询条件参数。

如果你想直接通过parameter 值来作为SQL语句的一部分,那么你可以使用下面的特殊语法:$P!{parameter name}。这种写法允许你在查询时用parameter的值来替换parameter name。例如,如果我们有一个参数名为MyWhere其值为:where dept_id=D11 ,查询写法如下:

Select * from employee $P!{MyWhere}

查询时实际提交的字符串是:

Select * from employee where dept_id=D11

6.2.2、在程序里使用Parameters

在应用程序里，如果想把某个值传递到我们的报表中parameters时，我们可以把相关的值放入一个扩展java.util.Map接口类里，然后传入到ireport里。如下面的代码:

...Map hm = new HashMap();...JasperPrint print = JasperFillManager.fillReport(fileName,hm,new JREmptyDataSource());

fillReport是一个关键的方法,它允许你通过一个文件名,一个参数集来传递到我们要调用的报表当中。例-如通过下面的处理方法我们可以让一个处部的传入值作为我们报表的title。

下面的是一个例子：

a).声明一个parameter.这个parameter是java.lang.String 类型，名字为：name_report:

b).将这个parameter拖到page中的titleband.修改上面的程序代码如下：

HashMap hm = new HashMap();hm.put(“name_report”,”report title”);...JasperPrint print = JasperFillManager.fillReport(fileName,hm,new JREmptyDataSource());

运行时效果如下：

一般情况下，我们不需要为报表中的每一个parameters传递一个值，除非某一个parameter一定要从外部程序传入时我们才需为一个parameter设置一个值。如果一个parameter外部门程序没有为其赋值那么ireport将使用Default Value Expression来对一个parameter进行初始化，如果连Default Value Expression没有设置那么它的值就是null。

事实上，对于一个parameters我们不仅仅可以传递一个String,Integer,Boolean等java中小的对象，同时我们还可以利用parameters来传递一些足够大足够复杂的对象,比如一个图像（java.awt.Image）,或者通过一个parameters来为一个为子报表提供的datasource 连接等。在用Map类型传递参数时我们要注意传递的参数要与report里的parameters类型保持一致，否则会抛出ClassCastException。

ireport内嵌的Parameters：

ireport提供了一些内建的parameters，这些parameters对于用户来说是只读的。内嵌的parameters列表如下：

6.3、变量(Variables)

Variables是用来存储对某些字段计算后的结果，比如sum等。

和fields,parameters一样，Variables也是有数据类型的。你必须为一个Variable实例声明一个java类型。上图显示了如何创建一个新的Variable。看一下每个字段的意思：

Variable name: variable的名称，我们可以在表达式中通过下面的方法来引用一个Variable:

$V{variable name}

Variable Class Type : variable也可以是任意一个Java类型，在下拉框里你可以看到大多数常用的类型，如java.lang.String等。

Calculation Type : 一个计算类型可以用来计算结果。当一个预先定义的值是“nothing”时，那它的意思是不做任何计算。ireport会根据指定的计算类型和从数据源中获取的每一条记录计算出结果，然后去更改variables的值。做一个变量的计算意为着去执行一个表达式，如果计算类型为nothing，那么ireport将会根据variable expression为variable赋值。计算类型列举如下：

Reset Type : 重置类型。表示一个变量在什么时候做重置操作。reset类型如下：

Reset Group :如果group reset type被勾选，这里就要选择group名称(关于group可以参考后面的章节)。

Increment : 它指定当一个variable值被评估或当你想要这个组采用类似于subtotals 或averages来计算，increment 类型可以参考下面的表。

Increment Group : 如果这个group的increment type 被勾选它将指定这个组决定variable的increment。

Custom Incrementer Factory Class : 指定一个实现了JRIncrementerFactory接口的java类名称，通常用来定义一些诸如sum之类的非数字类型的操作。

Variable Expression : 它是一个java的expression，用来标识variable每一次迭代的值。

Initial Value Expression : 它是一个为variable初始化时采用的expression.

内置的variables：

和parameters一样,ireport提供了一些内置的variables(这些由报表引擎直接管理),这些变量是只读的，不能被用户修改，如下表所示：

七、栏和组

在本章中，我们将解释如何用iReports去管理bands和groups，在第四章中我们介绍了报表的结构，在本章中我们将要看到如何使用bands来划分报表。同时我们还将看到如何使用groups,如何创建report中的breaks,如何管理subtotals等等。

7.1、栏(Bands)

ireport把一个报表划分成七个主要的bands和一个名为backgroup的band(一共是八个bands)，每当我们添加一个group时就会有两个新的band添加到报表当中：group footer bands和group header bands。

点击 按钮在弹出的窗口中我们可以对当前报表所具有的bands的进行相关属性的修改。

通过上图中的窗口，我们可以修改左边列表窗口中的任何一个band的属性，比如它的高(以像素为单位)。Print When expression表示我们可以在这里输入一个表达式，这样我们可以根据表达式的值来控制当前的这个band是否输出。这里需要注意的是Print When expression里必须返回一个java.lang.Boolean类型的对象,如：

New Boolean(true)

上面的表达式说明这个bands总会被打印(如果我们什么都不输入这个就是默认值)，在表达式里可以使用fields,variables,parameters。根据这个特性我们可以通过相关的fields,variables,parameters来灵活的控制当前的band是否可以输出，比如下面的代码：

($F{SALARY}.intValue()>4000?new Boolean(true):newBoolean(false))

上面的代码说明当salary的值如果大于4000就输出当前的band否则就不输出当前的band。

把鼠标移到bands的边上我们可以鼠标拖拉的方式改变band的大小以此来适配band里的内容。

7.2、组(Groups)

Groups允许我们对报表里的数据进行全新的切割分组组合。分组是通过一个表达式来定义的,ireport会通过这个表达式进行计算分组情况，每一个新的组都是从我们在expressionvalue里输入的表达式发生变化的时候开始的。接下来我们将通过一个例子的演示一步一步说明如何使用groups。

假设我们有一个员工的列表，我们想要创建一个根据员工所在的部门进行分组的报表。

a)首先我们打开一个新的报表文件，然后点击Connection/Data Sources，选择JDBC Connection，我们创建一个JDBC的Connection，如下图：

b)点击和工具栏里的按钮，输入查询语句，如下图

c)把Employee_no和Employee_department两个field拖到report 中的detail的band里，同时调整detail band的高度，如下图：

d)保存报表文件，并按浏览报表生成后的效果,如下图：

到这里，我们看到员工的数据已经可以在报表里显示，接下来我们就对员工信息按dept_id字段进行分组显示。

e)点击主工具栏里的按钮，打开groups定义窗口，并添加一个新的名为dept的group,如下图：

一个group有下面几个属性需要我们去定义：

Group name:为这个group指定一个名称，group创建完成后会产生两个新的band : header和footer band，这两个band的名称采用group的名称来定义。

Start on a new column:如果此选项勾选，那么分组只会在报表中的新的column产生，也就是说在一页中报表分组在一个column里只会做一次。

Start on a new page:与上面的选项类似，如果该选项勾选，那么分组只会在每一页做一次，也就是说每一页最多只会有一个分组数据。

Reset page number:该选项允许在一个新组开始的时候重设页号。

Print header on each page:如果该选项勾选，那么如果当前页没能显示完组里的所有数据时，到一页显示该数据时会把该组的header打印出来，否则将不会打印。

Min height to start new page:该选项用来设置当前报表中页面所余下的高度的最小值分组的最小值，默认值是0，如果我们设置为100，表示如果当前页面余下的高度小于100就不再继续显示分组的数据，而是在下一页显示分组的数据。

Group expression : 分组时采用的表达式规则，如上图中我们在定义dept这个group时我们在GroupExpression里输入了$F{DEPT_ID}，表示将该组按员工的DEPT_ID字段进行分组显示。

Group header band height:新产生的header band的高度。

Group footer band height:新产生的footer band的高度。

f)接下来我们把在detail band里的dept_id的field移到report里新产生的deptHeader的band里，

g)点击按钮，报表的生成效果如下：

在jasperreport里group的数量是没有限制的，一个group可以有一个父group同时也可以有若干个子group。通过group定义列表，我们可以通过”move up”和”move down”来设置group的顺序。

*Group**向导***

在iReport中还有一种简单的方法创建一个group，那就是向导，通过向导我们可以快速的创建一个group,我们可以通过主菜单中的Edit new report groupwizard来启动创建group的向导。

向导允许用户创建最多有四个group的报表（group header,group footer和每一个group关联）。

*Groups**和records*的排序**

我们可以在设置查询的地方选择设置选项来使ireport自动对依据字段进行排序，我们也可以在创建一个group时要对分组的字段做好正确的排序工作。比如在sql中我们可以添加“order by ”来对要分组的字段进行排序。

八、子报表

SubReport是ireport提供的高级功能，通过SubReport，我们可以创建复杂的报表。通过SubReport，我们可以创建一个包含若干个子报表的报表。创建一个包含子报表的报表我们需要三个对象：一个jasper文件，一个包含参数map(当然可以为空)和一个DataSource(数据源,或者是一个JDBC的Connection)。在本章中我们将解释如何通过这三个对象创建一个SubReport并实现在子报表中数据过滤显示的目的。

8.1、创建一个子报表

一个SubReport是一个真正的包含它自己xml文件并且是一个已经编译好的jasper文件。创建一个SubReport就是创建一个普通的报表文件，创建过程中唯一需要注意的是设置SubReport的宽度、高度及一些不需要显示的band，一般情况下对于不显示的band我们把它们的高度都设置为0。在设置子报表的宽度时我们应该考虑到它在父报表中显示时的效果，然后针对这一特性有针对性的去设置。

在父报表中我们要添加一个子报表可以通过iReport中的SubReport工具 来实现。子报表的形状和一个距形类似，我们可以调整SubReport的尺寸和位置以控制子报表的显示。

将一个子报表链接到父报表中需要做三件事情：获得SubReport所对应的jasper报表对象、如何为它提供数据及如何为子报表的parameters设置具体的值。所有这些信息的定义我们可以通过SubReportproperties窗口来实现。

8.2、 传递参数

当我们在应用程序里通过fillReport方法来生成一个报表的时候，我们会提供一个包含参数值的Map一起传递到报表中，包含参数的Map对象是由报表引擎直接管理的。在子报表属性窗口的里的“SubReport”标签里的“Parameters Map Expression”属性，就是提供给我们的最简单的方法来为子报表设置parameters的值，它允许我们定义一个最终可以返回java.util.Map对象的表达式，使用这种方法我们可以把从外部应用程序传到父报表里的parameter对象，当然这个parameter的实际值是一个java.util.Map对象传递给子报表使用（比如$P{TestMap}），这里我们也可以使用内建的报表parameters:$P{REPORT_PARAMETES_MAP}把子报表中的java.util.Map对象传递到父报表中供使用。如果该属性我们空着不填那么一个不包含任何值的空的java.util.Map将会被传到子报表中。这种机制的局限性是parameters里所对应的java.util.Map值是死的、不会变的。为了克服这种局限性，jasperreport允许我们定义parameter键值对的时候每个对象的值通过一个表达式来创建，如在图中的“SubReportParameter”表中通过添加个参数java.util.Map来填充子报表。

deptId是子报表中一个parameter的名称，如果设置值时也要与子报表中deptId的数据类型保持一致。

指定数据源

为子报表指定数据源就是告诉jasperreport引擎如何获到数据来填充SubReport。我们可以指定两种类型的数据源：JDBC Connection和DataSource。

使用JDBC来填充报表是很简单的，在Connection Expression里定义一个已经连接到数据库的java.sql.Connection对象。要把一个已经处于打开状态下的连接传到SubReport中我们只需使用一个预定义的包含一个基于从应用程序里调用fillReport方法时的传入的连接REPORT_CONNECTION参数

如果使用一个DataSource就稍微复杂一点，事实上它是一个简单的记录的集合，记录集合的概念和JDBCConnection不同，既然如此我们可以通过一个parameter来传递一个DataSource来填充SubReport，此时采用这种机制内建的parameter REPORT_CONNECTION就不再起作用了。

一个DataSource是一个普通的“消费品”对象仅仅可用来填充一次报表。所以一个作parameter传递的DataSource可以满足一个SubReport的需要。因此parameter的方式不能满足当父报表的每一行记录都有一些子报表的数据与之对应（除非主报表中只有一条记录）。当我们解释DataSource时我们可以看到这个问题可以通过自定义DataSource方式解决。

指定SubReport

创建一个SubReport我们需要指定一个扩展名为.jasper文件，我们需要在SubReport属性窗口中设置SubReport Expression属性。表达式返回的类型必须与我们在下拉框里选择的类似保持一致，类型列表如下：

如果表达式是一个String类型，那么引擎将通过JRLoad来加载指定位置的jasper文件。

8.3、子报表示例(SubReport sample)

在这个例子中我们将采用示例数据库来创建一个简单的包含子报表的报表。我们要从两张表里取数据:dept(部门表)、employee(员工表)，要达到的效果是根据部门表的部门ID取出该部门下的所有员工。类似的效果的报表我们在groups一章中使用group也实现了一次，这里我们将用SubReport来实现相同的效果。

新建一个空报表，新建一个名为deptId的parameter对象，如下图：

在这里我们在Default Value Expression里赋予了一个空的字符串，为什么要这样做呢，因为接下来我们要使用该parameter来作为SQL的查询条件的输入值，所以我们要对这个参数赋予一个初始化的值。

点击 打开SQL查询引擎窗口，输入下面的查询语句：

Select * from tb_employee where dept_id=$P{deptId}

在这里，我们在查询员工信息的时候加了一个部门的条件，如下图：

此时如果我们把相关的field拖到detail band里，然后点击 我们发现没有任何记录，原因是因为我们并没有为deptId赋值。

保存报表文件，我们命名为emp.jrxml,我们把这个报表文件作为下面将要引用的子报表文件。因为它将作为子报表被引用，所以我们需要调整该报表的不用显示的band的高度及detail band的高度，如下图：

在detail band里我们放置了三个字段:employee_name(员工姓名)、sex(性别)、birthday(出生日期)。

接下来我们需要建立一个父报表，关闭emp.jrxml文件，新建一个空的报表文件，命名为dept.jrxml。点击主工具栏里打开SQL查询窗口，输入下面的语句：

Select * from tb_position

如下图：

把dept_name这个field拖动到报表的detail band里，同时在detail band里添加一个了报表，在弹出的子报表向导中我们选择“Cancel”按钮，这里我们不采用向导来创建SubReport。如下图

双击子报表图标打开子报表属性设置窗口,在弹出的窗口中我们选择“SubReport”标签，在“Connection/DataSource Expression”属性里我们选择“UseConnection Expression”并且指定内建的parameter：REPORT_CONNECTION作为表达式用来存储JDBC连接，如下图：

切换到“Subreport(other)”标签窗口，指定如何找到子报表文件“emp.jasper”以及如何创建和修改在子报表与父报表之间的参数传递。

使用绝对路径在iReport里我们不用去考虑子报表文件是否可以被找到的问题，因为子报表存放的目录已经被自动的加到iReport的classpath里了。这里我们指定的值是“$P{SUBREPORT_DIR} +java.io.File.separator+"emp.jasper"”

为了在子报表里可以显示员工的信息我们需要为子报表的deptId这个parameter赋值，这里我们通过父报表传过去，在“Subreport parameters”窗口中，我们添加了一个用于为子报表的deptId赋值的parameter，该值到于父报表中的$F{DEPT_ID}这个field。编译子报表和父报表。

点击主工具栏中的按钮，查看生成的后父报表效果。

九、数据源

一个DataSource是Jasperreport获取数据以生成报表的源。这里有两种类型的DataSource：一种是JDBC Connection，用来从关系型数据库里取数据；另外一种是扩展了JRDataSource接口的java object，这种类型的对象允许我们去管理数据的细节，比如一个xml文件或一个javabean的集合。

通过sql 查询从关系型数据库里取数据来填充生成报表是很简单的，iReport可以通过各个数据库厂商提供的JDBC Driver来获取连接生成要检索的field。

如果我们不通过JDBC直接访问数据库来获得生成报表的字段与数据的时候，我们需要使用JRDataSource(全称JasperReport Data Source)。JRDataSource是一个接口,它允许我们访问具有行列结构的数据(在Datasource行我们叫records,列我们叫record fields)。

不管是JDBC Connection还是JRDataSource，他们都不能通过JasperReport来创建,但是当应用程序调用生成报表的时候，我们可以通过JasperReports的fillReport方法传递一个打开的数据库连接(一个java.sql.Connection对象)或者是一个JRDataSource对象实例用于填充被调用的报表。对于传递一个java.sql.Connection对象的情形，JasperReports将在指定的报表里使用JDBC Connection来执行一个SQL查询，查询的结果将会被包含在一个JRResultSetDataSource对象里(JRResultSetDataSource也是一个JRDataSource对象的实例),这样JasperReports将使用一个JRDataSource对象来关联打印数据。

在本章中，我们将阐述JRDataSource的不同类型和他们如何在iReport中使用。此外我们还将看到如何对一个JRDataSource做扩展；通常通过扩展一个datasource可以克服JsperREports自身的一些局限性，比如在交叉报表中使用等。

9.1、iReport中的数据源

iReport允许我们管理和配置不同类型的DataSources用来填充报表。这些DataSources被储存在iReport配置文件中当我们需要的时候即可以使用。

我们可以使用的DataSources类型如下：

- JDBCConnection

- XMLDataSource

- JavaBeanCollection DataSource

- CSVDataSource

- CustomDataSource

- JRDataSourceProvider

- HibernateDataSource

打开状态的JDBC Connection在报表生成的时候会被直接传递到JasperReport中。XML DataSource允许我们从XML文档里获取数据用来填充报表。一个CSV DataSource允许我们打开一个CSV文件来填充报表。JavaBean Collection DataSource，CustomDataSource和JRDataSourceProvider他们允许我们一个写好的java类来获取数据。Hibernate DataSource定义了一个执行HQL语言的方法。DataSource的管理我们可以通过在主菜单“Data Connections/DataSources”(图10.1)打开配置管理DataSource窗口界面。

从技术的角度去看一个Connection和一个DataSource是两个不同的对象（Connection需要一个关系一个关系型数据库，但是一个DataSource只是提供一个简单的接口用来访问数据结构）。

虽然我们可以建立了若干个DataSource准备使用，但是iReport在工作时同一时候总是使用一个DataSource或一个connection。因此你需要设置一个“active”datasource。设置一个dataSource为“active”最简单的方法是在工具条上的下拉框里选择一个你要使用的datasource，那么这个datasource就处于“active”状态了。

同时你也可以从主菜单里的“DataàSet the active connection”在弹出的窗口中选择一个DataSource并设置其为“active”状态。

图62

最后我们还可以在DataSource窗口里通过“set default”来设置“active”状态的DataSource。

如果没有datasource处理“active”处于激活状态，那么iReport里生成的报表里面将不会产生数据。同时当我们使用报表向导的时候要求必须要有一个处于“active”状态的JDBC Connection。

9.2、JDBC连接

一个JDBC Connection允许我们从一个关系型数据库里直接获取数据（需要有一个JDBCDriver）。要添加一个新的JDBC Connection,可以点击“New”按钮打开创建新连接的管理窗口。

选择“Database JDBC Connection”点击“Next”，在出现的窗口中输入数据源的名称及Driver、URL、username,password等相关信息。

点击“test”按钮，对JDBC连接做测试。

完成新建JDBC Connection之后，别忘了在管理窗口中设置Connection的“active”状态。

当报表采用的是一个JDBC Connection创建的时候，用户需要指定一个SQL语句用来从数据库里取出数据。主报表的Connection也可以为其子报表提供服务。例如，JasperReport里的REPORT_CONNECTION，一个java.sqlConnection类型的内建参数对象放在表达式里提供给子报表使用。

$P{REPORT_CONNECTION}

这个参数包含的是一个正确的从应用程序里传入的java.sql.Connection对象。使用JDBC或一个SQL Connection是一种最简单的最容易的方式用来填充报表，关于创建SQL查询的细节我们将在11章中讲解。

为了可以在报表中使用通过SQL查询出来的fields,我们需要“Register”它们（要注册的可能不是全部是字段，仅仅只是我们在报表中要使用的字段）。对于每一个字段我们需要指定一个名称和字段的类型，下表中显示了SQL类型所对应的Java类型。

在上面的表当中对于BLOG和CLOB类型和其它的特殊类型如ARRAY、STRUCT,REF等我们没有指定对应的JAVA类型，这是因为这些类型在JasperReports里不能自动管理它们。

9.3、JRDataSource接口

除了使用SQL做为数据源之外，我们还可以使用其它类型的数据源。在使用之前，我们需要明白如何使用JRDataSource接口。对于实现每一个JRDataSource接口的类必须实现两个方法：

Public Boolean next()

Public Object getFieldValue(JRField jrField)

对于第一个方法是用来移动一个虚拟的游标到下一条记录，判断是否还有记录。如果Next方法返回true表示还有记录,否则表示已经没有记录了。

当JasperReports执行next方法时，在报表里声明的所有字段将被赋上相应的值并且所有的表达式重新计算它的值，接下来将决定是否在一个新的group里打印header，是否开始一新的页等。当next方法返回false时，报表的内容也就宣告结束同时开始打印所有的最后的bands(group footer,column footer，last pagefooter 和summary)。很多时候需要调用next方法用来取下一条记录。

当JasperReports调用完成next方法后如果返回true的时候就调用getFieldValue方法。事实上报表里的每一个field在取值的时候都会调用getFieldValue方法(查看第七章看如何声明一个报表的field)。getFieldValue方法返回数据的类型必须与声明的字段类型相匹配，当然如果返回一个null除外。

9.4、使用JavaBean作为数据源

在DataSource里面我们还可以使用一些JavaBean做为数据源来填充数据，这里的JavaBean指的是一个POJO，里面private类型的若干个属性和与之对应的getter方法：

Public getXXX()

这里的（返回值）是一个普通的java类或一个简单类型如int、double等。

要创建这种类型的connection我们只需在创建的时候选择“JavaBeans set datasource”

点击“Next”输入“JavaBeans set data source”的名称，JavaBean set datasource使用一个扩展类（一个工厂类）来生成我们所需要的JavaBean对象，然后组合成数据传递到报表当中。输入包含包名的java class名称,它需要有一个static方法产生一个包含若干个javaBean的Collection类型或一个array(Object[])类型。让我们来看看如何去写这个工厂类。

假如你的数据是一个Person对象，它包含两个fields：name和age：

*package*com.asinfo.ccm.model; *import*java.io.Serializable; *public**class*** Person *implements*Serializable { *private*Stringname; *private**int*** age; *public*Person(String name,*int*age){ *this*.age = age; *this*.name = name; } *public**int*** getAge() { *return*age; } *public**void*** setAge(*int*age) { *this*.age = age; } *public*String getName() { *return*name; } *public**void*** setName(String name) { *this*.name = name; } }

接下来我们要写我们的工厂类，我们这里的工厂类名为TestFactory

*package*com.asinfo.ccm.model; *import*java.util.ArrayList;*import*java.util.Arrays;*import*java.util.Collection;*import*java.util.List; *public**class*** TestFactory { *private**static*** Person[] data= { *new*Person("用户1" ,1), *new*Person("用户2" , 2), *new*Person("用户3" , 3), *new*Person("用户4" , 4), *new*Person("用户5" , 5), *new*Person("用户6" , 6), *new*Person("用户7" , 7), *new*Person("用户8" , 8), *new*Person("用户9" , 9), *new*Person("用户10" , 10) }; *public**static*** Collection generateCollection(){ *return*Arrays.asList(data); }}

我们的DataSource提供了一个包含10个Person类型的JavaBean。使用JavaBean作为DataSource的特点是，它的字段必须通过getter方法暴露在外面，意思是如果我们的JavaBean有一个getXyz方法，那么xyz就是一条记录的field，在我们的例子中我们的是name和age。创建一个新的创建文件，然后添加两个名为name和age的字段：

接下来把这两个字段拖到报表detail当中。

将前面我们做的两个类添加到iReport中的classpath当中。添加一个JavaBean set data source，名为TestBeanDataSource，并将其设置为“active”，如下图：

启动生成报表效果如下：

9.5、JREmptyDataSource

在JasperReports中提供了一个名为JREmptyDataSource特殊的DataSource，这个DataSource是当我们点击 按钮生成报表时调用。这个DataSource的next方法会根据记录的数量返回true，同时每次调用getFieldValue方法时总是返回null值。这种操作有些类似于一些记录没有字段一样，这就是一个空的DataSource。

该项类有两个构造方法：

Public JREmptyDataSource(int count)

Public JREmptyDataSource()

第一个构造方法让我们告诉这个DataSource该返回多少条记录，第二个构造方法会把记录的总数设置为1。

当我们点击按钮生成报表时，我们可以按住shift键来设置报表里产生的空记录数。如下图：

9.6、HQL查询和Hibernate连接

从jasperreports1.2版开始，Jasperreports提供了一种直接使用HQL(Hibernate Query Language)来创建报表。要使用这个功能，首先我们需要设置一个Hibernate connection。把所有的JAVA编译好的类，jar包和使用Hibernate mapping的配置文件放在classpath里。换句话说，iReport必须要保证可以访问所有的你需要使用的*.hbm.xml文件。

把这些对象添加到classpath中的方法是，选择主菜单中的ToolsàClasspath，在弹出的窗口中设置你需要加入到classpath中的对象。

接下来我们需要打开DataSource对话框，点击“New”新建一个DataSource，不过这时我们选择Hibernate connection作为我们的DataSource类别。点击“Next”输入connection的名称。再次点击“Next”进入下上步设置，如下图：

在点击“test”按钮时要保证hibernate.cfg.xml在你的classpath里。

同时设置这个“test hibernate”为active状态。此时iReport仅使用Hibernate Configuration工作。

从主菜单中的ViewàReport query里打开查询窗口，在Query language里我们选择Hibernate QueryLanguage(HQL)，然后输入相应的HQL,接下来的工作就像使用SQL一样啦。

9.7、如何实现一个新的JR数据源

有时使用Jasperreports所内置的JRDataSource不能完全满足我们的要求。此时我们可能需要写一个自己的新的JRDataSource。自定义一个JRDataSource并不复杂，事实上创建一个自定义的JRDataSource就是实现JRDataSource接口类，重写里面的next和getFieldValue方法就OK啦。

Package net.sf.jasperreports.enginePublic interface JRDataSource{Public Boolean next() throws JRException;Public Object getFieldValue(JRField jrField) throws JRException;}

这里的next方法是用来把记录移动到下一条，同时判断还有没有记录。如果返回true表示还有记录可用，否则表示没有可用记录了。

当next方法调用时，getFieldValue方法将会返回请求字段的值(如果请求的字段没找到或不存在，那么将返回null)。一般来说，请求字段名会作为参数包含在JRField对象里。JRField是一个接口对象，通过它我们可以得到三种信息：字段名称，描述，和字段类型。

接下来我们就来写一个我们自己的DataSource。我们的这个DataSource要实现对一个目录进行浏览并返回里面的文件或文件夹。DataSource的field有以下几方面：文件名（fileName），一个标志位（isDir）用来表示它是一个文件还是一个文件夹，文件大小(size)。

我们的DataSource有两个构造方法，一个构造方法有一个参数可以用来接收要扫描目录；一个就是没有参数的构造方法（那么将采用默认的目录进行扫描）。

我们这个DataSource将会根据指定的目录查询文件和文件夹，并且以一个文件数组的形提供出来。

test;java.io.File;net.sf.jasperreports.engine.JRDataSource;net.sf.jasperreports.engine.JRException;net.sf.jasperreports.engine.JRField;JRFileSystemDataSource JRDataSource{File[] fileArray;index=-1;JRFileSystemDataSource(String path){ File f= File(path); (f.exists() && f.isDirectory()){ fileArray=f.listFiles(); }}JRFileSystemDataSource(){ (".");}Object getFieldValue(JRField arg0) JRException { File f=fileArray[index]; (f==) ; (arg0.getName().equals("fileName")){ f.getName(); } (arg0.getName().equals("isDir")){ Boolean(f.isDirectory()); } (arg0.getName().equals("size")){ Long(f.length()); }{ ; }}next() JRException { flag=; index++; (fileArray!= && index

到这里我们自定义的一个JRDataSource已经完成了，接下来我们将会来解释如何在报表中使用我们自己的的DataSource。

为了使用这个DataSource，接下来我们需要编写一个JavaBean set DataSource，这个和我们前面写过的很像，代码如下：

test;net.sf.jasperreports.engine.JRDataSource;TestFileSystemDataSource {JRDataSource getFileSystemData(){ JRFileSystemDataSource("d:/doc");}}

这个类中的static方法将会被调用，执行并产生一个新的JRFileSystemDataSource对象，同时指定该对象里的文件夹路径为“d:/doc”目录。

接下来我们可以新建一个connection，创建时我们选择“Custom JRDataSource”类型，并设置它的名称为“Test FileSystemDataSource”，如下图：

接下来我们需要在页面中新建三个field，分别是fileName(String),isDir(Boolean),size(Long)，并将他们拖到报表的detail band中，如下图：

运行报表，生成效果如下：

对于这种生成的格式，为了美观期间我们可以对其进行格式化。把“目录/文件”拿掉，通过在“文件名”列前面加图片的方式来显示该文件是文件还是文件夹。

在detail里，在fileName列前加一个image对象，并在其Expression里加上如下代码：

($F{isDir}.booleanValue()?"D:\iReport-2.0.1\report test\folder.gif":"D:\iReport-2.0.1\report test\file.gif")

该句话的含义是：如果isDir返回的为true则输入文件夹图片，否则输入文件图片，如下图：

设置报表的列数为2，报表排版如下：

启动报表，生成的效果如下：

十、国际化

国际化意味着报表可以根据不同的地区显示不同的语言文字。报表所要显示的不同的语言文字是存储在资源文件里。在本章中我们将介绍怎样使用内置函数msg()来处理国际化问题。

10.1、资源文件

当我们想让一个报表实现国际化功能时，我们需要定位所资源文件里的名称字符串，就是label或者叫key，key与value是一对字符串，中间用“=”连接。如：

Title_username=用户名Title_phone=电话号码

保存这些key与value对的文件以“.properties”为后缀。在运行期间，报表引擎将会在classpath里查找以“.properties”结尾的资源文件。如果文件找到了，那么就从文件里读取相应的资源信息。资源文件的指定是通过报表属性窗口的“i18n”来实现的。

一般来说，一个资源文件名的组成包括三个部分：一个是资源文件名，一个是国家地区代码（与文件名之间以“_”连接），最后就是文件的扩展名“.properties”。对于默认的资源文件名来说是没有国家地区代码的。完整的资源文件的格式如下：

[_language code[_country code[_other code]]].properties

比如：

I18nReport_fr_CA_UNIX.propertiesI18nReport_zh_CN.propertiesI18nReport_en.propertiesI18nReport.properties

前面格式里提到的“other code”（比如上面的“_UNIX”）一般不去指定它。

在iReport中，它有能力自己去管理资源文件，资源文件我们需要把它和报表文件(jrxml文件)放在同一目录，并且资源文件的名称也要与报表文件的名称保持一致。

我们可以从主菜单的“EditàInternationalication”的“Localization files”打开资源文件管理窗口。如下图：

我们可以通过“Create New Locale”按钮创建一个新的资源文件。

创建时我们需要指定文件名及国家代码，创建完成之后我可以通过“Modify file”按钮来对资源文件的内容做相应的修改。

10.2、获取本地化字符串

得到资源文件里的key所对应的vlaue我们可以通过下面的方法实现：一种是使用JasperReports内部的表达式str(“key name”)，或者是使用表达式$R{keyname}：

$R{test.name}

在JasperReport中的国际化我们可以使用函数msg，通过使用msg函数我们可以对取到的国际化的值做相应的格式化处理。比如我们的资源文件中一个key/value对为：

title=my name is {0}

此时我们需要为{0}指定具体的值，通过使用msg函数我们可以对这里的{0}进行填值处理：

msg($R{title},"gaojie")

这样在报表生成后最终的值就是：my name is gaojie

我们有三种方式来使用msg函数：

Public String msg(String pattern,Object arg0)Public String msg(String pattern,Object arg0, Object arg1)Public String msg(String pattern,Object arg0, Object arg1, Object arg2)

在iReport中我们可以指定所在地区，这样我们就可以控制显示的语言。点击主菜单“Buildàset report local or BuildàSet time zone”，在弹出的窗口中我们可以对地区做相应的修改。

十一、脚本

Scriptlet是一个java class用来在报表生成的时候执行特定的动作(比如新页开始的时候或者处理结束的时候)。在本章当中我们将要看如何写一个简单的Scriptlet以及如何在报表里使用它们。

11.1、JRAbstractScriptlet

要写一个scriptlet我们只需扩展java类net.sf.jaspererports.engine.JRAbstractScriptlet。在该类中可以触发报表生成的时候，数据产生的时候的事件，同时我们可以访问报表中的所有的variables,fields,parameters。

最简单的scriptlet实现类是jasperreports提供的JRDefaultScriptlet：

*package net.sf.jasperreports.engine;**public class JRDefaultScriptlet extends JRAbstractScriptlet**{**public JRDefaultScriptlet() { }**public void beforeReportInit() throws JRScriptletException**{}**public void afterReportInit() throws JRScriptletException**{}**public void beforePageInit() throws JRScriptletException**{}**public void afterPageInit() throws JRScriptletException**{}**public void beforeColumnInit() throws JRScriptletException**{}**public void afterColumnInit() throws JRScriptletException**{}**public void beforeGroupInit(String groupName) throws**JRScriptletException**{}**public void afterGroupInit(String groupName) throws**JRScriptletException**{}**public void beforeDetailEval() throws JRScriptletException**{}**public void afterDetailEval() throws JRScriptletException**{}*

就像我们看到的那样，该是一系列的after和before组成的方法，这些方法代表着不同类型事件的触发。

在Scriptlet内部我们可以使用下面的Map得到所有的fields,variables和parameters,这些Map是：fieldsMap,variablesMap和ParametersMap。

十二、模板

在iReport 中最有用的工具之一是使用向导利用templates来创建报表，在本章里我们将解释如何创建一个自定义的templates,如何把它们添加到我们的模版库里。

12.1、模板结构

一个模版文件就是一个普通的jrxml文件。当使用向导创建一个新报表时，选择的模版文件将会被加载，同时会对用户输入地方做相应修改。

有两种类型的模版：columnar 和tabular。columnar是一种用一个静态的text显示field name，同时用一个textfields显示field的值的竖排的记录报表。

而Tabular类型将会像下图这样显示所有记录

模版是一些放在iReport安装目录下templates目录里的jrxml文件。iReport根据文件的名称来决定它是columnar类型还是tabular类型的模版。如果文件名以Ｔ结尾，那么它将作为一个tabular类型的模版。如果它是以Ｃ结尾的话它将会被做为columnar类型模版。下面是iReport提供的模版列表：

我们打开classicC.xml文件，查看之后我们可以明白一个模版的结构。在这个文件里你可以发现四个组：group1,group2,group3,group4，title band和group footer可见，columns band不可见（因为对于columnar 类型的报表columns band没有用）。在detail band里有一些为将来每一个field准备的静态的text label作为模版的label，textfield是一个真正的field。在particular里每一个group可以通过n包含一个图形元素和一些静态text元素：

GnLabel

这里的n代表group的编号，textfield元素包含下面指定的表达式：

GnField

这个元素将包含使用group表达式的值。

Detail部分至少要包含像下面一样的一个静态文本：

DetailLabel

同时一个textfield元素用下面的表达式：

DetailField

其它的bands可以包含任何元素。在这些bands中将会在使用模版时生成。

表格类型的报表模版的设计和上面很相似，图13.4是classicT.xml在窗口里显示时的情形。

同样，有四个group，在它们之前有一个column header，它需插入一个静态的字符串作为columns labels。

在detail band区域，仅仅只有一个DetailField元素将被作为所有列的一个列名标签。

模版是不能编译的，这是因为在textfield里包含的表达式不是一个合法的java表达式。

12.2 使用自定义模板

下面我们就来看一下怎么创建和使用一个模版。最简单的方法是打开一个已经存在的模版，选择一个最接近我们想要的模版的类型，然后按我们想要的对其进行修改，对存在的元素进行修改、添加新的元素或者删除不需要的元素。

为了使用模版，我们必须把改好的模版导入到templates目录里。记住使用.xml作为扩展名，例子中我们命名为mytemplateT.xml。添加C或T字母到模版的扩展名之前表示模版的类别。

以上工作完成后，我们可以通过向导来创建一个新的报表。在模版选择处我们可以看到新的我们刚才添加的报表模版在模版列表当中。

这里,你应该可以看到我们自定义的模版没有预览图可用,要想让我们自定义的模版关联到一个预览图可以在templates文件夹里放上一个150x150的gif图片，并重启iReport。(在这个例子当中我们用的图片名叫: mytemplateT.gif).

图中显示了在向导窗口中当我们选择我们自定义的模版时出现的预览图。

使用模版可以帮助我们提高开发报表的效率。通过使用我们自己的模版，我们创建的报表生成的效果如下：

12.3 将模板放置在jar文件中 (Put templates injar files)

我们知道模版文件都是放置在模版目录里面的。这样的话当iReport访问远程文件系统时可能会带来一个问题，当发展到0.5版本的时候我们可以把模版文件放到jar包里去，每一个jar可以包含一个或多个模版和一个在ireport目录下的名为template.xml的模版描述文件。当报表向导执行时，iReport将要查找所有的在classpath下的可用的名为/ireport/templates.xml文件。

为了了解如何使用一个jar提供一个模版，我们来创建一个基于名为Classic TemplateResource模版的例子。

Template.xml的内容如下：

Template.xml定义了一个模版的集合，每一个模版我们都可以定义它的名字，类型（columnar或者Tabular），和图标。

这个jrxml和图标用“/”开始指定，我们jar里的内部目录树可能类似于下面这种。

template_sample.jar

├───ireport

├───it

│ └───businesslogic

│ └───ireport

│ └───templates

└───META-INF

Template.xml将要被放到ireport目录下，同时所有的其它文件（如这个例子中的 classic.xmlt和classic.gif）将会被放到/it/businesslogic/ireport/templates目录下。

把创建好的jar放到classpath里，这时即使在模版目录里没有它我们也可以使用啦。

十三、图表

iReport很多的图表(Chart)类型可提供使用。iReport现在支持Pie,Pie 3D,Bar,Bar 3D,XY Bar,Stacked Bar,Stacked Bar 3D,Line,XYLine,Area,XY Area,Scatter Plot,Bubble,Time Series,High Low Open Close和Candlestick 多种类型图表。

iReport使用jfreechart作为其图表引擎，jfreechart是一个强大的chart 生成工具。

创建chart的机制是建立在dataset的概念之上的，这就使得数据的管理和对更多复杂图表类型如High Low 之类实现可视化。

13.1、第一个图表

在这一章节里我们将来学习如何使用chart 工具一步一步在一个报表里创建一个Pie3D的chart。在这个例子中我们将使用doradosample里的数据库作为数据源。

建立一个空白的文档，点击打开查询窗口并且写下如下查询语句：

select employee_department,count(*) count fromtb_employee group by employee_department

报表的查询窗口

这里我们想生成一个chart用来显示根据学历员工数目。点击OK确认，iReport将注册查询得到的fields。同时把这些fields从objects library里拖出放入detail的band里。

选择chart tool 在summary里放置一个新的chart。

从charts窗口里我们选择pie3D图标并按OK按钮。

要配置chart，双击chart打开属性窗口，同时你可以通过右键菜单的方式打开chart的属性窗口。

点击“Edit chart properties”按钮出现的chart属性窗口。

这个窗口包含两个标签：“Chart properties”和“Chart Data”。第一个标签包含控件的parameters列表；第二个标签是用来决定和当前图片关联的数据。修改图形的不同样式，设置背景的alpha和前景的alpha为0.5和depth factor(深度因子)为0.2。

下一步定义和图形关联的data。切换到“Chart Data”标签。

在“Type of dataset”列表框中允许你指定一个dataset用来生成图形。在“dataset”标签里你可以在报表的上下文里指定一个dataset。Reset type和Reset group 允许你对dataset进行重置。

为了我们的需要，我们设置Reset type 为“Report”。当我们不想数据被重置时。同时我们设置Increment type 为None，这样每一条记录都将被附加到我们的dataset里。

在Detail标签里允许你键入一个表达式和每一个在datasource里单独的值关联。针对Pie 图表类型，有三个表达式需要我们输入：Key,Value和Label。

表达式Key允许你标识Pie图里的一块。如果Key的值出现重复，那么Label和Value的值会关联起来用来覆盖Key的值。一个Key值不能为null。Value的表达式值指定这个Key的数字值。

Label表达式的值允许你为并图中每一块指定一个标签。这个表达式的值是可选的，同时默认值为“=”，例如:“A=100”，Ａ是并图中一个块的Key同时100是它的值。

确认对chart的修改，保存文件并且点击 按钮启动报表。在图14.9里我们可以看到最后的效果。

13.2、数据集

当报表生成的时候，chart会去收集数据然后存储在相关的dataset里。Dataset类型有：

Pie

Category

Time period

Time series

XY

XYZ

High-Low

可以把dataset想成是一个表格，每一个dataset都有不同的列（fields）。当一条新记录插入到dataset里时值将会被添加到fields里。

13.3、 图表属性

我们可以通过图显示的窗口来管理chart的外观。在这个窗口里你可以查看并编辑charts和graphs的通用属性（如title，图例等）。

你可以使用表达式编辑框来更改Chart title 和Chart subtitle表达式

JasperReports只是利用了JFreeChart图表库的一小部分功能。如果你想自定义一个图表你可以写一个实现下面的接口的类：

Net.sf.jasperreports.engine.JRChartCustomizer

从这个接口中我们只需要实现一个方法：

Public void customize(JFreeChart chart,JRChartjasperChart);

在这个方法里用JFreeChart和JRChart作为它的参数。JFreeChart作为第一个参数通常是用来产生图片的，第二个参数包含用户在设计阶段一些参数。

十四、子数据集

报表的生成是基于一个data source(一个查询，一个java 的collection或者一个xml)。当你想要处理一个chart或一个crosstab时，这时可能上面的data source就不行了。一个subdataset 可用来在报表里提供另外一种记录集。你可能会使用一个subdataset用来填充一个chart或一个crosstab。在一个报表里你可以有任意多个subdatasets。

一个subdataset可以有它自己的fields,variables,parameters，同时如果需要它还可以执行一个查询。Dataset里的记录可以像主报表一样进行一次或多次分组。在组里可以使用subdataset的variables。一个subdataset通过一个叫“dataset run”的选项和一个chart或一个crosstab关联。

14.1 创建一个数据集 (Creating a subdataset)

要创建一个新的subdataset，可以在工程library里右键选择“add-sub dataset”方式完成。

Subdataset的创建窗口打开。

这里你需要设置subdataset的名称，同时你也可以使用该subdataset合适的“when resource missing type”指定一个resourcebundle（查看关于资源文件的国际化章节）。

Jasperreports允许使用scriptlet在一个subdataset的records里执行一个特殊的计算。如果你需要你可以指定一个你的scriptlet类的名称。点击“create”按钮把这个subdataset添加到报表当中。

你可以在library标签里或者在subdataset列表对话框里查看刚才新建的subdataset (主菜单中Edit->sub dataset)

你可以使用和在主报表中相同的方法添加fields,variables和parametres到你的subdataset里。 Subdataset窗口里的“Query”按钮可以打开查询工具用来指定一个查询（像在主报表里一样），你可以用一个查询或一个其它的数据源（如javabean等）来反向得到字段。

14.2 运行数据集 (Dataset runs)

你可以在一个chart里或一个crosstab里使用subdataset。JasperReports 需要一些扩展信息诸如jdbc connection执行sql 查询或者为一个指定的subdataset的parameter用来填充dataset。所有这些信息的提供者是一个dataset run。

Dataset 的工作方式与在主报表中引用一个SubReport类似。你可以使用表达式（里面可以包含主报表里的对象，如：fields,variables,parameters）为指定的subdataset的parameters设置值。在启动运行时可以定义一个parameters Map来为subdataset parameters填充值，同时还可以定义一个连接或一个datasource在subdataset获取数据时使用。

*实例*

在这个例子中我们将演示如何使用一个subdataset去填充一个chart。

在主报表中只有一条统计所有记录总数的记录(Select count(*) fromhelp_category)

第一步，创建一个新的空白报表

第二步，打开查询工具（ ）同时插入下面的sql语句:

Select count(*) from help_category

第三步，从library 标签里拖动字段employeeCount到detail band如下图添加一个labels

第四步，创建subdataset

在library里右键选择弹出菜单选择Add->sub Dataset，我们创建一个名为subdataset1的subdataset。

第五步，在subdataset的对话框里点击“Query”按钮，我们键入如下语句：

select parent_category_id, count(*) as empCount fromhelp_category group by parent_category_id

第六步，添加pie3d chart到报表里

第七步，编辑chart属性

打开chart属性编辑窗口我们来编辑一下chart的相关数据，选择subdataset1作为它的subdataset。切换到“Connection/Datasource exp”标签同时从下拉框里选择“useconnection expression”。这里我们使用主报表里的connection来填充subdataset($P{REPORT_CONNECTION}) 。

第八步，设置Pie Dataset的属性

切换到“Detail”标签，我们输入下面的表达式：

Key expression: $F{DEGREE}

Value expression : $F{EMPCOUNT}

Label expression : $F{DEGREE}

第九步，保存并启动报表

第十步，报表制作完成

十六、交叉表

一个CrossTabs是一种在设计的时候既不确定行数和也不确定列数的一种表格，在运行环境下它会像下面显示的不同年份的一个销售报表一样。

CrossTabs在jasperresports中从1.1.0版本时开始提供，同时iReport也从1.1.0开始支持CrossTabs。

Jasperreports的CrossTabs工具允许对行和列的数据进行分组、汇总和自定义每一个cell里的内容。填充CrossTab的数据可以来自主报表里的dataset或来自subDataset。使用iReport里提供的向导我们可以简单快速的创建功能强大的交叉报表组件。

一个CrossTabs本质上是一个表格，行和列的数量取决于填充这个表格的数据。行和列也可以在groups里做聚合操作。对于每一个行或列的group我们都可以得到一个细节信息和一个可选的行列数据的汇总。

16.1、交叉表向导 (Crosstab wizard)

为了说明怎么让一个crosstab工作起来，我们将使用向导创建一个crosstab，当我们在工具条里选择crosstab元素并将其添加到报表中时crosstab的向导会自动启动。

还是以DoradoSample里提供的hsql数据里的employee报为例，我们使用包含下面查询语句的空报表开始:

Select * from employee

我们把crosstab放在报表的底部:summary band

在第一步里我们需要选择一个dataset来填充crosstab，我们这里使用主报表里提供的dataset，点击下一步继续。

在第二步里我们需要定义至少一个行分组.我们这里选择对所有记录使用DEPT_ID进行分组。这样就意味着crosstab的每一行将会采用一个明确的部门编号，这样JasperReports将会使用部门编号对数据集里的数据进行重新整理计算。使用向导，我们可以定义两个行分组，这是使用向导的局限性所在，事实上，如果你需要的话你可以通过Crosstab的属性设置窗口定义若干个行和列的分组。点击下一步继续。

和定义行分组一样，从这里我们可以定义两个列分组，这里我们仅使用一个列分组，使用数据中的DEGREE字段对数据进行分组。该字段的含义是学历，这就表示，我们要做的这个交叉报表是用来计算不同部门员工在学历方面的人数分布情况。

是时候定义detail 数据了，一般的，这个detail是使用类似根据country,year得到orders总数或者是相同组合的物品总数的一个聚合函数的计算出来的结果值。我们这里选择打印员工的数量（Detail field:ordered,function:count）。点击下一步继续。

最后一步我们可以为crosstab的布局设定一个布局。我们可以设置是否能看到表格线、或者是否包括行和列总数统计之类。我们这里全部选择。

点击finish

注意当一个crosstab添加到一个报表中后，会自动在设计窗口中添加一个用来编辑当前crosstab的tab页窗口。

当点击crosstab的tab页，两个新的属性窗口将会被添加在窗口的左边和右边：一个crosstab的结构树，用来显示crosstab的当前选中单元格和帮助相关信息。一个是crossstab对象列表用来显示和该CrossTab相关的一些variables或fields等。

当点击工具条上的启动按钮后，我们将可以看到引擎生成的如下效果的报表：

最后一列包含每一行交叉所有列的总计，最后一行包含每一列交叉所有行的总计。

16.2、列，行，单元格 (Columns,rows,cells)

一个crosstab至少必须有一个行分组和一个列分组，每一个行和列的分组都有一个可选的行/列的统计。

下面图中所示的是一个基本的由一个行列分组构成的crosstab。

当再次添加一个行分组时，这个crosstab 将会显示出如下效果：

16.2.1、行和列 (Rows and columns)

一个行或列的分组可能通过crosstab的属性窗口来对它进行修改(在crosstab编辑器右键菜单里选择Crosstab properties)。

点击“row and column groups”的标签页。在这里我们可以看到已经定义好的行或列的分组。

添加一个新的分组请点击名为Add的按钮。

所有分组必须有一个唯一的名称。当你添加或修改一个行分组时，你可以设置rowgroup header的宽度。

“bucket”是分组的标准，它通过一个java类来定义。在一个bucket表达式里，你可以使用主报表里所有的fields/variables/parameters。但是，如果你选择使用subdataset来填充crosstab，那么必须使用subdataset里提供的fields/variables/parameters。

一个header的单元格增长依赖于它所跨越的行数。你可以选择多个元素放置在header里。

最后，你可以选择是否打印出总计的结果。这些选项是：

None : 没有总计行被打印

Start : 总计行打印在detail行之前

End : 总计行打印在detail行之后

创建column的group 是非常简单的。定义column group 时你可以定义column的高度来替代行高（看下图）

Column group height

当Bucket在行分组里时，header的单元格内容的定位相似。但是在这个用例中， details可以改变header宽度而不是高度。

再一次，如果打印总计列的话，你可以做一些选择。各选项如下：

None : 没有总计列被打印

Start : 总计列在detail列之前打印

End : 总计列在detail列之后打印

列和行的高度可以很容易的在crosstab编辑器里通过鼠标拖曳表格线的方式改变。

当一个行或列添加到crosstab里时，一个特殊的用来引用bucket表达式的变量将要被创建。它和新的group有相同的名称。你可以从crosstab objects 标签里通过查找绿色小点的方式来定位这个bucket variable。

iReport为group创建新的header cells是很简单的，这个操作不需要添加任何新的额外元素到crosstab里。你可以根据你的喜好来填充cells，最好的方式是通过拖曳把bucket从crosstab objects列表拖到新的单元格里。

在上图中，你可以看到加在一个新加的嵌套在column group里四个新添加到crosstab里的单元格,group header单元格，group total header单元格。

你可以使用”up”和”down”按钮来更改你的group的嵌套顺序。

下图中所示的crosstab就是在图16.14在SEX的group被向上移后的效果。

图16.16 MONTH group向上移后的效果

16.2.2、单元格 (cells)

每一个行和列的交叉处定义一个单元格，我们有header单元格，total单元格，detail单元格和一个可选的“when-no-data”单元格。单元格可以包含一个类似于textfields,statictexts,rectangle,images之类元素的集合，但是他们不能包含一个SubReport, 一个chart,或者一个crosstab。

你可以去修改每一个单元格的背景色和单元格的borders：移动鼠标在一个单元格上并且按右键在弹出的菜单中选择“cellproperties”打开单元格属性编辑窗口。

从这个对话框中你可以修改单元格的外观。

16.2.3、特殊单元格 (Special cells)

如果一个crosstab不能包含一些数据，你可以选择打印别的东西来替代。例如，你可以包含一条消息，方法是，你必须编辑“when-no-data”单元格。在crosstab上右键勾选弹出菜单中的“when-no-data default cell”复选框。这个操作完成后将会出现一种很明显的编辑模式,你可以操作“when-no-data”单元格的内容。

“when-no-data”单元格和crosstab元素有相同的尺寸。如果没有数据展示的话它将替代crosstab打印。单元格橙色的边框标志出你可以编辑的单元格区域。可以在这个单元格里添加一个或多个元素。

在一个crosstab里，所有的元素关联一个单元格，如果一个元素在单元格外面或部分在单元格外面，这是不正确的放置方式并且当编译的时候jasperreports将会抛出异常。iReport在界面中标识这个错误会以红色的框显示。

16.2.4、度量 (Measures)

在crosstab里每一个元素的表达式（如textfield 表达式）可以包含唯一的measure。在这种情况下，你可以直接使用fields,variables或parameters。

一个measure和variable一样是一个对象。要建立一个measure，请打开crosstab属性窗口(在crosstab编辑器上右击，选择crosstabproperties)并且到measure标签页。

点击Add按钮，创建一个新的measure。Measure的属性窗口将显示，你最少应该去设置它的name,class type和expression。在measure里你可以使用fields,variable和parameters

一个measure可以存储一个来自你代码中的实际的值（将calculation type设为nothing）或者一个类似于用count,sum等计算出来的值。

对于每一个measure 你可以提供一个自定义的incrementer类（一个继承自

net.sf.jasperreports.engine.fil.JRIncrementerFactory

的类）去实现特定的increment 方法。

这里的“percentage of”选项允许你选择表现变量最终值的百分比。

你可以提供一个特殊类来计算百分比的值，此时这个类必须实现net.sf.jasperreports.crosstabs.fill.JRPercentageCalculator接口。

16.2.5、Crosstab element properties

在主设计窗口中双击crosstab元素将打开element properties窗口，点击crosstab标签。

Repeat column headers : 如果勾选，当crosstab完全添加到页面中时列的header将会被重复打印。

Repeat row headers : 如果勾选，当crosstab完全添加到页面中时这个行headers将会被重复打印。

Column break offset : 当crosstab超过页面宽度时它指定上一块的数据与下一块之间的空白间隔。

16.2.6、交叉表参数 (Crosstab parameters)

你可以使用元素属性窗口里的crosstab parameter表格建立一个crosstab parameter并且设置一个crosstab的parameter同时为其设置一个默认的表达式（图16.22），要添加一个parameter,请点击Add按钮，这个crosstab parameter 窗口将会出现。

对于一个parameter，你必须为其指定name,class type，同时你还可以为其指定一个可选的可以包含主报表中任意一个fields,variable,parameters的表达式。

警告：使用dataset的过滤查询，你必须用定义在crosstab properties窗口里的dataset 启动parameters，不能用crosstab里的parameters.

你可以在crosstab objects窗口里看到crosstab parameters的列表，他们用红色的点标记出来。

你可以在启动时用一个MAP来设置crosstab parameters里声明的值。在这个用例中，你需要在element properties窗口里提供一个合法的parameter mapexpression。

16.2.7、交叉表数据 (Crosstab data)

你可以用主报表或一个subdataset来填充一个crosstab。在后面的例子中，在crosstab properties窗口“crosstab data”标签里你必须指定要启动的dataset。

如果你的数据是pre-sorted.你可以勾选“Data is presorted”的checkbox以使得填充数据的处理速度加快。

Reset type/group和increment type/group选项可以用来定义当集合类型的数据需要重置并且当添加一条记录到你的dataset。

关于怎么设置dataset的启动参数请参考subdataset的相关章节。

16.2.8、交叉表合计变量 (crosstab total variables)

Crosstab variables 是内置的对象，可以结合数据在不同的聚合水平使用在crosstab textfield的表达式里。

对于每一个尺寸，jasperreports创建variables根据每一行或列存储measure的合计值。

下面的例子是一个用来显示不同学历不同部门的员工数的报表.

十七、其他内容

1、常规问题解决方案

这章我们将处理一些我们在使用iReport和JasperReport过程中遇到的常见问题。他们是iReport论坛上常见的问题，但JasperReport官方文档也没有清楚的解决方案的。

打印百分比

经常需要在报表上显示一个字段的值和与这个值有关的百分比。考虑表1中的这几行。

表格1

这个例子的百分比插入在C列，它表示B列中的值所占的百分数。用以下公式计算得出：

C = (ΣB*100) / B (1)

ΣB =所有B列的值的和

尽管这个公式看起来很容易就算出了百分比，但公式（1）不适合在JasperReports中计算。这是因为公式使用的值是无效的在公式被使用时；具体来说ΣB是获得报表最后的值，就是当所有的记录被处理以后。然而，你要使用的B的值仅仅在计算(1)记录结果时。这儿没有简单的方案为这个问题。唯一的计算总数的方式就需要最终的百分比（先前例子中的ΣB ）。当你预先计算你需要的值，你可以将它作为参数传递给报表。公式（1）就将变为：

new Double(($P{TOTAL_OF_B}.doubleValue()*100)/$F{B}.doubleValue())

TOTAL_OF_B代表包含你计算的值的参数

计算组的发生数

每个组在JasperReports中和一个表达式关联。在报表生成期间，表达式的值一改变，一个新组开始发生一些事情。有时必须计算组的数量（计算组的值改变了多少次）。照这样做，需要一个变量：我们将命名为GRP_COUNT；基本思路就是仅仅当变量_COUNT等于0时增加变量。_COUNT是一个JasperReports的内置变量，它包含当前组**的记录数目。自一个任意组的变量_COUNT等于0仅仅一次，GRP_COUNT将正确包含组出现的次数。

图16.1

图16.1中的例子用到的查询：

“select * fromcustomers order by country” 和COUNTRY组的表达式：$F{COUNTRY}.

声明变量GRP_COUNT ：

Class: java.lang.Integer

Calculation type: Count

Reset type: Report

Variable expression: (($V{COUNTRY_COUNT}.intValue()== 0) ? "" : null)

这个表达式是说：如果你计算当前组的实例的第一条记录（记录号为0），然后返回一些非空的东西，也返回null值。自我们选择count作为计算类型，

变量GRP_COUNT将增加仅仅当表达式的值非空时，就说当当前组的第一条记录被计算时。

图16.2

显示这个值到textfield，你设置元素表达式的赋值时间到这个组来计算发生次数，在我们的例子中使用COUNTRY组（图16.3）。

图16.3

图16.4

图16.4可以看到打印结果。在空白框中显示了组号。

如果evaluation time设置到“Report”, 组发生的总次数就将被打印出来。

分离detail

有时需要将detail分开成更多的bands。主要是为了在一些情形发生时在一个指定的detail band中用另一个来替代。这些情形必须用band PrintWhen Expression 测试过。可能有任意数量的detailbands创建新组，这些新组用一个组表达式，这个表达式在每条记录后改变值。你可以用来作为记录的关键字段表达式或一个计算变量。使用这种方式，此外在detail band中，你将有每条记录的group header和group footer，不能用同样的方式使用这个detail band。

图16.5可以看到报表的设计，detailband被隐藏到一对新组的header bands的剩余空间，这个使用一样的组表达式：这条记录关键字。

选择选项为第一组，我们能一页打印一条记录。

图16.5

插入一个页

JasperReports不提供任何方法来插入一个页和band合用。意思就是说你在一个页上呈现多个detail。下面的例子中将分detail在两页上：第一页我们想显示客户的名字的代码，第二页打印客户地址。

完成这个例子，我们将打印每条记录在一个新页上：这种方式是我们期望在一页上有一条记录在两页的内容。

让我们一步一步来，首先我们将创建一个组在一个空白报表上，我们指定组的表达式$V{REPORT_COUNT}和检查组标“Start on a new page”：我们用这种方式得到每条记录的在同一页上。现在我们去分开detail。接下来我们使用一个没有任何连接和datasource（我们设置子报表的连接属性为“Don’t use connection or datasource”)的子报表。准备创建这个子报表通过一个简单空白文档，且设置margins为0。

图16.6

也设置所有的bands的高为0（title band和summary band除外）。在我们用做子报表的报表属性选择选项“Title on a new page”和设置“When no data”值为AllSectionNoDetail。

所有来自与主报表字段的值将作为参数传递；所以我们声明所有需要的参数。我们例子中需要四个字段：

- CUSTOMERID

- COMPANYNAME

- CITY

- REGION

那么放所有你需要的textfields到报表中。请注意所有插入到title band中的元素被打印在第一页，另外，放在summary band中的字段将在第二页被打印。返回到主报表，将字报表插入到detail band中。

我们填充子报表参数用正确的表达市在主报表中（更准确的说，我们填充子报表参数表在“Subreport(Other)”选项卡，查看图16.8）。

编译主报表和子报表并运行打印，如果一切ok，将看到类似图16.9的结果。

交叉报表

JasperReports不支持交叉报表，指报表的行和列都变化的报表。

以下表格是一个交叉报表的记录，显示了所有有效年代的生产记录：

年代不可预言的，取决与取到的数据。

这种情形，最常用的方法为这种报表就是去固定一个列的最小号显示，手动填充一个datasource（例如JRJavaBeanArrayDataSource）来组织每行的值。这种方式我们很难想象到将出现的数据。

如果供应许多的列比你需要的（例如，报表能显示后5年的信息，但是你仅仅有前3前的信息），你的工作就是加一个假值做为字段值替代null或空白字符或短字符（-）。

使用多重连接找回数据

有时你需要重新找回更多的数据比在单独一个datasource，在同一时间。去达到这个，解决方案依赖你严密的想法。通常执行多个问题的方法就是使用子报表。此时你可以说点什么关于我们必须连接子报表，你能设置不同的表达式为每个子报表。你可以使用两个连接中的一个作为参数传递给报表。

如果不能分别找回数据通过不同的datasource用子报表，你得实现一个“lookup”方法，就像用一个静态类，或者添加它到报表脚本中。Lookup方法可以重新找回数据从任意的datasource。

以下的例子表现了一个简单的lookup类。用这个类去解码一个国家的名字给一个国家的代码。这个方法被传递一个已经打开的JDBC连接和代码作为参数去解码

Public class LookUp {

public static String (java.sql.Connectioncon, int code)

{

java.sql.Statement stmt = null;

java.sql.ResultSet rs = null;

try {

stmt = con.createStatement();

rs = stmt.executeQuery(

"select STATE_NAME from STATES wherecode=" + code );

if (rs.next())

{

return rs.getString(1);

}

return "#not found!";

} catch (Exception ex)

{

return "#error";

} finally {

if (rs != null)

try { rs.close(); }

catch (Exception ex2) {}

if (stmt != null)

try { stmt.close(); }

catch (Exception ex2) {}

}

}

}

调用这个方法，传递作为不同数据连接，你可以得到你想要的数据从不同的数据库。

如何使用存储过程

JasperReports不支持使用存储过程来找回数据去打印。为避免这个局限性，你可以在运行报表之前执行存储过程。

重新找回数据用存储过程能****入在临时表格中，你可能执行一个查询，或者如果他们很少，你可以把他们作为参数传递给报表。在最后，这个临时表将被删除。如果你的存储过程可以返回一个ResultSet，你可能包含它在一个datasource用JRResultSetDataSource

2、iReport JasperReports深入讲解

JasperReports

iReport的核心就是一个开源的JasperReports库，它是由一个罗马的叫Teodor Danciu的开发者开发。是目前最有利于创建分布式和强有力的报表的免费软件库。这章我们就来阐述一下JasperReports的基础概念来加深我们对iReport工作流程的理解。

JasperReports API, 为报表定义的XML结构语法，以及在我们程序中需要用的库的详细资料都归档在这本名叫“TheJasperReports Ultimate Guide.”的手册中。这本书非常的超值。(目前标价35$).其他可以直接利用的信息和例子可以到官方网站： http://jasperreports.sourceforge.net。

两者不相同的是，iReport的分布式依照GPL规范，而JasperReports依照LGPL规范，因此它的局限性很小。这就意味着JasperReports能够被随意应用于商业，不用购买昂贵的软件许可或呆在家里从网上搜索复杂的开源的许可。这是用iReport创建一个被用做商品报表的基本原则，事实上，程序仅仅需要用JasperReports库来打印出报表来，仅仅在程序运行时用到它。由于没有完整的商业许可（指需求以外的许可），iReport只能作为一种开发工具，也不可能成为一个不符合GPL分布式标准的程序的一部分。

报表生命周期

报表的生命周期和java类的生命周期非常的相似。Java由一些源文件来组成，也就是它可以依照它的语言规则进行自身的扩展，编写。这些源代码被编译器编译成扩展名为class的文件。可以通过接口来实例化或直接加载到内存中调用；执行期间这些属性将被加强。

同样的，一个报表也是由一个源代码的文件来描述，这个源文件就是由DTD(jasperreport.dtd,version 0.6.3is listed in Appendix B)来定义的XML标记。在0.5.3版本中它的源文件扩展名变成了.jrxml(例如：JasperReportsXML); 取代了一般的.xml扩展名。报表的源代码被编译成jasper文件（扩展名是.jasper）。jasper文件是一种预报表，严密的说就像是java的类被封状成的对象。Jasper文件通过你的应用程序来加载。它被添加一个数据源的标记从而创建报表，接着它就能以你想要的格式输出（例如：pdf或xls）。

因此它可以被定义成两种截然不同的动作：一个是用于执行在开发期间（设计和编写一个报表，编辑一个jasper源文件），另一个是用于执行在运行期间、

(加载开发期间的jasper文件生成报表)。

Jrxml源代码和jasper文件

已经解释过，一个报表就由一个被创建的DTD文件定义的XML文件 (jasperreport.dtd)。这个源文件是由一系列的片段定义，这些片段就是一些关于报表的物理特性，像这个页面的尺寸，版面的布置，以及版块的高度等等；还有一些逻辑上的特性，像参数，变量，一个为得到被选择的数据的查询的定义等等

简单的说，这个jrxml源代码包含的片段就是下面这些：

jrxml文件例子：

name="untitled_report_1"

columnCount="2"

printOrder="Vertical"

orientation="Portrait"

pageWidth="595"

pageHeight="842"

columnWidth="266"

columnSpacing="0"

leftMargin="30"

rightMargin="30"

topMargin="20"

bottomMargin="20"

whenNoDataType="NoPages"

isTitleNewPage="false"

isSummaryNewPage="false">

清单3.1

图3.1展示了清单3.1打印出来的结果。其实清单3.1是iReport的加长型，它比我们需要的太长拉。这是因为iReport不能生成精短的代码（例：不能一些具有缺省值的属性）。

图3.1

不管如何减少XML代码，也无法改变报表的最终结果和生成速度。

在编辑（通过一些JasperReport类来实现）jrxml文件期间，这个xml文件被分解加载为JRBaseReport对象。JRBaseReport一个丰富的数据结构，可以将xml的内容精确的放到内存中。所有的解析表达式被加载，生成它相应java类文件。这些类继承JRCalculator，依靠普通java编译器编译成的这些类被加载为缓冲字节。开始初始化JRBaseReport,一个JasperReport类（继承JRBaseReport类）被实例化，先前的JRCalculator类缓冲字节被存储在新类的compileData区域。从而获得的JasperReport类连续的写进jasper文件，并随时准备被加载。

JasperReports的速度取决于实际情况，所有的报表规则被编辑到java的本地字节码中。报表的结构在编辑时被检验，而不是在运行时。

数据源和打印格式

通过其他方式提供数据来完成打印是不可能的，这些最经久耐用，吸引人的报表是没有意义的。Without the possibility of filling a print through some dynamicallysupplied data,the most sophisticated and appealing report would be useless.

JasperReports 允许通过两种不同的方法来提供指定的数据来打印：通过参数和数据源，这主要依赖一个普通的接口JRDataSource.

图3.2

一整章的内容都是关于datasources，哪儿将解释它如何应用在iReport中和如何能定义一个符合常规的datasources。(为了能提供一个准确的JasperReports)。JRDataSource能读取一组被整理在表格中的记录体（行和列）。

JasperReports可能被报表用任何地方，来代替一个直接的datasources，一个JDBC（已经举过例子）能连接任何一个关系型数据库，对指定的一个报表执行sql查询。 如果数据（通过datasources）不足够，或者它需要指定特定的值完成执行，它将很有可能产生一些名值对传送给打印机。这些对被叫做parameters（参数），他们可以被预先性的传给报表。通过fillManager能够加入一个jasper文件和datasource在一个JasperPrint对象。 通过实现JRExporter接口的类这个对象能够创建一个真实的打印以你所期望的格式输出。

JasperReports 可以由你做主来选择不同格式的输出，用来创建pdf,xls,cvs,xml,html,等文件。通过JRViewer类能够直接打印你屏幕上所看到。

版本兼容性

当一个新的版本的JasperReport被发布，通常一些类会有所改变。这些改进的类特意地定义报表的结构。所以为了避免在编译报表时因用了不同的库而产生的冲突，JasperReport使每个编译过的jasper文件具有联系性，可以精确的判别库版本并使用老版本进行编辑。如果你执行一个打印加载一个jasper文件，它不同于老版本支持的文件，就会产生一个错误。可能是这种情况：

java.io.InvalidClassException:

net.sf.jasperreports.engine.base.JRBaseReport; localclass

incompatible: stream classdesc serialVersionUID = 406, localclass

serialVersionUID = 600

net.sf.jasperreports.engine.JRException: Error loadingobject from

InputStream

Caused by: java.io.InvalidClassException:

net.sf.jasperreports.engine.base.JRBaseReport;local class

incompatible: stream classdesc serialVersionUID= 406, local class

serialVersionUID = 600

然而，老的报表源可能被编译用新版本的库，这个源代码被第一次编译：这是因为锌版本的通常仅仅传入新的标签但又不是必须的，并没有修改XML通常的结构。

移植一个JasperReports到下一个版本下完全可以的。它能够很快的被执行由于一个叫massive compiler 的iReport插件，它能够编辑所有在同一目录结构下的报表，能安全的拷贝已经现有的jasper文件。

我们将讨论massive compiler 在插件章节。

表达式

所有的JasperReports的规则被定义通过表达式。一个表达式符合java语法，即有一个对象和结果。

表达式的例子：

• “This is an expression”

• new Boolean(true)

• new Integer(3)

• (($P{MyParam}.equals(“S”)) ? “Yes” : “No”)

无效的表达式例子：

• 3 + 2 * 5

• true

• (($P{MyParam} == 1) ? “Yes” : “No”)

详细的查看第一个和第二个例子都是无效的，因为他们都是简单类型（int 在第一个事例，boolean在第二个事例）。第三个表达式也无效的，因为采取MyParam参数(之后我们将定义为$P{...}格式) 是一个简单类型，它能被比较通过==和一个int型，但结果不是true。

表达式返回的类型是由上下文决定的。举个例子如果一个表达式恰好终止当一个元素被打印之后，这个返回类型将是boolean型。同样地，如果我写一个加了下划线的number型字段，返回类型就是Integer或Double。

在表达式中我提到了参数，变量和字段，报表定义的语法概要：

表3.2

字段，变量，参数永远作为一个对象（他们可以负null值），他们的类型在被声明时被指定。JasperReports0.6.2版本以后，出现了一个新类型$R{name_resource}结构。它被用做字符串的本地化。(我们将在国际化那章来讨论)

通常定义一个返回对象用一个表达式是不够的。例如：如果你想打印一个罗马字体的数字，或者用一个特别的数据代替周日，就可能要将详细的细节传给一个外部类方法，这个方法应该声明为staitic，例如：

MyFormatter.toRomanNumber($F{MyInteger}.intValue() )

toRomanNumber 是 MyFormatter类的静态方法，带有唯一的int型参数并传回这个罗马版的数字in a lace。

很多地方都用到这个技巧，比如推断出一个CLOB区域的文本内容，或者添加一个值到HashMap参数中。这种操作就不能依靠简单的表达式。

一个简单的程序

我们用一个简单的程序（清单3.2）来完成这章关于JasperReports提出的介绍。这段代码将展示如何由一个jasper文件生成一个pdf文件，这里用一个特殊的datasources JREmptyDataSource.JREmptyDataSource 是一种空的datasources。我们引用test.jasper文件（清单3.1）来进行编译。

import net.sf.jasperreports.engine.*;

importnet.sf.jasperreports.engine.export.*;

import java.util.*;

public class JasperTest

{

public static void main(String[] args)

{

String fileName ="/devel/examples/test.jasper";

String outFileName ="/devel/examples/test.pdf";

HashMap hm = new HashMap();

try

{

JasperPrint print =JasperFillManager.fillReport(

fileName,

hm,

new JREmptyDataSource());

JRExporter exporter = new

net.sf.jasperreports.engine.export.JRPdfExporter();

exporter.setParameter(

JRExporterParameter.OUTPUT_FILE_NAME,

outFileName);

exporter.setParameter(

JRExporterParameter.JASPER_PRINT,print);

exporter.exportReport();

System.out.println("Created file:" + outFileName);

}

catch (JRException e)

{

e.printStackTrace();

System.exit(1);

}

catch (Exception e)

{

e.printStackTrace();

System.exit(1);

}

清单3.2

3、iReport 报表结构完全掌握

这章我们将分析报表的构成，来观察一下它由那几部分构成，当用数据打印时这几部分是如何运转的。

Bands

一个报表依靠“type”页来定义说明。它被分成不同水平的一份被叫做bands。当报表加入数据去打印时，这些部分被印刷很多次依照他们自身的属性（依照报表创建者设计的规则）。举个例子，page header 被重复的打印在每页的开始部分，这样的话，每个band都会重复的打印每一单一的记录。

这个 “type” 页被分成9个预先确定的bands作为新组被加进去。事实上，iReport控制每一个头条（Group header）和一个摘要条（Group footer）为每一个组。

图4.1

一个带总是和页的宽度一样（左右的空白除外）然而它的高度，即使已经被设计好，但可能还会依据被包含在内的元素的实际来打印；它能够自由的延长靠近页底。这种特色的出现在bands包含一个subreports或者text field时纵向的内容。通常情况下，bands的高度被用户指定一个“minimal height”。不是所有的bands能依照内容被这个外力改变，特别是：Column Footer,Page Footer 和 Last PageFooter.所有的band高度的总和（除了background）总是小于或等于页的top和bottome之间的最小高度。

Title

这是首先看到的band。它被创建仅仅一次，可能被打印在每一分开的页。耍点小聪明，你能利用这个模拟一个无效的subreports（随后我将看看如何做）。关于尺度的确认，它是不可能躲过去的，在报表页的高度设计期间。As regards the admitted dimensions, it is not possible to exceed,

during design time, the report page height (包含top和bottome标记之间)。如果title被打印在几张单独的页面上，这个band的高度不用被包括在整个band的高度之内的，一般低与page的高度。

Page header

这个band允许你设计一个page的header。它的高度在设计阶段被定义，通常不会改变在创建报表的过程中（除非有垂直插入相当大的成分，例如这个textfields包含很长的文本和subreports）。页面的header出现在整个打印页的相同位置在设计阶段期间。Title和Summary bands不包括page header 在打印一个单独的页时。

Column header

这个band在每一个详细的列开始时被打印。这column的概念一会儿再结实。通常的，包含标签的tabular报表的列的名字****入在这里。

Group header

一个报表能容纳零个到多个group bands，它允许收藏详细的记录在不动groups。有group header ，自然要有group footer（他们能能独立的展现和取消）。不同的属性被联合在一个group。他们确定他们的行为功过查看 graphic point。它是可能的影响一个新的页的group header或者一个newcolumn，打印这个band在整个页的下面，如果这个bands超出了一个单独的页（以一个组的级别作为一个page header）。它 是可能的去修改被请求的高度并打印它：如果它是超过其他的高度，这个group将被打印在一个新的page（特别要注意它的值由于太长，在打印时会无限的循环），等等。接下来我们将详细讨论groups。

Detail

Detail band 将每个通过datasources读到记录响应的传给打印机。很可能，大多数的元素都被放在这里。

Group footer

这个band表示一个group的结束。通常它包含的区域显示小计或者分开图解元素，作为一条线，等等。

Column footer

这个band的出现表示每一个column的结束。它的尺寸是不能被调整的（即使它包含一个相当大的元素，像subreports或者文本域）。

Page footer

这是页脚。它和page header同时出现在每页。同column footer一样，他是不足够大的。

Last Page footer

如果你想使最后一页的footer与其他的页的footers不一样，这时可能就要用到这个band。如果这个band的高度是0，他将被完全的忽视，其他确定结构的普通页也能适用在最后一页。它首次出现在JasperReports的0.6.2版本。

Summary

在其他的地方这个组名被叫做report footer。它允许你在report的最后插入你想要的任何内容关于总结等。

Background

Band第一次出现在JasperReport0.4.6版本时。它由于许多用户的坚持不懈的要求能够创建水印和similar effects而引入 (整个页面的结构). 它可以具有最大的高度以至于和页面高度一样。

报表属性

现在我们已经看过报表的单个部分，我们将继续创建一个新的报表。按菜单上的这个按钮选择New Document：打开一个窗口。在这里填写报表的属性（图4.2）。这个窗口可以随时打开通过view菜单的Report properties。

图4.2

报表的名字是第一个属性。这个名字是本地命名，它和源文件的名字是相互独立的，它仅仅被JasperReports library调用（例如：命名一个报表编译后的java文件）。

页面的尺寸大概是报表最重要的属性。一系列报表的尺寸标准被提议。iReport和 JasperReports使用的最小量度单位是像素。（像素大小是75点每英寸，每英寸的点数）。

然而，我们经常使用的报表的量度单位更为平常，像厘米，英寸或毫米。

表4.1列出了量度标准和像素大小。由于尺寸管理基于像素，所以当我们用不同的量度看同一数据会发生很大改动。

表4.1

通过修改高度和宽度，你就可以创建任意大小的报表。报表页的定位有landscape和portrait选项，事实上这并没有太大的意义，因为报表页是由宽和高来刻画它的尺度的，并且每个单页都是相互独立。然而这个属性可以别用来确定报表的输出。

页面的空白尺寸依赖于Margin选项卡的四个输入值来确定。

列

像你看到的那样，一个报表页被几条平行线分开为几部分：bands。这个选项页是用来排版报表的，现在的这部分具有独立的数据（像title片段，或者page footers），和其他的片段一样被打印根据数据记录的不同从零开始（像groupheaders和detail）。这个选项页的最后一个属性值能分开垂直的列为了利用报表页中可利用的空间。

上下文中的column的概念很容易被”field”搞混。事实上，column和记录集是没有关系的，只和detail band有关系。意思就是说一条记录用十个fields和一个表的话，不需要十列。然而，这些元素可以用table实现恰当的放置。十列将导致一个很长的记录列（非常狭窄的横条）被打印。下面的例子将告诉你怎样设置值为一个简单的列报表在A4纸上。

图4.3

Columns的值是1，它的宽度和整个页面一样，除了空白。列之间的空间没有意义，所以它的值是0。

图4.4 图4.5

看4.5图，这个页的大部分没有被使用，如果使用大量的列，这个报表看起来会好看一些。图4.6展示了两列报表的尺寸大小。

图4.6

既然这样，在这个“columns“，我们输入2。iReport将自动的计算列的宽度依照页的空白和宽度。如果你想在两列之间插入空白，那就为”spacing”填写一个值。

像4.8图中看到的，这个页面的空白有被更好的利用。

滥用列的话可能将打印一个非常长列（像一个电话本一样）。总之，当detail band和连续的bands出现超过一列的宽度空白时你要记住使用列来减少宽度。所有的空白，列的宽度和每列之间的空白，加起来要小于页的宽度。如果不检验这种情形的话可能导致错误产生。

图4.7 图4.8

在图4.5和4.7中页面上有用区域设置报表的元素（像fields,images等等）。这部分是不可利用的，像空白和第一列余下的空白。Theparts which are not utilizable, such as margins and columns following the firstone (which have to be considered like the continuation of this one) arehighlighted in grey.

高级选项

以上我们看到的仅仅是基础关于设计的基础设置。现在我们将看一些高级选项。其中一些将被彻底的检查和粉肠详细的解释在以下章节，如果要想完全的理解和应用，那就要在努力学习JasperReports的用法一直到精通。

脚本

脚本是一个java类，它的方法执行在报表生成期间，通过触发一个特殊的事件，像一个新页的开始，一个group的结束等。我们常常可以看到那些生动的工具图片，像MS Access 或 MS Excel，脚本就相当于一个module，是一些程序和特殊的事件的关联或可返回的功能，在报表的上下文****入。(例如text field的表达式)

将有一个章节全部用来讲解脚本。在scriptlet选项卡（图4.9），可以指定一个外部的脚本（java类）或激活iReport的内部脚本支持。

图4.9

如果你不想使用脚本，那就设置下拉菜单的值为：Don’t use scriptlet class…或者在输入区域填写你所要使用的类的名字。

更多…

在”more..”选项卡（图4.10）可以对打印进行设置。

图4.10

Title on a new page选项

Title指定为一个新页的选项，打印在每页的开始，在title之后页面将发生大的变化。图4.12和4.13展示报表的结果，图4.11显示报表。

图4.11

Title被打印总是一样的，而且在每页的顶部。

图4.12显示使用缺省设置打印的结果：

图4.12

图4.13显示打印的结果如果“title on a new page “选项设置为true。Figure 4.13 shows the print result withthe “Title on a new page” option set to true.

像你看到那样，没有一行其他的band被打印在title页，甚至没有pageheader或page footer。然而这页仍然计算这页的总数。

图4.13

Summary on a new page选项

这个选项完全和先前的选项一样，只是summary band被打印在最后一页。现在，如果你选择了这项，那新页将包含summaryband。

Floating column footer 选项

这个选项允许你加强column footer band的打印，直接在最后detail band（或group footer）后显示而不不在column后显示。当你想用报表元素创建表格时使用这个选项。 (详细请看JasperReports tables.jrxml)

打印顺序

Print order用来决定如何组织打印多列数据。缺省的print order一是vertical，它是垂直的打印记录直到页末开始打印新的一列。 (就像报纸或电话本一样) 。Horizontalprint orderprints 以横向打印记录当一行占据页宽后开始打印另一行。图4.14和4.15：

图4.14 图4.15

这两个图清晰的显示这个两个选项的概念。如你看到的，每个名字按字母的顺序打印。图4.14显示了纵向的打印（第一列打印完接着打印第二列），图4.15显示了横向的打印（打印完所有的行显示出整个列）

无数据打印（如果没有数据时）：

当提供一个空的数据打印时(或者sql查询没有返回记录) 一个空文件被创建（或返回是一个零字节长度的流）。这个缺省的行为能被修改通过指定其他的，在没有数据时。（指when no data）。表4.2概述了可能的值和意义。

表4.2

i18n：

il8n选项卡用来设置片段的参数。

Resource Bundle Base name

Resource Bundle base name是一个参数名，当你想使报表国际化时。Resource Bundle包含用在报表中的标签，句子，表达式翻译文本以指定的语言。这个语言符合一个特殊的文件。base name

表示文件名，能帮助你找到这个文件用正确翻译。为了用精确的语言来重建文件名，一些language/country首位字母大写(e.g._it_IT,forItalian-Italy)和.properties扩展名作为前缀。我们将解释国际化在11章。

XML源文件的编码设置：

保存源文件的缺省编码格式是UTF-8. 然而，如果你想用一些你需要的XML编码格式，你就需要指定正确的charset（UTF-8）。

The UTF-8 manages all accented letters andthe euro.其他常用的可以选择编码格式列表(“ISO-8859-1” 广泛应用于欧洲).

4、iReport 报表元素大全

这章我们将解释报表的主要对象和他们的特性。

这里的”element”就是一些图形对象，像一些文本或长方形。不同于字处理机那样，在iReport那段的概念中，表和分页符将不存在；任何东西被创建借助于elements，包括文字，当他们排成一行时就创建了表格，等等。这些相近的被大多数报表工具所采用。

“basic”元素中有7个由JasperReports提供：

- Line

- Rectangle（长方形）

- Ellipse

- Static text

- Text field (or simply Field)

- Image

- Subreport

通过这些元素的结合，能够创建任何一种报表。

除了这些之外，iReport还提供了两种特殊的基于象元的元素：chart（图表）和barcode（条形码）。

每种元素都有一些普通的属性，像高，宽，位置，band应该被放的位置和其他特殊的属性（例如：字体，在长方形的情况时，border的厚度）。它可能分为两个大的类别的组：图形元素（像：line，rectangle,ellipse，image）和文本区域（labels和textfield）。

子报表代表一种独立的元素，因为他使用起来很复杂，我也将接触他们在一个单独的章节。

这些元素****入bands。特别是每一元素都不能合放在一个band中。如果这些元素不能被完整包含在band中，报表编译器将返回一个错误信息，关于元素的错误的姿态；不管怎么样，报表都将被编译，甚至是更糟糕的情况，但”out of band”将不能被打印出来。

选择并插入元素到报表中

为了添加元素到报表中，选择（图5.1）工具条上目前显示的工具

表格5.1

取向工具被用来对这些元素做更重要操作和一些常用的工具。当你想插入一个元素时，点鼠标左键在你想插入元素的地方向下拖拽鼠标来画一个合适的长方形。当松开鼠标时，一个新的元素将被自动的选择和创建。这个新的元素也将在iReport面板的右边的元素浏览（elements browser）中出现。

图5.1

双击鼠标右键或者选择菜单View→Element Properties,it 能够打开元素的属性窗口（图5.2）。

图5.2

这个窗口是有组织的几个选项卡。This window is organized in severl tabs. The“Common” tab 选项卡包含了每一种元素的通用的属性，其他的选项卡是每一种元素单个的属性。

能够选种多个元素在同一时间功过取选工具和画一个长方形将你要选择的元素包含在内。被选择的区域会显示一个粉红色的长方形框。

或者，选中一个或多个元素在同一时间，通过按“Shift”键用鼠标点中你已经插入的元素。

选种一个元素时将在该元素长方形的每个角显示兰色的小方框（图5.4），当选择多个元素时该元素长方形的每个角显示灰色的小方框。（图5.5）

​

图5.3 图5.4 图5.5

多重选择中的第一个元素作为主要的选择。.

为了能够调整元素的大小，可以移动鼠标的光标到长方形的边上或拐角处：点并拖拽来安排你想要的尺寸。为了更小心的调整，可以在元素的属性框的特别选项卡中填写合适的尺寸。如果同时选择了多个元素，一个元素的调整会调整所有的元素。

此外，你也可以用放大报表，通过使用工具条上的zoom工具（图5.6）：

图5.6

你可以在选择框中选择百分比（图5.6）或者直接写一个你想要的值（明确一下，字符后使用’%’号）。

警告：在调整元素期间，必须注意使用整数（像1x，2x，3x，等）来避免近似值的错误！

布置和元素顺序

一个元素可以通过鼠标来移动：通过点这个元素，选中后可以进行拖拽到任意你想要的位置。为了能够最大化的提高移动的准确度，你可以用方向键进行移动，一次移动一个像素。同样的操作，你可以完成通过按shift键，将引起这个元素十个像素的移动。

.即使移动时有一点阻碍，也可以破坏掉这个元素的阻碍，可以选择菜单Edit→Disable elements mouse move.

菜单可以View→Show grid查看不同元素的位置，通过格栅作为参考。也可以插入一个动作，通过菜单Edit→Snap去对起格线。

图5.7

随着越多元素组织进报表，可能就要用到几个工具，这些工具可以从这两个菜单format和contextual中找到，可以按右键查看选择插入元素。更多的官能性需要选择更多的元素。在这种情况下，基本元素被作为做作的参考。表5.2是对官能性的总结。

表格5.2

元素能够被互搭；也就是通过使用格式功能Bring to frontand Send to back使元素置前或置后。zorder被给通过整齐的元素插入到报表。这个排列能被看到在元素树，这些元素被查看在每一个band从最矮到最高的。

我们说过，一个元素已经被连接到所属的band。如果这个元素的一部分或全部超出band，它将会出现一个红色的高亮框架显示（仅仅为text元素），这个位置可能就是无效的。其他元素，这个错误位置被高亮显示在元素树或者被选择的元素上用一个红色的拐角。

图5.8

如果一个元素的部分遮掩了其他元素，这个拐角用绿色高亮显示；但如果一个元素的全部遮掩了其他元素，这个拐角用粉红色高亮显示。

图5.9

移动一个元素从一个band到另一个band，iReport可以自动改变所属的band。去指定不同的band，需要用属性窗口的第一个复选框（图5.9）。

如果两个或更多个元素被选择，那么属性窗口将只显示公共属性，如果这些属性值是不同的，将显示空值（使用的字段被显示空白）。具体的值为特殊属性，将适用于所有被选择的元素。

使用元素树管理元素

元素树能够容易和精确地局部地选中报表元素。

图5.10

这里报表的外型是一个属性结构：主节是bands（使用一个文件夹表示），进到band里面是元素符号，名字和坐标能被看到，他们也被置于band中。

双击一个你选择的元素，将打开该对象的属性窗口。也可以通过鼠标右键属性菜单打开。再往后常用的功能就复制和粘贴，这儿有两个特殊的功能，move upand move down, 意思就是说可以修改一个元素在具体band中的z-border.

图5.11

如果选择了band的名字，可以右键属性进行对band 属性的操作。(图 5.11).

所有的band的特征将在第8章被解释。

基本属性

所有的元素都有公共的属性在属性窗口“common”的选项卡 (图 5.2).主要关系到元素在页面上的位置：以下对不同属性的描写。

并列和同等规格的总是被确定为72个像素大小。

Band指元素所属的band。所有的元素只属于一个band，一个band总联系着这个元素。元素的安放总是在band中。

Top所属band的元素的上边到band顶部的距离

Left从band左边到元素右上角的距离

Width指元素的宽度s the element width;

Height指元素的高；它实际上的值是根据打印时真实值的高度来确定

表格5.3

Foreground指文本被打印的颜色和元素的线和拐角被画的颜色。

Background指元素背景填充色

Transparent这个选项表示元素为透明的，透明的元素的部分应该被背景色填充。

警告：不是所有的输出格式都支持透明的。

Remove Line When BlankThis这个选项允许拿走垂直空间占有的对象，如果不太明显，这个元素option allows to take awaythe vertical space

occupied by an object, if this is notvisible; the element visibility is

determined by the value of the expressioncontained in thePrint

When Expressionattribute;thinking about the page as a grid where

the elements are put, the line which theelement occupies, is that

where it is put;

表格5.4

表格5.3加亮元素的一条线；为了真正的删除这条线，所有的元素占有仅仅一部分线，有null值的地方 (没有被打印出来);

Print in first whole band这个选项保证当元素值溢出时被打印在下一页或下一列；这个保证被使用当Print repeated values是不活跃时

Print when detail overflows这个选项允许打印元素以页或列，如果band不能被打印当前的列或页

Print repeated valuesthis 这个选项决定时候打印元素，当该元素的值与前一条记录值一样时

Position type在band被改变的情况下确定顶部的坐标。三个可能的值是：

- FixRelativeToTop预先定义位置类型；这个坐标从来不改变的。

- Float元素进一步的向底边增加他们的高度，依据前一个元素的高度

- FixRelativeToBottom元素维持其到底边的距离的常量值；被用做单独记录的分割线。

Print when group changes所有的报表的组被显示在这个下拉框中；如果他们中的一个被选择，仅当表达式改变组的时候被选择的一个将被打印，此时一个新的坏的组被选择。

Key它是元素的名字，只有一个意义（iReport自动提出），被程序用来在运行时修改需要修改的文件的属性;

Stretch type这个属性用来定义详细打印期间元素的高度；可能值有以下几种：:

- No stretch预先改变类型利用元素的高度保持一直。

-RelativeToBandHeight元素成比例的增加使band增加，用来模仿表格的垂线。

- RelativeToTallestObject这个选项修改一个元素的高度从而改变离它最近的元素：它也被用做element group,这是一个元素组机制，但不能被iReport管理。

Print when expressionitis它是一个java表达式像那些描述在第三章，返回一个boolean对象；除了这些元素之外，这些表达式也被连接到band中。如果表达式返回true，这个元素是隐藏的。一个null值和一个新boolean（true）关联，将被无条件打印出来。

图形元素的画一个对象像一条线或一个长方形；他们通常不显示数据，但是他们却更多的被打印出来，从美学上看他们更有趣，通俗易懂。所有种的元素分享这个“Graphics element”选项卡在这个属性窗口：

图5.11

Pen指你画线和框架的厚度；它可能的值是：

- None厚度为null，表示禁止画线或边框

- Thin线和边框的厚度最薄，但可以看的到。

- 1Point线和边框被设置为一个像素;

- 2Point线和边框被设置为两个像素;

- 4Point线和边框被设置为四个像素;

- Dotted线和边框被画用虚线；

Fill用来修改填充背景；仅仅被允许使用fill值，完全的填充

线

在JasperReports中线被定义为长方形，有对角线的长方形。

图5.12 图5.13

这个线被画用Foreground色和Pen厚度.

Line directionit被表示成两条对角线，可能的值是：TopDown(看图 5.13) 和BottomUp.

矩形

长方形常用在一个元素周围的边框。这个边界用一个较粗的前景色线来画的。背景被背景色填充，如果这个元素没有被定义为透明的话。

长方形的特殊性在JasperReports中会有一个rounded comers。被定义的意思的是radius属性，描绘弯曲度在你画一个拐角时，使用像素。

​

图5.14 图5.15

椭圆

椭圆是唯一一个没有自己的属性的元素。至于长方形，它的边框也是用一个粗的颜色是前景色的线画的。背景被背景色填充如果这个元素没有被定义为transparent。椭圆被画在长方形内切边与长方形的四条边相切。

图5.16

图象

图象是最复杂的图形对象。可以使用raster images

(像GIF, PNG, JPEG,etc...)插入到报表中，但它也能被使用作为一个 canvas

对象，, 你可以画一种箱子：这个图象元素被使用，例如，画一个图表或一个条形码。

图5.17 图5.18

可以使用自己写的类使用net.sf.jasperreports.engine.JRRenderable接口。一个文本连接(“Hyper Link” tab)能够关联到一个图形元素。我们将分析文本连接在这章。

图象特征可以在“Image”选项卡设置.

Image Expression它是一个java表达式。它的结果是一个被Image

Expression Class属性定义的对象；

Expression Classattribute;以返回类型为理由，图象被装载改变的方式；

Image Expression Class表达式的返回类型。

表格5.4概述了Image Expression Class可能采用和描述Image Expression结果的解释。

表格5.5

在这个例子中我们有解释， MyUtil 代表一个创造类。如果你想使用一个创造类通过调用一个static 方法去运行特殊的细节，就需要使用一个属于它的包(例如

it.businesslogic.ireport.util.MyUtil)或者用import（菜单Show→Importdirectives in the report）引用这个包。我们解释这个方法在这个例子中是static的，但当我们讨论变量时，我们将看到如何实例化一个类在打印开始时和如何使用它在表达式中。

在Image Expression中使用字段，变量和参数，它将加载或生成图象以变化的方式（像已经发生的，例如，在detail中生成一个有图象的目录，每个目录关联一个图象）

Scale Image定义图象怎样适应元素的尺度；可能的值有三个：

- Clip图象的尺寸不改变；

- FillFrame图象适合元素的尺寸（变的不成型）

- RetainShape图象适合元素的尺寸，但保持图象原来的比例

图5.19 图5.20 图5.21

Using cachethis如果这个元素最近将被再打印，可以使用这个选项使图象保存在内存中以便下次使用；图象只有被Image Expression Class设置java.lang.String 才能使用cache；

Vertical alignment这个属性用来定义图象为垂直队列依照元素区域； 可能的值是：

- Top图象排列在顶部；

- Middle图象被放在垂直队列的中间在元素区域中。

- Bottom图象被排列在底部；

Horizontal alignment依照元素区域，图象被定义到水平队列；可能的值是：

- Left图象排列在左边；

- Center依照元素区域，图象排列在水平中间

- Right图象排列在右边；

Evaluation time定义Image Expression被处理时的状态；事实上表达式的赋值能被做当报表引擎在创建报表时遭遇这个元素或或者也能延缓在一些特殊的案例中：例如，你想去计算一个子报表。

赋值时间是一个非常有用的功能，它将被解释在JasperReport手册中。可能的值：

- Now立即求表达式的值；

- Report报表产生之后求表达式的值；

- Page页未求表达式的值 ；

- Column列末求表达式的值；

- Group求每组的值；

Evaluation group同Evaluation time.

图形元素（和text元素）可以被想象成一个框架，或者可以定义它的四个边的值。

它是元素元素和内容之间的空间。边框和内容被定义在border选项卡。他们的属性被介绍在JasperReports0.6.3版本。

图5.22

可以选择元素的类型和画每条边的颜色。边框类型是：

- None,厚度为null，允许不打印出边框线；

- Thin最小厚度；

- 1Point一个像素的厚度；

- 2Point2个像素的厚度；

- 4Point4个像素的厚度；

- Dotted最小厚度的虚线；

一个简单查看图形效果的方式就选择border选项卡中间的显现边框。

文本元素

和图形元素一样，文本元素也有一个允许查看的公共属性：它是font选项卡（图5.24）

图5.23

“font” 选项卡是用来设置元素中文本的属性，所以不仅仅是字体（字符的类型和尺寸），还有文本的队列，可能的rotation和线空间。

Report font是一个边框形式字体的名字。从这里可以设置所有字符的属性；边框形式字体可以定义报表的标准和管理他们通过选择菜单：View→Report fonts;

Line spacing行间距，可能的值是：

- Single单行写如；(预先确定值predefined value);

- 1_1_2间隔一行半写入；

- Double双倍写入；

Horizontal align依照元素使文本水平排列；

Vertical align依照元素使文本垂直排列；

Rotation允许指定文本如何去打印，可能的值是：

- None文本将正常的打印从左到右，从上到下；

- Leftthe 文本逆时针旋转90度，它被打印从底到顶，水平和垂直队列依照文本；始针4

ionports0.6.3banbe the 旋转（例如，文本开始打印将沿这底边垂直队列画顶的界限开始）；

- Rightthe 文本顺时针旋转90度从顶到底，垂直和水平队列依照文本旋转；

图5.24

其他的字符的字体设置将在第六章详细解释。

文本元素的属性可以用文本工具（图5.25）条来进行修改。

图5.25

静态文本

static text被用来展示非动态文本的报表。 仅仅一个参数用来区别这个元素从一个普通文本元素在static text选项卡中，指定你要看到的文本：它是一个标准的字符串，不是表达式，也不需要依照java语言的规范。

​

图5.26 图5.27

文本域

文本区域可以打印一个java表达式的值。简单例子就是打印一个字符串(java.lang.String)来自于一个表达式想这个：“Hello World!”

既然这样，静态文本创建就需要很小的工作量，因为这个例子中字符串是一个不变的值；其实用java表达式去定义文本区域允许包含非常高的控制超长文本。不直接的联系文本元素（像发生在不同报表工具文本元素隐含的数据库字段的值):不同字段的记录值，是可利用的通过datasource，存储在一个名字叫fields的对象中，他们被访问依靠表达式的语法在第三章。

和图象一样，一个超文本连接可以关联textfields，可以在HyperLink中定义

​

图5.28 图5.29

TextfieldExpression Classit指定域表达式的返回类型；可能的值有许多，包括所有的由sql类型组成和一些管理数据的类的java对象，以下表格列出了所有可选的类型的。

表格5.6

列表中包含的 java.lang.Object类型能够在没有其他类型可以联合数据使用。

Evaluation time指定报表创建Textfield在那个阶段赋值；

Evluation group是否赋值在一个组后

Stretch with overflow当它被选择时，这个选项可以垂直的改变内容，如果元素不能充分的包含在文本线内的话；

Blank when null当域表达式返回一个null值时允许打印空白；

Pattern指定字符串可以使用Format类，指定用Textfield Expression Class是正确的。

JasperReports能格式化日期和数字；下面的表格概述中的一些例子包括字母和他们的意义可以快速的创建日期和数字。

表格5.7

这儿是一些dates和timestamp的格式例子：

表格：5.8

表格5.9

这是一些数字格式的例子：

表格5.8

图5.30

通过“create”按钮可以打开样式编辑，意思就是数字，日期，流通等的简单格式

Textfield Expression是一个打印表达式，返回在Textfield Expression Class;中设置的类型

可以转变StaticText在Textfield通过选择和按F3键。

为了能快速的改变一个或更多个普通文本元素的表达式可以选择他们和按F2键。

子报表

子报表是包含在其他报表中的一个元素，由一个jasper文件和在子报表的属性中被指定的datasource提供数据开始创建。

以下是关于子报表特征的一些简要插图。由于这个子栏目的复杂性，我们将在另一章详细解释。

图5.31

图5.32 图5.33

Parameters Map Expression定义一个运行时赋值的表达式；这个表达式必须返回java.util.Map;这个map中包含一些名值对，这些名值对将被传递给子报表作为参数值；

Connection/Datasource expression定义一个返回JDBC连接或JRDataSource用来填充子报表；

Using cache保存或不保存数据到内存，以便能快速的加载数据再下一次；

Subreport expression定义一个在运行时返回Subreport expression class对象的表达式。依照返回类型，表达式被赋值为了恢复用来生成子报表的jasper对象；

Subreport parametersthis这个表可以定义一些使用适当的表达式动态提供的名值对给子报表；

专用元素

除了JasperReports提供的原始的元素外， iReport提供两个”合成”元素为他们的普通属性和补偿使用图形元素。

图表

所有关于图表的信息查看14章。

条形码

这个元素可以创建一个动态的条形码形式的值。

图5.34 图5.35

指定打印条形码的类型。

可能的值列表在表格5.9

表格5.9

Checksumitspecifies the code控制条形码是否被打印指定的代码；这个特征仅仅被条形码的一些类型提供；

Show text指定是否打印文本 ；

Barcode Expression指定以来于条形码的表达式的值；总是返回string类型的值；

Evaluation timeeEvaluationgroup和图形元素的意思一样；

超连接

图形和文本域元素都能被用做一个anchor（锚）在文档中，作为超连接指向源或其他本地的anchor（锚）。锚是一种特殊的“标签”用来识别文档中特殊的位置。

超连接和锚可以通过Hyper Link（图5.35）选项卡来定义。这是分开的两部分。上部分是一个文本域，这里可以指定这个锚的名字。这个名字可以被其他的连接引用。

下部分是定义连接的源或文档中的位置。

JasperReports 可以创建五个类型的超连接： Reference,

LocalAnchor, LocalPage, RemoteAnchor andRemotePage.通过Hyperlink targetit 可以指定打开一个连接在当前的窗口(预先设定，目标是self（本身）)或一个新的窗口(Blanktarget)。

警告：不是所有的输出格式支持超连接。

图5.37

Reference

The Reference 连接指出一个外部的源，一个可以被通过点URL识别的源，例如一个服务器去管理向下的记录功能。这表达式仅仅需要HypelinkReference Expression.

LocalAnchor

点这个本地锚意思就是创建一个连接在同一文档之间。它可以被使用，例如通过一个标题的连接可以找到相应的章节。

定义一个本地锚去要指定一个能生成有效名字的Hyperlink AnchorExpression

LocalPage

如果指示代替锚，你想点一个详细的当前报表页，就需要创建一个LocalPage连接。既然这样就需要指定这个指示页的号码，意味着使用HyperLink Page Expression(这个表达式返回一个Integer对象)。

RemoteAnchor

如果你想点一个外部的锚的细节，你就要使用RemoteAnchor 连接。既然这样你就要指定在Hyperlink Reference Expression域和指定HyperlinkAnchor Expression来命名锚

RemotePage

这个连接可以点进一个文档外部的详细页面。既然这样，这个外部文件的URL点就指定Hyperlink Reference Expression域和这页的号码将指定HyperLink Page Expression。

5、iReport 中字体编码说明

Fonts是描述文本的特征 (形状和尺寸)。在JasperReports中可能指定每个元素的字体属性。而且它可以定义一个名叫“report font” 的球形字，并联合他们到文本元素。这个球形字体将被包含在元素中使用。

字体

通常一个字体被定义有四个特征：

- 字体名字（字体家族）(font family)

- 字体尺寸

- 属性（黑体，斜体，带下划线，barred）如果以PDF输出报表，JasperReports需要一些附加的信息：

PDF Font Name这是预先确定的PDF文档字体的名字；

PDF Embedded这是指定一个字体的标记，像“external TTF”类型，

应该被包含或不包含在PDF文件。.

PDF Encoding这是一个字符串，用来指定字符编码的名字。

如果不输出PDF格式的报表，字体使用指定的font name，强化的部分可以指定它的属性。在这种情况下的PDF文档，识别使用的字体和它的属性（黑体，斜体，等）。

其他属性是可以被忽视的，因为他们已经被包含在PDF字体中。

扩展字体

可能要使用扩展的TTF（TrueType font）。为了能够使用，就必须将扩展字体（扩展名为.ttf的文件）加到CLASSPATH中：这是需要的在设计（使用iReport时）和生成（通过一个java程序，swing或servlet生成报表时）时。

警告：需要避免添加数以百计TTF到CLASSPATH中，因为可能这可能使iReport启动向下运行变的缓慢。你可以添加一个%WINDIR%\fonts目录在CLASSPATH中。

图6.1

In the 在“Font name”选择框中仅仅是系统字体，通过java虚拟机来管理，通过操作系统来展示他们。意思就是说如果你想使用扩展的TTF字体在非PDF报表中，你就需要去安装它到系统中。

安装后，在PDF Font Name选择框中选择 “External TTF Font...”。

选择框中的“True Type font”将被激活。它将在classpath中查找所有的True Type fonts引用它。

为了能在输出的PDF中正确的显示字体，需要选择“PDF Embedded”。

编码

字符编码是JasperReports中最模糊的问题之一；这个问题可能发生在打印PDF格式的报表时。所以选择一个正确编码格式是非常重要的。

编码如何指定的说明：The encoding specifies how thecharacters have to be interpreted:在意大利，例如，如果你想打印合适的重音（像è, ò, a, ù,等），就需要使用编码（西方，欧洲一个ANSI标准Western European ANSI aka WinAnsi）。然而一些JVM版本不支持编码（1.4版本以前的），但他们可以使用编码（唯一不同的是小写的”p”）。

iReport 富含预先设置的编码类型在选择框去选择。

如果你在一些不标准的PDF格式报表中有一些问题，确认所有的字段的编码类型是否一致，核实从数据库读取的报表的数据的编码设置。

使用Unicode字符

可以使用Unicode写不标准的字符（像希腊，西里尔和亚洲字符）；Unicode编码可以被指定在表达式中，用来识别这些文本。例如，如果你想打印 euro符号，可以使用Unicode \u20ac字符来避免乱码。

注意：表达式\u20ac不是简单字符串，它是识别包含?字符的java表达式。如果写一个静态文本到文本元素中，\u20ac就能打印出来，因为它是静态文本，所以不被作为java表达式类解释（仅仅适合在textfield中）。

报表字体

可以选择菜单”View”中”Reportfonts” 定义球形字体。会打开一个管理球形字体的窗口。一个新的图解可以查看图6.1。

从”Report font”选择框中选择使用球形字体在文本域中（图5.23）。

iReport不做管理使用最理想方式的“report font”。限制自身选择报表字体的属性值到文本元素中和复制所有的球形字体到文本元素中。事实上，球形字体天生就是为节约XML源为目标的，来避免为每一个单独的域指定字体。因为这些工作都可以被iReport自动的完成，最优化的重要性并不大。然而，因为这个企图集中报表字体的管理被迫停滞，因为，如果提出，JasperReports用属性来指定元素的标准，他们总是被指定被。 更简单的，如果一个球形字体报表被使用在文本元素，它的特征被保存在文本元素，本质上还是球形字体报表。

显然一会儿工夫不可能设置超过一个报表的字体。

6、iReport 字段，参数和变量精解

报表中有三个组的对象可以存储值：字段，参数和变量。这些对象被使用在表达式中，他们能改变他们的在打印行期间值和他们的类型，所有他们都有一个符合java类的类型，像string或double。字段，参数和变量被提出在报表中。选择主菜单”view”，我们能够发现“Report fields” (这就是字段), “Reportvariables” and “ReportParameters”这些子菜单.这三个子菜单中的每一个都允许我们管理所有他们的对象（图7.1）

图7.1

通过这个窗口我们可以声明，修改和删除字段，变量和参数。

字段

一个打印一般从数据源开始被创建：数据源在JasperReports 总是被组织成一组记录，这些记录被排列通过一系列正确字段像一个sql查询的结果集。

在图7.1的窗口中，”Fields”选项显示了需要打印的字段。为了能够显示这些字段，可以按”new”按钮，从而打开一个新的窗口（图7.2）

图7.2

字段被定义通过名字，类型和一个特需的描述。你不可能任意选择一个字段的类型。如果这个字段类型不在预选的类型中，就可能断言这个字段作为java.lang.Object和投射他到一个必须的类型在字段被使用的表达式地方。在表达式中你可以查看一个字段通过使用语法：

关键词：