iReport中文教程

iReport中文教程

iReport

一、介绍

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官方网址：/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，那么在编译的时候将会抛出元素位置错误的异常。

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