JasperReport 与 iReport 的配置与使用
（版权作品，未经作者允许禁止以任何形式进行盈利）
作者：裴贺先
www.brainysoft.net
JasperReport 与 iReport 的配置与使用
第 2 页
目 录
1.JasperReport 与 iReport 简介..................................................................................................4
1.1 JasperReport 简介..........................................................................................................4
1.2 iReport 简介....................................................................................................................4
2.安装与配置...................................................................................................................................4
2.1 JDK 的安装与配置............................................................................................................4
2.1.1 JDK 的下载与版本选择........................................................................................4
2.1.2 JDK 的安装............................................................................................................5
2.1.3 JDK 的配置............................................................................................................5
2.2 ant 的安装与配置............................................................................................................6
2.2.1 ant 的下载与安装................................................................................................6
2.2.2 ant 的配置............................................................................................................6
2.3 JasperReport 的安装与配置..........................................................................................7
2.3.1 JasperReport 的安装..........................................................................................7
2.3.2 JasperReport 的配置..........................................................................................7
2.4 iReport 的安装与配置....................................................................................................8
2.4.1 iReport 的安装....................................................................................................8
2.4.2 iReport 的配置....................................................................................................8
3.iReport 的使用............................................................................................................................8
3.1 启动 iReport 的两种方式...............................................................................................8
3.1.1 在有 ant 环境的下运行 iReport........................................................................8
3.1.2 在没有 ant 的环境下运行 iReport....................................................................8
3.2 iReport 设计环境中的乱码现象的解决........................................................................9
3.3 如何设计一个最简单的报表...........................................................................................9
3.4 如何处理带有中文的报表.............................................................................................10
3.5 使用数据库中的数据生成报表.....................................................................................12
3.5.1 如何设置数据库连接.........................................................................................12
3.5.2 设置 SQL 查询语句.............................................................................................13
3.5.3 增加、修改与删除报表字段.............................................................................14
3.5.4 字段在报表设计器中的使用.............................................................................14
3.5.5 编译与预览带有字段的报表.............................................................................16
3.6 一劳永益的解决中文字体问题.....................................................................................17
3.7 JasperReport 中各 band 的功能..................................................................................18
3.8 在 iReport 中定义与使用参数.....................................................................................22
3.9 怎样定义与使用变量.....................................................................................................23
4. JasperReport 在程序中的应用..............................................................................................24
JasperReport 与 iReport 的配置与使用
第 3 页
4.1 在 JSP 程序中的应用示例.............................................................................................24
4.1.1 JSP 服务器运行环境的配置..............................................................................24
4.1.2 JSP 代码内容......................................................................................................24
4.1.3 运行示例 JSP 程序出错的几种情况及解决方法.............................................25
4.2 在 Servlet 程序中的应用示例.....................................................................................26
4.3 动态 SQL 的示例.............................................................................................................27
4.4 怎样使某个字段中的数据在特定条件下才打印出来.................................................28
4.5 如何将 PDF 格式报表结果直接输出到打印机.............................................................28
5.参考信息及其他.........................................................................................................................29
5.1 iReport 中引用报表中的变量、参数及字段的书写形式..........................................29
5.2 作者的联系方式.............................................................................................................30
5.3 写在最后.........................................................................................................................30
JasperReport 与 iReport 的配置与使用
第 4 页
1.JasperReport 与 iReport 简介
1.1 JasperReport 简介
JasperReport 是一款报表打印组件，是开放源代码组织 sf.net 中的一个 java 报表打印工
程，在我写这篇文章时，JasperReport 的最新版本是 0.5.2 版，JasperReport 的最新版本可以
从 http://jasperreports.sourceforge.net/index.html
下载得到。JasperReport 适合用来做 WEB 应
用程序与 Java Application 的报表打印组件，而且关键的一点是：JasperReport 是免费的！
1.2 iReport 简介
iReport 也是开源组织 sf.net 中的一款免费软件，其主要作用是用来以可视化的方式设计
生成 JasperReport 所使用的报表格式文件，因为 JasperReport 本身并未提供很好的可视化报
表设计工具，iReport 的出现正好弥补了这个缺陷。本文写作时的 iReport 的最新版本是 0.3.0，
iReport 可以从 http://ireport.sourceforge.net
下载得到，注意下载的 iReport 一定要与你所使用
的 JasperReport 版本相匹配，当然您也可以更新 iReport 中所使用的 JasperReport 组件，后面
的文章中会有详细的介绍。
2.安装与配置
2.1 JDK 的安装与配置
2.1.1 JDK 的下载与版本选择
JDK的最新版本可以从 SUN 公的官方网站上下载得到，网址为 http://java.sun.com ，JDK
共分为 3 个版本，J2ME,J2SE,J2EE，因为是在计算机上使用，我们需要下载使用 J2SE SDK，
如果您的计算机是用来做软件开发，需要下载 J2SE SDK，如果是用来运行已经编译好的
JAVA 程序的，可以只下载 J2SE JRE 即可。
下载 JDK 时 SUN 公司会要求你同意一个 JDK 的使用许可协议，选接受协议后，会出
现选择适合不同的操作系统平台使用的 JDK 版本选择的界面，您可以根据自己使用的操作
系统平台选择适合的 JDK 版本。
JasperReport 与 iReport 的配置与使用
第 5 页
2.1.2 JDK 的安装
以 Windows 平台的安装为例，在安装的过程中一路 Next 即可，同时请注意记录下 JDK
安装后的目录，稍后进行配置时要用到。
2.1.3 JDK 的配置
以在 Windows 2000 平台配置 J2SE SDK 为例(注意不是 J2SE JRE)，鼠标右键点击桌面
上的“我的电脑”图标，在弹出的菜单中选择属性，选择“高级”选项，选择“环境变量”，
点击“系统变量”下的新增按钮，在对话框中的变量名处输入大写的 JAVA_HOME，在变量
值处输入 2.1.2 中所记录的 JDK 安装目录，目录名后不要带有“\”。
点击“确定”完成第一步的配置，接下来以同样的方法配置系统环境变量 CLASSPATH，在
CLASSPATH 的变量值处输入%JAVA_HOME%\lib\tools.jar; %JAVA_HOME%\lib\dt.jar，当然，
也可以直接输入绝对路径，但建议使用%JAVA_HOME%的方式。
再接下来还要修改系统环境变量 PATH,增加%JAVA_HOME%\bin 目录。
至此 JDK 的配置也完成，打开一个命令行窗口，键入 set classpath 与 set java_home 应该可
以看到正确的配置信息，同时，输入 javac -version 看系统能否找到 JAVA 的编译器。
