iReprt中文教程.doc

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) 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(不会变动的文字)