第一部分：使用iReport制作报表的详细过程（Windows环境下）

第一部分：使用iReport制作报表的详细过程（Windows环境下）
收藏

http://blog.csdn.net/jemlee2002/archive/2004/10/05/125107.aspx

提示:在有些板块，文中的图片看不到，建议到我的blog浏览文章：http://blog.csdn.net/jemlee2002/

文章将会涉及
3
个方面的内容：

第一部分：使用
iReport
制作报表的详细过程（
Windows
环境下）

第二部分：使用
Jasperreport
作为报表控件开发胖客户端报表应用

第三部分：使用
Jasperreport
作为报表控件开发
Web
报表应用

1
、前言

在网络上可以搜索到很多使用
iReport
和
Jasperreport
配合实现各种报表任务的文章，但是我觉得很少有一篇（几乎没有）做一个比较详细的介绍如何使用
iReport
制作报表的全过程，我所看过的文章的基本思想是覆盖面广，很多内容都是提及即过，并不是开发人员都有时间为每个实践花费时间自己实现，如果能有更详细的资料，那岂不是一件乐事。出于这个念头促使我写这篇文章，希望能对那些使用
iReport
和
Jasperreport
朋友有所帮助，特别是需要亲身去实现报表的朋友，希望能给你们带来一点帮助。本文不是对
iReport
的每个细节进行介绍，关于
iReport
的每个细节可以参考
iReport
网站的资料，但是可能得花费一些费用。一般用户没有必要付出这些费用，因为我们关心的是如何制作我们需要的报表，而不是去扩展
iReport
，比如制作
iReport
的插件。

2
、准备

2.1
、下载
JDK

地址： http://www.sun.com
，选择
1.3

以上版本（建议
1.4.2

以上版本），安装
JDK

，默认安装即可；如果你的系统已经有安装过
JDK

或是有
JRE

即可省略这一步骤，验证
JDK

或是
JRE

是否可以默认运行，在命令行（
CMD

）打入
X:>java

如果出现：
Usage

：
java………………………..

开头的一堆信息既是通过验证。否则必须进行配置，配置信息如下，在
windows

的环境变量设置：

path

：在最后面加入“
;java

的安装目录”

JAVA_HOME

：“
java

的安装目录”

CLASSPATH

：“
java

的安装目录
/bin
”

重新验证
JDK

或是
JRE

是否可以在CMD任何位置运行

2.2
、下载
iReport

地址： http://ireport.sourceforge.net/
，选择
0.3.2

版本（发稿之前为止建议使用的版本）解压
iReport

在任意目录，解压后的文件里面有一个
iReport.bat

，通过双击，过大约
30

秒钟如果可以弹出
iReport

的主窗体即表明你的系统已经可以运行
iReport

了，如果不能弹出主窗体，一般是第一步骤错误，或是没有完成。

2.3
、准备数据库

iReport

支持绝大部分数据库，只要该数据库能提供
JDBC

驱动器。本文提供
MySql

数据库作为例子，但是文章最后会提到如何配置
Oracle

的支持。关于数据库的安装和建立表不属于本文的范围，请参考其他资料。本文假设已经安装了
MySql

和在
MySql

已经有一些表，并且确定表中已经有数据了。

*

【特别提示】
MySql

的版本要求与
iReport

文件夹下的
Lib

目录的使用
MySql

驱动程序兼容，笔者建议到
http://dev.mysql.com/downloads/

下载最新版本
mysql

的驱动器，这样就不会应为
JDBC

驱动器的问题而当心数据库的支持问题。

2.4
、启动
MySql
服务

确定
Mysql

使用的的字符集是重要的问题，特别是对需要中文报表的朋友，应该特别注意这个问题。

2.5
、确定商务逻辑

也就是希望完成什么样的报表任务。需要实现的报表的详细描述，这是实现报表的业务条件，否则所有的任务绝大部分没有意义。本文使用一个
Bug

记录表为例，本文的例子是制作一个根据项目和项目中的模块分组的
Bug

量统计。

3
、开始配置基本信息

3.1
、配置界面使用的语言和报表输出路径

第一次进入系统是英文环境，可以通过【
Tools

】－【
Options

】开启配置iReport系统的基本信息对话框。在“
Language

”选项里面选择你需要的界面语言，比如“中文－中国”。点击【
Apply

】按钮，系统既把整个界面中文化。

在配置iReport系统的基本信息对话框中选择【编译】
Label

，之后决定你的报表输出路径，可以把“编译在报表数据文件夹”选择打勾，这样报表的
jrxml

文件和
jasper

文件就放置同一文件夹。（在新建报表时会要求你把
jrxml

文件保存到指定的文件夹）

【
Options

】选项中的一部分参数修改不能通过【
Apply

】按钮直接起作用，比如“
Look&Feel

”，必须重新启动
iReport

才能起作用。不知道是不是iReport的
Bug

？！最后【存档】。

3.2
、配置
MySql
的数据库连接

这就是报表与数据库的接口。可以通过【资料来源】－【连接
/

资料来源】开启配置列表对话框，
iReport

会记录以前使用的所有连接，除非你手工删除这些连接，否则所有的连接都会存在连接
/

资料来源配置列表对话框中，不管是否确实可用。

点击【
New

】进入配置新连接界面，如图：



填写JDBC连接需要的信息，iReport支持多种数据源连接，如图：



本文只是介绍
DataBase JDBC Connection
连接方式，这也是最常用的方式，特别是在嵌入式报表应用。所有的信息填写并测试通过之后，最后就是保存信息。回到配置列表对话框，关闭对话框，完成
MySql
数据库
JDBC
连接配置。

提示：如果你需要报表提供中文内容显示可以在JDBC URL下工夫，比如输入：

jdbc:mysql://localhost/SUBRDB?user=****&password=****&useUnicode=true&characterEncoding=GB2312

其中的****号替换成数据库的用户合密码。

3.3
、新建一个空报表的基本配置

单击工具栏的第一个工具“
New Report

”，新建一个报表，输入报表名称和定义报表的一些参数，比如名称输入
BugsRpt

（例子是做一个项目的
Bug

量统计报表）
,

单击【
More….

】选择标签，填写或是选择
XML

编码，这是关系到你的
XML

支持的字符集的选择，请根据需要选择，比如需要你的
XML

文件支持中文，那么可以输入
GB2312

或是
GBK

，之后点击【
OK

】按钮，进入报表的设计界面。

*

【特别提示】请在开始任何工作之前保存报表，这时
iReport

提示保存报表的位置，选择合适的位置之后输入
BugsRpt

作为名称。

3.4
、定义报表可能需要的字体类型及其属性

一
个报表的内容五花八门，有表头、栏位名、数据、其他变量信息等等，如果这些信息都是一致的字体和属性（比如颜色），那么整个报表就死气沉沉，显得很粗糙
了。我们可以在为报表添加每个元素时定义元素的属性，但是那是一个多么费时的工作，如果能预先定义一些属性的组合，之后在创建每个元素时只需选择这些组合
的其中一个即可，省事又快速。

单击【预览】－【报表字体】开启自定义组合对话框。单击【
New

】
进入定义详细对话框，如图：按照图中的顺序填写信息和步骤，依次定义“表头”、“组”、“列”、“列内容”、“统计计算”、“其他”等6中字体组合。注意PDF内嵌字体的选择，如果你需要报表时以PDF文件格式提供，那么对此需要作出选择。

4
、理解几个重要的概念

4.1
、
iReport
的输出格式

iReport

的预览输出格式可以支持以下几种：

PDF

、
HTML

、
CSV

、
JAVA2D

、
Excel

、纯文字、
JRViewer

，其中最常用的是
PDF

、
JRViewer

。本文以
JRViewer

为例子。
JRViewer

是直接以
C/S

方式作为报表的输出格式，在
JFrame

框架下输出。
Jasperreport

提供默认的
JRViewer

输出类。

4.2

、报表的动态对象变量、参数、字段

在使用
iReport

的过程中会碰到很多与变量（
Variables

）、参数（
Parameters

）、字段（
Fields

）这些有关的内容，我们要介绍这些对象的使用和意义：

·字段（
Fields

）：是数据库抽取出来的，希望在报表中出现的数据库内容。比如一个
ID

的所有值。
$F{ filedsName }

·参数（
Parameters

）：这是你的应用需要提供给报表的入口，比如你希望在报表被解释的时候提供
Where

语句的条件值，那么就可以使用参数（
Parameters

）。
$P{ parameterName }

·变量（
Variables

）：这是报表中一些逻辑运算的表现，比如统计值。
$V{ variablesName }

每种对象的定义格式如每个对象的后面说明，比如定义一个变量（
Variables

），那么表达式就写成
$V{ variablesName }

，报表中出现的就是这个变量的名称。后文会详细的介绍使用方法。

4.3
、编译、静态运行、动态运行

Jasperreport

运行时需要的就是一个
jasper

后缀的文件，编译过程其实就是把
jrxml

后缀的文件生成
jasper

后缀的文件。（可以参考
Jasperreport

的运行原理）

静态运行和动态运行是相对的，后者带数据源运行，比如带数据库运行。前者就是静态文本运行，和数据源无关，如果报表中出现和数据源有关的对象，则以
null

显示。

4.4

、报表结构

一个报表的结构大致是
几

个部分：
title

、
pageHeader

、
columnHeader

、
detial

、
columnFooter

、
pageFooter

、
summary

、
groupHeader

、
groupfooter

。

·
Title

：每个报表一般会有一个名字，比如×××销售报表，
title

就是搁置这个名称的最好地方了，当然你也可以根据需要搁置在合适的地方。

·
pageHeader

：报表的一些公共要素，比如页码、创建时间、创建人等信息放置在这里是比较好的选择。

·
columnHeader

：无可非议的这里是放置列的名称，记住不是列数据。

·
Detial

：放置需要循环的数据，比如销售记录数据。

·
columnFooter

：放置列级别的统计计算值或是列的说明。

·
pageFooter

：放置页级别的统计值或是页的说明。

·
Summary

：可能需要对几页（你的报表可能有几个页组成）的统计值。比如
50

个销售记录共占用了
3

页，那么放置这些统计记录的统计值最好的地方就是
summary

。

·
groupHeader

：每个表的内容可能需要根据某个属性进行划分显示内容和计算内容，比如希望以月份为单位每组分开显示销售记录，那么就可以定义一个组（组的定义参考后文），
groupHeader

就是放置组说明或是组标志最好的地方。

·
Groupfooter

：放置组的统计或是说明

5
、向表添加对象

5.1
、添加静态对象

可以通过工具栏的工具添加静态对象，比如文本，点击【
T


】，之后在报表的空白处单击，如此即可把静态对象添加到报表，然后拖动对象的边框，使它的大小合适，双击对象弹出对象的属性配置对话框，切换到【
Font

】
Label

，在“
Report font

”的
ComBox

选择“表头”字体，（表头字体是前文提供的自定义属性组合），再切换到【
Static Text

】
Label

，修改表头的名字，比如“
Bug

统计报表”或是“销售记录统计表”等等与业务有关的内容。添加图片，请点击【
Image Tool

】，之后的操作与
Text

类似。其他静态对象操作步骤类似。

5.2
、使用连接

还记得前文提供的（
3.2

节）配置
MySql

数据库连接吗？这里我们将要使用前文配置的连接了。选择菜单【建立】－【使用动态连接】开启可选的动态连接，选择任何一个你需要的连接最后【
OK

】，保存报表，这样你的报表就使用了这个连接了。

*

【特别提示】此连接必须与以后应用程序使用的连接一致。

5.3
、创建
SQL
查询语句

SQL

语句是对任何
RDBMS

起作用的语言，外部用户需要使用这些语言管理维护数据库中的数据，同样的，
iReport

也是需要这么做，我们需要提供查询数据库的语言－
SQL

语句，这样，
iReport

即可通过此
SQL

语句获取数据，之后组织到报表中并显示出来，以满足用户的需要为目的。

通过菜单【资料来源】－【报表查询】开启
SQL

输入对话框，并在【
Report SQL Query

】
Label

中输入
SQL

语句如图：图中的“
Automatically Retrieve Fields

”
checkbox

和“
ReadFields

”
Button

是确认自动获取还是手动获取数据库表的可用
Fields

。单击【
OK

】，保存报表。

5.4
、创建字段
动态对象

报表的动态对象有变量、参数、字段，前文提及了他们的概念，这里将要一一讲解如何使用。

字段也就是数据库中的字段，通过菜单【预览】－【报表字段】开启字段的列表（工具条上可以找到相应的工具），可以拖放任意字段到报表的任何位置，比如拖动一部分
Bug

的内容字段到
detial

段（内容无关紧要，只要知道原理）。

5.5

、创建组

组是一个很重要的概念，一个报表可以多个组，每个组以一个关键字为标记，比如希望
Bug

统计是根据项目（或是产品）进行统计的。那么可以设立一个项目标记的组。如图：



组的参数设定可以看界面即可理解部分，其中最主要的是“
Group expression
”，这是必须输入格式正确的并且存在的字段名称，本文的“
proname
”是【字段】中的一个元素。依此类推，建立其他的组对象。每建立一个组，在报表的界面上都会出现该组对应的段，如图：至于他们的意义和容纳的内容参考“
4.4
报表结构”，他们是首尾对应出现的。（
Header
和
Footer
）

5.6
、添加参数和使用参数

我们重申参数作用，一般是需要外界提供参数给报表的入口，比如
SQL
语句的
where
条件的表达式。通过【预览】－【报表参数】开启报表参数列表对话框（工具条上可以找到相应的工具）。如图：输入名称及其他参数。【
ok
】
,
保存报表。



那么如何使用呢？打开
SQL

语句对话框，参考“
5.3

创建
SQL

查询语句”，这时候的
SQL

语句应该是：

SELECT *

FROM bugs
where proname=$P{ProjectName}
order by proname,modulename

注意其中的红体字部分，就是把刚才定义的变量运用到
SQL

语句了。这样当应用提供参数时，只要指定提供给这个参数，那么报表解释引擎即可替换这些变量然后再执行
SQL

语句，在第二部分提到编程时，会提供参数设定代码。

5.7
、添加变量和使用变量

变量的定义类似参数，通过【预览】－【报表变量】开启报表变量列表对话框（工具条上可以找到相应的工具），如图，图中定义的变量的作用是：定义一个
Bug

的计数器，数据类型是
java.lang.Integer,

使用
Count

函数进行统计字段
tester

，作用范围是模块组，也就是统计模块的
Bug

量。其中的
tester

可以改成其他非组对象，比如
proname

是组对象，就不要用作这里的统计参数。以上提供的是自定义变量，其实iReport系统还有提供一些内嵌（
Buildin

）的变量，比如页码，行记录数等，视需要而使用。

6
、最后的报表

6.1
、完成后的报表

6.2
、预览报表

点击动态运行报表，出现如图内容：

7
、总结

第一部分只是介绍了如何制作一个动态数据报表，其实
iReport

还有提供很多的特性供开发人员使用，比如柱状图、饼图、及各种形状的图形等，满足企业绝大部分应用的需求。希望你能继续研究并充分利用。

关于使用

Oracle

数据库作为数据源的内容：提供与使用的

Oracle

版本对应的

JDBC

驱动，把驱动放置在

iReport

的

lib

目录，配置数据库的

JDBC

连接时如图：其它操作基本没有区别。

8、补充内容

8.1、实现表格

可以在Detial中加入必要线条实现表格，配合columnFooter、columnHeader、Detial这3个位置实现，您可以试试画线的位置！