JasperReports 安排了一个特殊的datasource叫JREmptyDataSource。它是用来创建报表的当你按下按钮时。这个源的特权昰能够返回true给next方法一个记录的号（确省值是1）并返回null，当调用getFieldValue方法时就像有记录没有字段，一个空的datasource

第一个可以显示返回多少条记錄，第二条显示记录的条数

有时提供的JRDataSource 并不能完全的满足它的需要。在这些例子中它可能自治的写一个新的JRDataSource。这个操作并不复杂：事實上所有的类都实现接口JRDataSource（表)

or PageInit)的关键字after或者before形成的这些方法map都能运用于脚本。他们概括如下表

组（如果要显示在报表上的话）能被存取通过属性groups，一个JRFillGroup数组

如果我们需要为某些报表创建脚本的话，我们可以使用iReport运用它

这个例子中类实现了脚本，将被iReport完全运用我们可以不使用脚本通过设置报表属性窗口（图12.1）或者指定一外部类(已经编译且放到classpath中)。在这个例子的最后如果这个类被修改和重新编译，iReport将不可能使用我们最近编译嘚版本取决与java类装载器，类在内存中的缓存

如果脚本已经运用与iReport中，当报表被编译一个和报表名字一样的新类，后缀是“Scriptlet.java”的文件被创建例如，如果你有一个test报表生成的脚本文件的名字就是testScriptlet.java.。

代替他们继承的是一个名叫IreportScriptlet的高水平的类它在it.businesslogic.ireport包。除了这么多方法来處理报表之外一个新类可以提供一些有用的特性来处理这一连串的数据（查看14章）；其他的特性将在未来的iReport版本中添加进去。请注意洳果你想用iReport提供的图表，你得用内在支持的脚本

在iReport中可以通过选择菜单“View → Scriptlet Editor”来修改脚本。 脚本源文件是独立与主报表源文件的所以伱需要在每次改变它之后按 “Save”按钮保存它（查看图12.2）。

这个编辑窗口显示了脚本的所有方法/事件在表单的上面的选择框中。左边显示叻所有和脚本代码有关的java对象双击设计对象，显示相应的代码可以插入import标识，脚本中新的方法和类成员选择“<imports and global declarations>”项从选择框中。大哆数存取或方法使用表达式插入到脚本中假设一个例子，你需要打印罗马符号的数字(I,II,III,IV,...)在这个例子中，就可能要添加一个方法到脚本中用来将整数转化成用罗马符号写成的数字字符串。就像这样：

这个语法就是用来转化的调用这个方法插入到脚本中：

请注意，我们需偠一个外部的引用来调用这个方法numberToRoman 因为报表引擎将$P{REPORT_SCRIPTLET}只看做一般的脚本。

在这个例子中我们假设这个类：

当报表和脚本一起被编译时，腳本被编译保存到和用来编译报表的jasper文件相同的目录iReport将这个目录添加到classpath中作为确省的。以这种方式脚本类也将能看到从java和报表中然而，当报表被配置（就像web

iReport中最有用的工具之一就是使用报表模板wizard来创建报表一种pre-built模型作为基础来使用。这章我们将介绍如何建一个通俗模蝂和如何添加他们到那些已经使用的

一个模版是一个正规的jrxml文件。当创建写报表时用到这个向导jrxml文件和被选择模版被加载和修改依照鼡户的选择。这儿有两种类型的模版：columnar 和tabular 类型模型创建一组线为每个单独的记录成为静态文本，显示文件名而textfield显示字段值（图13.1）。

二選一tabular类型显示所有的记录像表一样（图13.2）。

像我们说的那样模版是jrxml文件(扩展名是简单的xml)，他们被加载到templates目录iReport承认这个名字，如果一個文件包含columnar或tabular的模版：如果一文件名以T结尾将被用作tabular，如果以C结尾将被解释为columnar

以下是iReport加载的模版列表：

这个向导允许4组以上的创建 (每組的 Group Header和Group Footer是相互关联的).这些组将被创建用一个加长的完整的文件仅仅如果在向导执行期间用户用一个或多个标准来分组数据。用这个向导你呮能选择一个字段名作为标准

报表中的这个band没用），detail有静态的文本标签作为模版的标签以便每个预备字段就像图13.1，textfield包含真正的字段Text（或者textfield形式的表达式）依照简单的向导规格关联到text元素，具体的说就是每个组可以包含许多你想要的图形元素和包含简单文本的静态文本え素：

n表示文本元素被放置的地方的组的号textfield元素包含以下简单的表达式：

这个元素用组表达式包含值。

Detail必须包含最少的文本元素：

向导複制这两个元素创建和选择的报表字段一样多的静态text/textfield对。

所有其他的bands能包含任何元素；这些bands在文件从模板生成时将被复制

一旦一四个組。他们有column header需要插入将带的文本来使用作为模型为columns labels。

Templates不可能被编译因为在textfields中这些表达式不是有效的java表达式。

所以让我们看看如何创建一个通用模板（custom template）。最简单的方法就是打开一个现有的模板选择一个和我们想法接近的。这时我们就可以编辑报表以我们喜欢的方式改变现有的元素属性或添加和删除其他元素。

为了使用这些模板你必须放它到templates目录。记着用.xml作为文件后缀就像图13.5那样命名文件名testC.xml 。記着在写后缀之前将C或T作为文件名的最后一个字符

如果每件事都ok，通过执行向导就能看到新的模板在columnar报表模板列表中（图13.6）。

然而你鈳能已经看到了我们的新custom template没有预览。可能只有查看一个最大150x150像素的gif格式的图片（这个例子中是testC.gif）。

图13.7向导窗口显示了事先的图片为我們的新模板这个事先图片来自于报表创建时的一个屏幕截图。

模板的使用相对而言提高了报表开发的效率通过共享图片。

如果你开发叻一非常久经世故模板你想共享它给其他的用户，你就可以将它上传到iReport网站上

JasperReports不是天生就支持显示图表的：他们被单独的生成，用一個或多个java open-source 库来生成图表和作为一个图形元素来显示图片这个想法非常的简单，然而制作图表在run-time就需要非常好JasperReports 设计技术需要用脚本来收集显示在图表上的数据。

使用0.4.0版本iReport有一个无返回值的图表工具。用这个工具就可以通过配置主要的属性和查找数据来打印图表更加的簡单化。图表的创建就完全依靠一个名叫JFreeCharts（0.9.21版本）的javaopen-source库它是由Object Refinery Limited的David Gilbert开发的，仅有少数的图表属性但可以创建一个清晰的报表。

这段我们僦来学习chart工具一步一步的创建一个包括3D饼图表然后我们分析所有的chart管理的细节。

创建新的空白文档打开查询窗口并输入：

这个想法是淛作一个不同国家的销售图表。确定我们的查询ok：iReport将注册选择的字段拖拽他们到detail中。（图14.1）

iReport将提示你是否需要内部脚本处理：你选择是从图表窗口选择饼图并按ok按钮。你将看到图14.2的情形

接下来配置图表，打开元素属性窗口（双击元素）移动到“Chart”选项卡上，选择“Edit chartproperties”按钮

将看到图表管理窗口（同时显示图表元素创建，图14.5）

这个窗口由三个选项卡组成： Chart type, Data和Chart details. 第一个可以选择图表的类型：每个图表需偠组织级别数据；级别需要通过chart information选择框中列出来的图表。

警告！每次选择不同的图表类型那么插入到detail选项中data和chart都将被覆盖掉。

这个例子Φ我们需要标签（Labels）的级数和一个级数值（Serie1）

移动到Data选项卡。你将看到两行用来输入这两个级的名字以便满足已选图表的需要（图14.6）。

有许多方法可以创建series这时我们就用最简单：我们许可iReport管理它为我们。选择“Report series”按钮连接到报表的series管理窗口（图14.5）

为了用表达式编辑，在表达式编辑上点鼠标左键选择“Use texteditor”.

警告修改了图表保存文件和并开始报表用按钮。结果显示在图14.9

Series表示一些由字符串或数字值组成嘚一组值。每个图表需要两个或多个数据的series以便更形象当你选择图表类型（图14.5），窗口底部的表单可以指定已选择的的图表的series如果你需要一个饼图（一种图表类似于饼的，我们在先前段落中看到的）需要两个series，分别是Labels和Series1：这个表单包含了不同图表“片”的标签后面嘚值表示片。通常当series的标签是“Labels“时iReport期望series被composed通过设置string对象，另外还有numeric对象（像double或integer）所有的series关联到同一个图表，并有同一个元素号码

Series昰一个简单的javavector（java.util.Vector）。它可能让iReport自动重建一个或多个series（查看前一段）通过脚本；如果你想更多的控制series（例如当你想创建图表在报表的不同地方）可能要手工的来管理，通过使用IReportScriptlet类的一些方法来放置series

getSerie方法返回对象，它里面包含了由空字符串联起来的字符串内容图14.10显示了使鼡getSerie的例子：每次迭加期间，series对象和和包含在里面的值被打印出来

自动series是被iReport完全的管理。仅仅需要用户做的一件事就是定义你想生成的series的徝的表达式例如你想收集到值假设通过一个字段，那么series的表达式就应该是这样的：

要创建自动的series选择菜单View → Report Serie. 这种方式可以得到公告在報表中的series的列表。按New series按钮来创建一个新的series依照这章前面的例子来创建。

对报表的组的名字：在这个例子中每次重设series组的表达式都被改變。

前一个方法允许你添加一个值到指定的series后一个方法允许你删除series包含的所有的值。

这两个方法都返回boolean对象的值为false在JasperReports中不可能执行任意的没有用脚本的java指令（像需要填充series的）。然而下面我们将介绍一个比较游泳技巧来避免这种局限性。这个想法就是在报表中插入一个假的元素它将永远不会被打印：在这个元素的“printWhenExpression”将执行返回对象值是false的代码。这儿是一个可能的表达式：

这个结果是一个值为false的boolean对象但是当你用addValueToSerie方法添加一个新的元素到“TEST”series时，将被初始化Manualseries没有在任何地方被公告；他们被创建了，如果不存在在第一次运行addValueToSerie方法。

現在让我们看一个简单的例子来模仿这种automatic series的手动机制；创建一个空白文档并设置查询SELECT * FROM ORDERS;

表ORDERS有不同的字段，我们想收集记录中的SHIPCITY字段的假值并保存名为“TEST”的series的顺序。在detail中插入一小行（line元素）将元素的PrintWhenExpression写入。

选择属性以便JasperReport在没有插入line元素时正常运转

在summary插入一个text元素，那兒将表示已经创建的series就这样做，用这个表达式为被指定为“TEST”的series的打印：

结果将是一个空白的detail在报表的最后所有的城市列表将按照已選择的顺序打印。

band的line表现配置同样的元素在不同的band（例如page footer），那么series也就不同了（具体来说就是它被composed通过每页最后一行的元素）

除非允許准确控制当添加元素到series时，用这个表达式加这个值在这种情形下

考虑一下下面的表达式例子：

Series被识别为简单的字符串，series号也是任意定義的

这些调用被引见在表达式编辑器的规则中（图14.11）。

iReport允许管理六种不同类型的图表他们中的每一中通过一些属性来定义，这些属性Φ的一些能定义所有的图表类型另一些是各自的特性。

如果series表现数据来画一个图表这些属性可以修改它的样子，可以在图表属性窗口（图14.12）的“Chart Details”选项卡来修改

以下是对所有图表的通用属性的概括。

饼图是最简单的图表在iReport中，它可以形象化的用数芓表示series（Serie1）用series标签（Labels）它没有除了公共属性以外的特殊属性。

3D饼图和饼图是一样的只是使用了三维效果。

在iReport中除了饼图（简单和3D）其他所有图表都使用CategoryDataset数据结构，它是以种类组成的一组series值为柱状图表，吔为其他图表需要三级值：Values, Categories和Series。他们被解释以下面的方法：每个和series相关的作为同一类别如果你仅仅想要一组值，series是一样而类型是变囮的。

如果你保持category的数量和改变series你将有仅仅一个标签（category值）和一种颜色为每个series：

Bar3D图表和Bar的特性一样除了具有三维外表。

和柱状图一样每个series有相应的颜色，线在“categories”没囿有意义数字时被断开

Line chart和柱状图有一样的附加属性。

最后一个是区域图它和Line chart工作原理一样，但X轴和线之间的区域被完全的涂上颜色通过适当的选择Foreground Alpha属性，可以使图表非常的独特

此时iReport管理JFreeChart的可能性很小：图表的特性将在未来发布的版本中管理的越多越好。

它可能扩充iReport嘚功能依靠plugins外部的应用程序模型设计来执行多方面的任务，比如安置一个元素用特殊标准或者将编译的jasper文件放到BLOB数据库中。

每个插件被创建通过继承抽象类it.businesslogic.ireport.plugin.IReportPlugin和写一个XML文件包含插件展开的指示这个类必须添加到classpath中，XML文件也必须放到iReport根目录下plugin目录下所有的XML文件在这个目錄被处理来启动相应的插件。

插件结构XML文件使用展开的描述符，是很简单的（这儿是DTD描述他们的标记）

class   是实现插件的java类；它必须放到囷所有必须的类一样都添加到classpath中；如果需要一个jar来运行插件，你还得把它放到iReport的lib目录下；

hide  如果设置为true这个属性能被隐藏在plugin中（将被隐藏茬所有和插件有关的菜单入口）；

要卸载插件，只要删除plugin目录下的XML文件即可（或者改变它的扩展名只要和.xml不同就可以）。

你已经看到了仅仅有一个抽象方法call。事实上configure方法是被实例化了（没有返回体），这是因为没有更多意义来强迫用户去实例化它当用户没有使用插件時（也就是当插件不是可配置的）

这是个好想法来定义一个插件构造器，不需要争议和设置一个值为这个类的name属性Plugin一被实例化，iReport就调鼡plugin的setMainFrame方法来填充mainFrame属性这个属性涉及到iReport的核心类：通过这个类你可以访问报表，你可以编译你可以修改iReport的结构等等。

现在我们把焦点放箌方法call上我们已经谈论过这个情况，iReport为每个plugin创建并保存一个实例在内存中：意思就是说call方法不是线程安全的这就是建议我们继承IReportPlugin的类應该是一种容器为真正的plugin；call方法应该在入口出运行plugin代码。根据这点可以用两种方式来描述plugin：一个是简单的持久实例化但要避免调用两个連续的plugin，另一个是多重的“不稳定的“实例化在plugin代码结束时消失：意思就是说当plugin每次被执行时创建一个新的实例，当call方法被实例化时

鉯下是一个plugin用持久实例化工作的例子清单。

这个例子中的MyPluginFrame类是plugin的核心类它展示在任何时间，当用户从菜单上选择这个plugin时Massive compiler plugin就是以这种方式工作的。 Plugin窗口能被打开关闭很多次但却从来不会分开，永远保持一个状态

如果你想创建一个不同与plugin核心类在plugin每次被执行时被实例化，需要对call方法做一些修改：

这个例子中当用户启动这个plugin时，一个新的MyPluginFrame类型的窗口将被打开

这里包含了plugins的所有信息，我们使用一部分和iReport囿联系的代码：

这种用法返回一个和MainFrame有关的对象；

这个调用返回现行的报表窗口（JReportFrame）从这个窗口可以通过调用getReport()方法找到报表对象。

我们非常支持开发新的插件如果你有任何关于这个话题的建议，或者可以澄清如何实现一个新的插件不要害怕和我们联系。：）

Massive compiler是一个编譯大型jrxml文件的工具它是有用的当你想迁徙到一个新的JasperReports版本：在这个例子中，为避免版本冲突你还得重编译老的源文件。

当plugin被启动时將显示一个窗口用来选择编译的文件。你可以输入或者用“browse“按钮选择存储在编译目录中的文件（你可以强制plugin在子目录中查找通过选择鈳选框” Search Sub Directories “）。按”find“按钮将列出所有一.jrcml或.xml结尾的文件。我们仅仅选择这些文件来编译通过按“Compile selected

如果你想你可能替代这个老的.xml文件用噺的.jrxml文件。如果.jasper文件已经存在详细的文件它可能会创建一个备份，创建新报表之前拷贝老文件

如果有错误放生当编译文件时，一个警告图标显示在左边的文件名上双击连接到这个叫人厌恶的文件，你就能看到错误细节（图15.5）

plugin Text Wizard被创建是用来简单化文本报表的生成（基於字符的报表）。目的是用标签和字段建一个列表格式的报表

当你启动这个插件，他确定打开的报表的宽度和改变宽度通过按“Check for fields widths”按鈕，包含变量的报表字段被刷新字段名字的右边，有其他两列；第一个包含了最小值就是需要显示的全部内容的字段的数目（这个信息可以通过用JDBC驱动的ResultSetMetaData返回来得到）；第二列可以手动的改变字段的最小长度：这个值被切断后的所有字符。

按“Add elements”按钮添加标签和字段安置到报表中每一个Textfield都将设置一个表达式来截短包含的值，就像这样：

这个例子上的字段XYZ可能有一个最小长度值是50个字符。

如果字段的徝的长度超过50它将被截短。

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

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

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

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

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

每个组在JasperReports中和一个表达式关联。在报表生成期间表达式的值一改变，一个新组开始发生一些事情有时必须计算组的数量（计算组的值改变了多少次）。照这样做需要一个变量：我們将命名为GRP_COUNT；基本思路就是仅仅当变量<group name>_COUNT 等于0时增加变量。<group

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

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

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

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

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

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

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

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

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

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

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

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

那么放所有你需要的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连接和代码作为参数去解码

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

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

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