《ireport开发说明文档》由会员分享，可在线阅读，更多相关《ireport开发说明文档（70页珍藏版）》请在金锄头文库上搜索。
1、iReport用户手册目录 Giulio Toffoli11 序言6什么是iReport?6功能特点：7iReport 社区：7鸣谢：82 入门8必要条件：8下载：9编译iReport：9基本的配置：9创建JDBC连接：12第一个报表：13命令行选项：173 JasperReports基础概念17JasperReports17报表生命周期：18Jrxml源代码和jasper文件：18数据源和打印格式：22版本兼容性：23表达式：24一个简单的程序：254 报表结构26Bands26Title27Page header27Column header27Group header28Detail28
2、Group footer28Column footer28Page footer28Last Page footer28Summary29Background29报表属性：29列30高级选项：32脚本：32更多33Title on a new page选项：33Summary on a new page选项：35Floating column footer 选项：35打印顺序：35无数据打印（如果没有数据时）：36i18n：36Resource Bundle Base name36XML源文件的编码设置：375 报表元素37选择并插入元素到报表中：37布置和元素顺序40使用元素树管理元素：43
3、基本属性：43线46矩形46椭圆47图象47文本元素50静态文本51文本域51子报表55专用元素56图表56条形码56超连接58Reference59LocalAnchor59LocalPage59RemoteAnchor59RemotePage596 字体59字体59扩展字体60编码61使用Unicode字符61报表字体617 字段，参数和变量62字段62SQL查询的字段注册63JavaBean的字段注册64JRExtendedBeanDataSource的字段注册65字段和文本域65参数66在查询中使用参数67使用程序传递参数67内置参数69变量69内置变量718 Bands and gr
4、oups71Bands71Groups729 Subreport77创建子报表78连接子报表到父报表78参数的通道78指定数据源79指定子报表80一步一步举例80返回参数8610 数据源87iReport中的数据源88JDBC连接89ClassNotFoundException91URL不正确91连接参数不正确91使用JDBC连接91字段注册92JRDataSource接口93JavaBean作为数据源93JavaBean的一个字段作为数据源95XML数据源96字段的注册98XML和子报表100CSV数据源104字段的注册105JREmptyDataSource105实现一个新的JRDataS
5、ource106用iReport实现个性化的JRDataSource108JavaBean Extended数据源11011 国际化111Resource Bundle Base Name111恢复本地化字符串113格式化消息114配置本地化报表11412 脚本115JRAbstractScriptlet类115iReport处理脚本117用脚本部署报表11813 模板119模版结构：119使用通用模板12114 图表123创建一个简单的图表123级Series128自动级129手动级130图表类型和属性132饼图1333D饼图133柱状图1343D柱状图136线图136区域图13715 插件
6、和附加工具137插件结构XML文件138it.businesslogic.ireport.plugin.IReportPlugin类139大型编译器插件142文本向导插件14416 常规问题解决方案145打印百分比145计算组的发生数146分离detail148插入一个页149交叉报表152使用多重连接找回数据152如何使用存储过程1531 序言什么是iReport?iReport是一个能够创建复杂报表的开源项目，并且它能调用JasperReports库应用于任何一种java应用程序。本身是分布式的且由符合GNU通用公共许可的百分之百纯java编写。由于它丰富的图形界面，你能够很快的创建出任何
7、一种你想要的报表。iReport能够让我们提高技术方面的信心，比如它能降低学习JasperReports的XML语法的难度，而且能够为熟练的技术人员节省大量的时间并能开发出非常精细的报表。这里将带给大家的虽然是0.4.1版本的，但是大部分的资源都是来自于0.2.0版本发布之后的。因为早先的0.2.0版本不是用java编写的，而是用Visual J+；因此这些版本都只能在微软的Windows 系统运行，自从0.2.0版本发布以后便停止了用Visual J+的开发。我的任务就将最新的版本的iReport介绍给大家，因此，我不可能应用老的版本讲解。 功能特点：以下将列出iRreport的一些比较突出
8、的功能： 百分之九十九支持JasperReports XML标签 所见即所得的报表编辑器，也就是说它具有创建矩形，线，椭圆，正文区域，标签，图表，子报表，条码等完善的工具图标供使用。 嵌入式编辑器带有灯泡提示代码规则 支持Unicode和非拉丁语言（俄文，中文，日文，韩文） 文档结构浏览器 完善的报表编译器和输出器 支持所有可以通过JDBC连接的数据库 支持所有有效的数据源 自动报表创建向导 支持子报表 源文件的备份 支持文档模版 支持TrueType字型 支持本地化 可添加插件扩展功能 完全支持脚本 支持图表 标准对象库管理（页码） 支持拖拽 无限制的取消/重做iReport开发团队是那些来
9、自世界各地的工程师，他们默默无闻的用他们熟练的技术和丰富的经验日负一日的为iReport添加功能排除bugs。iReport 社区：iReport网址是http:/; 企业的网址是http:/ Discussion: 这个社区是用来发布注释，判定讨论结果和提出新的功能建议的。http:/ gtbusinesslogic.it.请将你发现的bug的记录发送到：http:/ 也可以进一步的提出要求(RFE). 有能力的也可以提出不足并发表完整的代码。为了能始终了解关于最新的项目的开发情况你可以将你的邮件地址加到我们的邮件列表中：http:/ 的结晶来自于许多人。但是一些人正在被我们遗忘，我很荣幸的
10、感谢以下为我们工程作出贡献的一些人：Teodor Danciu, Alexander, Andre Legendre, Craig BSpengler, David Walters, Egon R Pereira, ErtanO, G Raghavan, Heiko Wenzel,Kees Kuip, Octavio Luna, Peter Henderson, Vinod Kumar Singh, Wade Chandler,Erica Pastorello以及所有的评论家。2 入门在这章我们将看到使用iReport之前的必要步奏，如何获得二进制的分发和源程序和如何编译和安装它。必要条件：i
11、Report需要Sun Java 2 SDK 1.4以上版本; 为了能编译jasper文件就必须安装完整的java2（JDK），不光是(JRE)这个运行环境。如果你还想编译iReport源代码，你还要安装Jakarta Ant version 1.6以上版本。硬件方面，类似于java的环境，iReport也占很多的RAM，所以它也需要只少256Mb 的内存和至少20Mb的磁盘空间。下载：你可以到SourceForge网站上的企业主页上下载最新发布的iReport(http:/ 可能有几种不同的分类：iReport-x.x.x.zip 这是官方的zip格式的二进制文件。iReport-x.x.x
12、.tgz 这是官方的tar gz格式的二进制文件。iReport-x-x-x-src.zip 这是官方的包含源代码的zip格式的二进制文件。x.x.x表明了iReport的版本号。每一种都包含必须使用的第三方的库和程序及附加文件 ，例如模板和一些html格式的基础教程。如果你想要更多最新版本的源程序，你可以直接地连接CVS库。但必须要有一个CVS客户端（像CVS，JCVS或者WinCVS）。如果你有CVS那就执行如下的命令行：cvs -d:pserver::/cvsroot/ireport login （目前好象无法连接）and then all on the same linecvs -z3 -d:pserver:anonymouscvs.ireport.
