ireport中文用户手册.doc

《ireport中文用户手册.doc》由会员分享，可在线阅读，更多相关《ireport中文用户手册.doc（171页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、目录iReport用户手册1iReport用户手册 - 介绍1iReport报表结构1iReport报表元素5iReport字体和样式(Fonts and Styles)6iReport字段,参数,变量12iReport栏和组(Band and group)23iReport子报表(SubReport)30ireport数据源39常规问题解决方案104iReport JasperReports深入讲解110iReport 报表结构完全掌握119iReport 报表元素大全131iReport 中字体编码说明154iReport 字段，参数和变量精解156iReport Bands and gr

2、oups166iReport用户手册iReport用户手册 - 介绍 CubeBI.com 立方开源商业智能 iReport是一个能够创建复杂报表的开源项目。它100%使用Java语言编写。是目前全球最为流行的开源报表设计器。由于它丰富的图形界面，你能够很快的创建出任何一种你想要的报表。以下是iReport一些比较突出的功能： 拖拽式,所见即所得的报表编辑器。 多样的向导来简化复杂的报表设计任务。 超过30个排版和格式化工具。 报表可转换为PDF HTML EXCEL FLASH CSV RTF TXT OpenOffice Java2D JRViewer等格式。 支持所有有效的数据源。如:J

3、DBC,CVS,Hibernate,JavaBean等 用户自定义数据源。 无限次数的 撤消/重做。 集成脚本（scriptlet）支持。 内置图表支持：超过20种的图表支持。并可扩展。国际化：集成超过15种语言。 报表模板与报表库样式管理。 源文件的备份 文档结构浏览器iReport报表结构 CubeBI.com 立方开源商业智能 在本章中我们将一起来分析一下报表的结构，看一下报表中每一部分的作用是什么，以及在生成报表的时候每一部分将产生什么样的效果。4.1 栏(Bands)报表被垂直分成若干个部分，每一个部分我们叫它为“band”。每一个band都有自己的特性，在报表生成的时候有些会打印一

4、次，有些会打印多次。如下图。图4.1接下来我们就对每一种类型的band分别进行介绍。Title Band：title 段只在整个报表的第一页的最上面部分显示，除了第一页以外，不管报表中共有多少个页面也不会再出现Title band 中的内容。pageHeader Band：顾名思义，pageHeader 段中的内容将会在整个报表中的每一个页面中都会出现，显示在位置在页面的上部，如果是报表的第一页，pageHeader 中的内容将显示在Title Band 下面，除了第一页以外的其他所有页面中。pageHeader 中的内容将显示在页面的最上端。pageFooter Band：显示在所在页面的最

5、下端。Detail Band： 报表内容段，在这个Band 中设计报表中需要重复出现的内容，Detail 段中的内容每页都会出现。columnHeader Band：针对Detail Band 的表头段，一般情况下在这个段中画报表的表头。columnFooter Band:针对Detail Band 的表尾段。Summary Band:表格的合计段，出现在整个报表的最后一页中的Detail band 的后面，一般用来统计报表中某一个或某几个字段的合计值。为了实际演示各个band的生成效果，我们可以在报表中的各个band里添加不同的对象，以测试各个band的作用。从示例数据库的employee表

6、里取数据，在query editor里输入下面的语句：select top 10 * from employee图4.2在报表中的各个band分别放置如下内容：图4.3启动报表，生成的效果如下：图4.4 生成的报表第一页图4.5生成的报表第二页，也是最后一页iReport报表元素 CubeBI.com 立方开源商业智能 在本章中我们将要解释可以在报表中使用的对象及他们的相关属性。我们所说的元素主要是一些图形对象，比如text，rectangle等。在iReport中没有段落，表格或分页的概念，在报表中最基本的对象主要有七个： -Line-Rectangle-Ellipse-Static tex

7、t-Text field-Image-Subreport-Crosstab-Chart通过以上这些组件的组合我们可以做出各种各样复杂的报表样式。iReport提供两种特殊的图形对象：chart和barcode。每一种类型的对象都有一些通用的属性，如高度、宽度、位置、所在的band等。除此之外还有一些针对不同元素的特殊属性。每一个元素都必须在一个band内部，如果一个元素跨了一个以上的band，那么在编译的时候将会抛出元素位置错误的异常。要添加一个元素到报表中，我们可以从主工具栏中选择相应的工具，然后添加到报表区域中即可。图5.1我们可以通过双击对象或右键菜单打开元素的属性设置窗口。图5.2属性

8、窗口由若干个标签页构成，“Common”标签里包含每一个组件都具有的通用属性，其它的标签页是针对不同元素的属性设置。在下面的章节中，我们将对每一个对象的使用做详细的介绍。iReport字体和样式(Fonts and Styles) CubeBI.com 立方开源商业智能 一个style是一个预定义的属性的集合用来控制元素的外观（比如背景色、边框线、字体等）。我们可以为我们的报表定义一个默认的style。要为一个元素应用一个style，我们可以选择该元素并从元素的属性窗口common标签里的style列表选择你需要的style。Fonts是用来描述text的外观特征。此外，你可以定义一个名为“R

9、eport font”的全局字体。6.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：指定一个字体

10、编码名称。如果我们需要将报表导出成PDF格式，将会使用指定的PDF字体，其它属性将会被忽略掉。如果我们使用扩展的TTF（True Type Font），那么扩展的字体文件（以.ttf结尾的文件名）必须放置在classpath当中。图6.1在“Font name”下拉框中，仅显示的是java虚拟机管理的系统默认字体，因此，如果要选择一个扩展的TTF字体在非PDF格式报表中，那么我们首先需要在使用之前在系统中把这些字体安装好。图6.2上面的字体列表中显示是内置的PDF字体集合，如果直接去编辑下拉框里的字体但这些字体在设计时候不可用，如果字体文件在启动的时候找不到，那将会产生一些错误。如果我们选择的

11、字体是一个扩展的TTF格式字体，要保证在导出PDF格式时显示正确，请勾选“PDF Embedded”复选框。如果要导出PDF格式报表选择正确的字体编码至关重要。Encoding指定字体如何被编译。举个例子，如果使用意大利语，要打印正确的重音符（比如：, , a, ）我们必须使用CP1252编码格式。iReport在下拉框里有一些预定义的编码格式。当报表导出PDF时包含一些非标准的字符时，要保证所有的fields都有相同的编码格式并且检查从数据库里读出的数据采用的字符集格式。6.2 样式(Styles)我们可以选择主菜单的“Format Styles” 来定义一个style。如下图所示：图6.3

12、点击“New”按钮添加一个新的style。在弹出的窗口中我们可以定义一些属性，如果我们需要某个属性的值，我们可以点击 按钮来实现。图6.4在每个元素属性窗口的“Common”标签里有一个style属性下拉框，如果我们需要为一个元素设置一个style，我们可以在这个下拉框里选择我们定义好的style，这样就可以把一个style应用到一个元素上面啦。图6.5我们可以为一个Style加一个动态的条件，当条件满足的时候采用某个style，否则就采用默认的style。举个例子，还是以doradosample里的hsql数据库里的employee表为例，如果员工的薪水大于3500，我们让薪水以红色加粗的字

13、体显示。打开Query窗口，输入下面的查询SQL：Select * from employee图6.6 新建一个style，在弹出窗口的style conditions里新建一个conditions，在表达式窗口里输入下面的表达式：($FSALARY.intValue()3500?new Boolean(true):new Boolean(false)如下图：图6.7新建的style如下图：图6.8接下来把员工姓名和员工薪水拖到报表当中，并将我们新建的style应用到薪水这个field上，如下图：图6.9启动查看运行效果如下：图6.10iReport字段,参数,变量 CubeBI.com 立方

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

15、对象。图1.1通过该窗口，我们可以创建，修改，删除这三种类型对象。7.1 字段(Fields)Field在ireport是专门用来组织记录。Field的创建有多种途径可以实现，我们可以根据在ireport中各种类型的数据源来创建我们所需要的Field。在图1.1中的Fields标签页中，我们可以点击new 按钮来创建一个新的Field。图1.2一个Field有两个必填的属性： name、type和一个可选项的description。从ireport1.0.0开始，fields可以是任何Java数据类型。这样当我们使用JavaBean作为数据源时我们可以很方便的从java.lang.Object

16、向报表中的Field的转换工作。在对象的Expression里你可以使用下面的语法来引用一个field:$field name例如如果你想处理com.bstek.test.domain.Person Bean里的username 字段，可以这样去写：(com.bstek.test.domain.Person)$username)用一个SQL query来创建Field在ireport的设计中使用SQL query的方式来创建或记录字段的是使用最广泛的也是最直接最简单的一种方式。做此操作我们需要首先打开ReportQueryDialog窗口(点击主工具栏的 按钮), ReportQueryDia

17、log窗口出现后，我们可以输入合适的SQL检索并创建Fields。图1.3在打开ReportQueryDialog窗口之前请先确认我们已经有一个数据源连接处于激活状态（激活方式请查看相关章节）,插入一条查询语句，如：select * form employeeiReport将启动SQL 查询引擎，根据输入的SQL将分析结果用fields的形式展示出来。在下面的窗口中选择你要的fields(可以多选)然后点击OK按钮， fields就被创建出来了。在这个例子当中所有字段有多程类型，一般地说，fields的数据类型是构建在原始SQL 类型基础之上的，如String,Integer用JavaBean

18、生成Fieldsireport的高级特性之一是它的数据源除了可以构建在SQL query基础之上外，还可以使用含有getter和setter方法的JavaBean（或者叫POJO）对象来创建。在这个例子中fields就是POJO类里的属性（或者是属性的属性，即子对象的属性）。选择JavaBean Datasource 标签，通过该窗口你可以指定POJO来创建fields。如下图：图1.4点击“Read attributes”按钮，你可以浏览这个对象，可以看到这个对象的直接属性嵌套的对象（子对象），双击里面的子对象你可以查看子对象的属性。要把一个属性添加到field列表,只需选中需要的属性然后点

19、击“Add field(s)”按钮。如果要把一个field作为一个文本打印，可以直接把一个field拖到report的band里或者在report的band里添加一个textfield然后设置它的expression(把一个field放在expression里)和textfield的类型，如果需要还可以为一个要打印的field定义一个pattern(模式)用来对field内容进行格式化。图1.57.2 参数(Parameters)Parameters通常是用来在打印的时候从程序里传值到报表里.也就是说parameters通常的是起参数传递的作用。他们可以被用在一些特定的场合(比如应用中SQL

20、查询的条件),和report中任何一个需要从外部传入的变量等(如一个Image对象所包括的char或报表title的字符串)。和使用Fields一样,parameters也需要在创建的时候定义它的数据类型.parameters的数据类型是标准的java的Object。图1.6在ireport中Parameters的机制是允许用户通过应用程序传递参数致报表当中。在jasperreort中的某个对象中的expression可以通过下面的语法来访问一个当前report中存在的parameter:$Pparameter name 如果应用程序没有为报表中定义的parameter赋值，那么paramet

21、er将会取我们在定义它的时候设置的default value的值。parameters是一个Java Object,所以如果它的类型是Object类型，我们在其default value里写下面的表达式就是错误的:0.123你必须要创建一个Object,如:New Double(0.123)这种写法就是正确的。在查询中使用ParametersParameters可以用来做SQL查询的条件参数的传递.如果你想根据部门编号(dept_id)得到客户的详细信息 (设计的时候我们是不知道这个部门编号的具体值是多少的).此时我们可以这样组织查询语句:select * from employee wher

22、e dept_id=$PdeptId此时SQL查询引擎将会采用PreparedStatement来处理传入的deptId值以此作为查询条件参数。如果你想直接通过parameter 值来作为SQL语句的一部门,那么你可以使用下面的特殊语法:$P!parameter name。这种写法允许你在查询时用parameter的值来替换parameter name。例如,如果我们有一个参数名为MyWhere其值为:where dept_id=D11 ,查询写法如下:Select * from employee $P!MyWhere查询时实际提交的字符串是:Select * from employee wh

23、ere dept_id=D11在程序里使用Parameters在应用程序里如果想把某个值传递到我们的报表中parameters时，我们可以把相关的值放入一个扩展java.util.Map接头类里，然后传入到report里。如下面的代码:.Map hm = new HashMap();.JasperPrint print = JasperFillManager.fillReport(fileName,hm,new JREmptyDataSource();fillReport是一个关键的方法,它允许你通过一个文件名,一个参数集来传递到我们要调用的报表当中。例如通过下面的处理方法我们可以让一个处部的

24、传入值作为我们报表的title。a).声明一个parameter.这个parameter是java.lang.String 类型，名字为：name_report:图1.6b.将这个parameter拖到page中的title band.修改上面的程序代码如下：HashMap hm = new HashMap();hm.put(“name_report”,”report title”);.JasperPrint print = JasperFillManager.fillReport(fileName,hm,new JREmptyDataSource();图1.7运行时效果如下：图1.8一般情况

25、下，我们不需要为报表中的每一个parameters传递一个值，除非某一个parameter一定要从外部程序传入时我们才需为一个parameter设置一个值。如果一个parameter外部门程序没有为其赋值那么ireport将使用Default Value Expression来对一个parameter进行初始化，如果连Default Value Expression没有设置那么它的值就是null。事实上，对于一个parameters我们不仅仅可以传递一个String,Integer,Boolean等java中小的对象，同时我们还可以利用parameters来传递一些足够大足够复杂的对象,比如一

26、个图像（java.awt.Image）,或者通过一个parameters来为一个为子报表提供的datasource 连接等。在用Map类型传递参数时我们要注意传递的参数要与report里的parameters类型保持一致，否则会抛出ClassCastException。ireport内嵌的Parametersireport提供了一些内建的parameters，这些parameters对于用户来说是只读的。内嵌的parameters列表如下：参数名说明REPORT_PARAMETERS_MAP它是一个java.util.Map类型的对象，可以通过它来传给填充报表去填充报表里所有的paramete

27、rs，在这个参数里还包含用户定义的parameters.REPORT_CONNECTION一个JDBC的Connection参数，报表可以根据传入的JDBC Connection来获到相应的数据REPORT_DATASOURCE为报表中的Connection提供一个DataSource。外部传入的时候类型也要是DataSource类型REPORT_SCRIPTLET报表生成时使用的Scriptlet实例，如果没有指定ScriptLet，那么这个parameters将使用net.sf.jasperreports.engine.JRDefaultScriptlet.IS_IGNORE_PAGINA

28、TION通过这个参数你可以控制分页功能是打开还是关闭。默认情况下，分页是打开的。但是如果导出为HTML或EXCEL时不进行分页处理。REPORT_LOCALE它被用来设置报表所处的地区。如果没有提供地区，那么将采用系统默认的地区。REPORT_TIME_ZONE设置报表的时区，如果没提供的话采用系统默认的。REPORT_RESOURCE_BOUNDLE为报表指定要加载的资源文件，在国际化一章中介绍了如何使用资源文件来构建报表。7.3 变量(Variables)Variables是用来存储对某些字段计算后的结果，比如sum等。图1.9和fields,parameters一样，Variables也

29、是有数据类型的。你必须为一个Variable实例声明一个java类型。图1.9显示了如何创建一个新的Variable。看一下每个字段的意思：Variable name: variable的名称，我们可以在表达式中通过下面的方法来引用一个Variable:$Vvariable nameVariable Class Type : variable也可以是任意一个Java类型，在下拉框里你可以看到大多数常用的类型，如java.lang.String等。Calculation Type : 一个计算类型可以用来计算结果。当一个预先定义的值是“nothing”时，那它的意思是不做任何计算。ireport

30、会根据指定的计算类型和从数据源中获取的每一条记录计算出结果，然后去更改variables的值。做一个变量的计算意为着去执行一个表达式，如果计算类型为nothing，那么ireport将会根据variable expression为variable赋值。计算类型列举如下：类型说明Nothing不做任何计算Count对记录集数量进行循环累加(计算有多少条记录)，这和sum不一样，sum的计算是针对数字的，会对数字进行累加操作。Distinct Count也是对计算有多少条记录的累加操作，只是在累加过程中会忽略已经出现的记录（比如某个字段的值已经出现后就不会再记录）Sum添加每一次表达式(这里的表达

31、式只能是数字类型)迭代的结果到变量中Average它用算术的方法来计算表达式累加结果的平均值Lowest返回表达式最小值Highest返回表达式最大值StandardDeviation根据表达式所有值返回标准方差Variance返回表达式接收到的值的变化System不做任何计算并且表达式也是没有价值的，在这样的用例中，报表引擎仅仅保存内存中variable的最后的值。Reset Type : 重置类型。表示一个变量在什么时候做重置操作。reset 类型如下：类型名称说明None任何时候都不做重置操作Report在报表创建的时候Variable才会对表达式进行初始化PageVariable的初始

32、化在每一页都做一次reset操作ColumnVariable的初始化在每一列都做一次reset操作(这里的Column指的是report里的page的column,每个报表的column可以通过报表的Editreport properties窗口进行修改)GroupVariable的初始化在每一个组都做一次reset操作Reset Group :如果group reset type被勾选，这里就要选择group名称(关于group可以参考后面的章节)。Increment : 它指定当一个variable 值被评估或当你想要这个组采用类似于subtotals 或averages来计算，incre

33、ment 类型可以参考下面的表。Increment Group : 如果这个group 的increment type 被勾选它将指定这个组决定variable的increment。Custom Incrementer Factory Class : 指定一个实现了JRIncrementerFactory接口的java类名称，通常用来定义一些诸如sum之类的非数字类型的操作。Variable Expression : 它是一个java的expression，用来标识variable每一次迭代的值。Initial Value Expression : 它是一个为variable初始化时采用的ex

34、pression.内置的variables和parameters一样,ireport提供了一些内置的variables(这些由报表引擎直接管理),这些变量是只读的，不能被用户修改，如下表所示：Variable 名称说明PAGE_NUMBER它包含当前页的页。COLUMN_NUMBER它包含当前的列数。REPORT_COUNT当前的记录数目PAGE_COUNT当前的页号COLUMN_COUNT当前的列号_COUNT在里的记录总数iReport栏和组(Band and group) CubeBI.com 立方开源商业智能 在本章中，我们将解释如何用iReports去管理bands和groups，在

35、第四章中我们介绍了报表的结构，在本章中我们将要看到如何使用bands来划分报表。同时我们还将看到如何使用groups,如何创建report中的breaks,如何管理subtotals等等。8.1 栏(Bands)ireport把一个报表划分成七个主要的bands和一个名为backgroup的band(一共是八个bands)，每当我们添加一个group时就会有两个新的band添加到报表当中：group footer bands和group header bands。点击 按钮在弹出的窗口中我们可以对当前报表所具有的bands的进行相关属性的修改。图8.1通过上图中的窗口，我们可以修改左边列表窗口

36、中的任何一个band的属性，比如它的高(以像素为单位)。Print When expression表示我们可以在这里输入一个表达式，这样我们可以根据表达式的值来控制当前的这个band是否输出。这里需要注意的是Print When expression里必须返回一个java.lang.Boolean类型的对象,如：New Boolean(true)上面的表达式说明这个bands总会被打印(如果我们什么都不输入这个就是默认值)，在表达式里可以使用fields,variables,parameters。根据这个特性我们可以通过相关的fields,variables,parameters来灵活的控制当

37、前的band是否可以输出，比如下面的代码：($FSALARY.intValue()4000?new Boolean(true):new Boolean(false)上面的代码说明当salary的值如果大于4000就输出当前的band否则就不输出当前的band。把鼠标移到bands的边上我们可以鼠标拖拉的方式改变band的大小以此来适配band里的内容。图8.28.2 组(Groups) Groups允许我们对报表里的数据进行全新的切割分组组合。分组是通过一个表达式来定义的,ireport会通过这个表达式进行计算分组情况，每一个新的组都是从我们在expression value里输入的表达式发生

38、变化的时候开始的。接下来我们将通过一个例子的演示一步一步说明如何使用groups。 假设我们有一个员工的列表，我们想要创建一个根据员工所在的部门进行分组的报表。a)首先我们打开一个新的报表文件，然后点击Connection/Data Sources，选择JDBC Connection，我们创建一个JDBC的Connection，如下图：图8.3b)点击和工具栏里的 按钮，输入查询语句，如下图图8.4 c)把Employee_name和dept_id两个field拖到report 中的detail的band里，同时调整detail band的高度，如下图：图8.5d)保存报表文件，并按 浏览报表

39、生成后的效果,如下图：图8.6到这里，我们看到员工的数据已经可以在报表里显示，接下来我们就对员工信息按dept_id字段进行分组显示。e)点击主工具栏里的 按钮，打开groups定义窗口，并添加一个新的名为dept的group,如下图：图8.7一个group有下面几个属性需要我们去定义：Group name:为这个group指定一个名称，group创建完成后会产生两个新的band : header和footer band，这两个band的名称采用group的名称来定义。Start on a new column:如果此选项勾选，那么分组只会在报表中的新的column产生，也就是说在一页中报表分

40、组在一个column里只会做一次。Start on a new page:与上面的选项类似，如果该选项勾选，那么分组只会在每一页做一次，也就是说每一页最多只会有一个分组数据。Reset page number:该选项允许在一个新组开始的时候重设页号。Print header on each page:如果该选项勾选，那么如果当前页没能显示完组里的所有数据时，到一页显示该数据时会把该组的header打印出来，否则将不会打印。Min height to start new page:该选项用来设置当前报表中页面所余下的高度的最小值分组的最小值，默认值是0，如果我们设置为100，表示如果当前页面余下

41、的高度小于100就不再继续显示分组的数据，而是在下一页显示分组的数据。Group expression : 分组时采用的表达式规则，如上图中我们在定义dept这个group时我们在Group Expression里输入了$FDEPT_ID，表示将该组按员工的DEPT_ID字段进行分组显示。Group header band height:新产生的header band的高度。Group footer band height:新产生的footer band的高度。f)接下来我们把在detail band里的dept_id的field移到report里新产生的deptHeader的band里，图8

42、.8g)点击 按钮，报表的生成效果如下：图8.9 在jasperreport里group的数量是没有限制的，一个group可以有一个父group同时也可以有若干个子group。通过group定义列表，我们可以通过”move up”和”move down”来设置group的顺序。Group 向导在iReport中还有一种简单的方法创建一个group，那就是向导，通过向导我们可以快速的创建一个group,我们可以通过主菜单中的Edit new report group wizard来启动创建group的向导。图8.10向导允许用户创建最多有四个group的报表（group header,group

43、 footer和每一个group关联）。Groups和records的排序我们可以在设置查询的地方选择设置选项来使ireport自动对依据字段进行排序，我们也可以在创建一个group时要对分组的字段做好正确的排序工作。比如在sql中我们可以添加“order by ”来对要分组的字段进行排序。iReport子报表(SubReport) CubeBI.com 立方开源商业智能 SubReport是ireport提供的高级功能，通过SubReport我们可以创建复杂的报表。通过SubReport我们可以创建一个包含若干个子报表的报表。创建一个包含子报表的报表我们需要三个对象：一个jasper文件，一

44、个包含参数map(当然可以为空)和一个DataSource(数据源,或者是一个JDBC的Connection)。在本章中我们将解释如何通过这三个对象创建一个SubReport并实现在子报表中数据过滤显示的目的。9.1 创建一个子报表(create a SubReport)一个SubReport是一个真正的包含它自己xml文件并且是一个已经编译好的jasper文件。创建一个SubReport就是创建一个普通的报表文件，创建过程中唯一需要注意的是设置SubReport的宽度、高度及一些不需要显示的band，一般情况下对于不显示的band我们把它们的高度都设置为0。在设置子报表的宽度时我们应该考虑到

45、它在父报表中显示时的效果，然后针对这一特性有针对性的去设置。在父报表中我们要添加一个子报表可以通过iReport中的SubReport工具 来实现。子报表的形状和一个距形类似，我们可以调整SubReport的尺寸和位置以控制子报表的显示。将一个子报表链接到父报表中需要做三件事情：获得SubReport所对应的jasper报表对象、如何为它提供数据及如何为子报表的parameters设置具体的值。所有这些信息的定义我们可以通过SubReport properties窗口来实现。图9.1图9.29.2 传递参数(Passage of the parameters)当我们在应用程序里通过fillRe

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