ireport 5.1.0 教程之ireport快速入门文档
ireport图文教程(超详细)(word文档良心出品)

1下载iReportiReport是一个可视化的报表模板设计工具,使用此工具能方便地对报表进行设计。
在iReport中已经包含了jasperreports在运行时需要的jar 文件,在项目中的lib目录中包含Jasperreports-***.jar即可,其中***为版本号,比如2.0.3。
下载地址:/project/showfiles.php?group_id=64348,此文档编写时版本为2.0.3,如图:点击download出现以下界面:可以看到提供了多种下载包,其中:ØiReport-2.0.3-src.zip:为iReport的源代码ØiReport-2.0.3.tar.gz:为.tar.gz格式,一般用于Linux、Unix等非windows系统ØiReport-2.0.3-windows.installer.exe:为exe格式,一般用于windows系统ØiReport-2.0.3.zip:为zip格式,可以用于各类操作系统本文使用window版本为例,因此下载iReport-2.0.3-windows.installer.exe即可。
2安装iReport安装iReport需要先设置JDK环境,2.0.X版本要求JDK1.5环境(另参考文档)。
如果是windows系统,直接双击安装图标即可。
(如果是下载的ZIP文档,则将其解压到指定的目录,还需运行bin/startup.bat)。
如果是其他系统,比如Linux,Unix等,解压下载的安装文件(如下载的是tar.gz格式,使用tar xvfz iReport-2.0.3.tar.gz进行解压,如下载的zip格式,使用zip命令解压),然后运行bin/startup.sh即可。
以下以在windows上安装为例:A.欢迎界面,点击“N ext >”继续B.阅读license内容,点击“I A gree”继续C.选择安装组件,点击“N ext >”继续D.指定安装路径,点击“N ext >”继续E.指定程序组名称,点击“I nstall”即可F.等待安装过程G.安装结束,点击“F inish”完成在桌面上会出现如此图标:。
ireport 5.1.0 教程之ireport快速入门文档

ireport5.1.0教程之ireport快速入门文档必要条件:iReport需要Sun Java2SDK1.4以上版本;为了能编译jasper文件就必须安装完整的java2(JDK),不光是(JRE)这个运行环境。
如果你还想编译iReport 源代码,你还要安装Jakarta Ant version1.6以上版本。
硬件方面,类似于java的环境,iReport也占很多的RAM,所以它也需要只少256Mb的内存和至少20Mb的磁盘空间。
下载:你可以到SourceForge网站上的企业主页上下载最新发布的iReport,可能有几种不同的分类:iReport-x.x.x.zip这是官方的zip格式的二进制文件。
iReport-x.x.x.tgz这是官方的tar gz格式的二进制文件。
iReport-x-x-x-src.zip这是官方的包含源代码的zip格式的二进制文件。
x.x.x表明了iReport的版本号。
每一种都包含必须使用的第三方的库和程序及附加文件,例如模板和一些html格式的基础教程。
如果你想要更多最新版本的源程序,你可以直接地连接CVS库。
但必须要有一个CVS客户端(像CVS,JCVS或者WinCVS)。
如果你有CVS那就执行如下的命令行:cvs-d:pserver:anonymous@:/cvsroot/ireportlogin(目前好象无法连接)and then all on the same line…cvs-z3-d:pserver:anonymous@:/cvsroot/ireportco iReport2这样CVS客户端就可以将iReport的所有文件下载到本地,包括所有的文档,库和所有有用的编译iReport的文件。
就使用其他CVS的用户来说,SourceForge网站也自制了详细的解释用来检出工程。
编译iReport:这些源中包含一个build.xml文件,它是被Jakarta Ant用来编译和启动iReport和或用来创建不同类型的工程。
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都有自己的特性,在报表生成的时候有些会打印一次,有些会打印多次。
如下图。
ireport 5.1.0 教程之饼图制作过程

ireport 5.1.0教程之饼图制作过程Ireport所需环境:ireport4.0.2,mysql5.1目标:饼图,百分比,PDF中文一.DB如图:数据源配置略.创建SQL语句:select count(id)as id,department from piechart group by department;二.创建饼图一路下一步到key and values的时候填写如下:然后完成.拖动改变下大小后点击preview可以查看预览生成结果如下:三.为饼图添加百分比显示在饼图属性里面:填写如下:{0}{2}说明:{0}为名称{1}为数量{2}为百分比在次预览如图:四.PDF预览中文问题4.0.2中pdf预览中文依然存在问题,默认对静态文本将不会显示中文,依旧悲剧.可以采用原来的办法,既加入itext-asian.jar到classpath中,然后修改pdf font name和pdf encoding的办法来显示中文,但这种做法ireport已经抛弃,这里采用另一种做法.下载truetype字体,我下载的是微软雅黑字体:选择[工具]->[选项]->[ireport]下font卡牌栏,install font,然后选择刚下载的字体文件,下一步如图:然后完成.这时候直接预览pdf的话还是悲剧,还要做最后一步修改.在static text的属性里面修改Font name为雅黑字体.然后预览:设计好报表后,把*.jasper文件拷贝到工程中,可以开始编码了,但是上一篇写的只是设计器中预览出现中文,而程序生成的PDF报表依旧不能显示中文,这篇将会做个补充.先填代码吧:Java代码1.package .gkhb.ireport.demo;2.3.import java.sql.Connection;4.import java.sql.DriverManager;5.import java.sql.SQLException;6.import java.util.HashMap;7.8.import net.sf.jasperreports.engine.JRException;9.import net.sf.jasperreports.engine.JRExporter;10.import net.sf.jasperreports.engine.JRExporterParameter;11.import net.sf.jasperreports.engine.JasperFillManager;12.import net.sf.jasperreports.engine.JasperPrint;13.import net.sf.jasperreports.engine.export.JRPdfExporter;14.15./**16.*导入报表为pdf文件17.*/18.public class ExportDemo{19./**20.*报表模板位置21.*/22.private final static String jasperfile="E:/myeclipse/IreportDemo/WebRoot/WEB-INF/jasperfiles/pieChart.jasper";23.24./**25.*目标文件位置26.*/27.private final static String desc="G:/download/font/pie_chart_demo.pdf";28.29./**30.*register database driver for mysql31.*/32.static{33.try{34.Class.forName("com.mysql.jdbc.Driver");35.}catch(ClassNotFoundException ex){36.ex.printStackTrace();37.}38.}39.40.@SuppressWarnings("unchecked")41.public static void main(String[]args){42.HashMap hm=new HashMap();43.try{44.//Fill the report using an empty data source45.JasperPrint print=JasperFillManager.fillReport(jasperfile,hm,connectionProvider());46.47.//Create a PDF exporter48.JRExporter exporter=new JRPdfExporter();49.//JRExporter exporter=new JRHtmlExporter();50.51.//Configure the exporter(set output file name and print object)52.exporter.setParameter(JRExporterParameter.OUTPUT_FILE_NAME,desc);53.exporter.setParameter(JRExporterParameter.JASPER_PRINT,print);54.55.//Export the PDF file56.exporter.exportReport();57.}catch(JRException e){58. e.printStackTrace();59.System.exit(1);60.}catch(Exception e){61. e.printStackTrace();62.System.exit(1);63.}64.}65.66./**67.*database connection provider68.*@return69.*/70.protected static Connection connectionProvider(){71.Connection connection=null;72.String url="jdbc:mysql://localhost:3306/test";73.String user="root";74.String password="";75.try{76.connection=DriverManager.getConnection(url,user,password);77.}catch(SQLException ex){78.ex.printStackTrace();79.}80.return connection;81.}82.83./*84.*jpeg85.JasperPrint jasperPrint=JasperFillManager.fillReport(jasperReport,parameters_header,dataSource);86.out=response.getOutputStream();87.JasperExportManager.exportReportToPdfStream(jasperPrint,out);88.89.if(printType==0)//if pdf stream90.{91.JasperExportManager.exportReportToPdfStream(jasperPrint,out);92.}else{//if jpeg image stream93.int pageIndex=0;94.BufferedImage pageImage=new BufferedImage(jasperPrint.getPageWidth()+1,jasperPrint.getPageHeight()+1,BufferedIma ge.TYPE_INT_RGB);95.JRGraphics2DExporter exporter=new JRGraphics2DExporter();96.exporter.setParameter(JRExporterParameter.JASPER_PRINT,jasperPrint);97.exporter.setParameter(JRGraphics2DExporterParameter.GRAPHICS_2D,pageImage.getGraphics());98.exporter.setParameter(JRExporterParameter.PAGE_INDEX,new Integer(pageIndex));99.exporter.exportReport();100.ImageIO.write(pageImage,"jpeg",out);101.}102.out.close();103.*/104.}这个时候如果需要PDF生成后显示中文,需要把安装的字体打包成JAR导入classpath中去,步骤如下:进入ireport安装目录下,然后进入:\ireport\fonts文件夹,用将文件夹下所有内容直接打包成zip,修改后缀为jar,加入到项目classpath就OK了,此时应该就能生成pdf中有中文显示了同为比较常用的java报表生成工具,FineReport对饼图的解决方案和实现方法与ireport有所不同,具体实现思路和步骤如下,供ireport使用者借鉴:复合饼图和复合条饼图1.问题描述当饼图中的多个数据点均小于饼图的10%时,便很难辨别扇区,怎样使小扇区在饼图中更清晰可见,这时就可以使用第二绘图区制作复合饼图或者复合条饼图来解决,如下图效果:复合饼图复合条饼图2.实现原理复合饼图和复合条饼图将小扇区从主饼图中分离出来,放在第二绘图区,可设置为饼图或堆积条形图,百分比的大小还可手动设置。
iReport使用文档

目录1.快速入门 (1)1.1连接配置 (1)1.1.1添加一个JDBC连接 (1)1.2报表配置 (4)1.2.1报表配置 (4)2.认识进价 (9)2.1界面认识 (9)2.1.1主页面 (9)2.1.2 Report Inspector: (10)2.1.3组件面板 (10)3.学以致用 (11)3.1报表制作 (11)3.1.1简单报表示例 (11)3.1.2添加框线 (13)3.1.3单元格中添加颜色 (15)3.1.4单元格颜色奇偶行显示 (16)3.2组件使用 (19)3.2.1交叉表(Crosstab组件) (19)3.2.2图形报表(Chart组件): (24)3.2.3子报表(Subreport组件) (27)3.24 表格(Table组件) (31)4.深入研究 (34)4.1函数使用 (34)4.1.1 Sum函数 (34)4.2数据连接 (37)4.2.1超链接 (37)5.工具使用 (42)5.1 Web展示工具 (42)5.1.1 Web展示工具安装 (42)5.1.2 Web展示工具配置 (45)1.快速入门1.1连接配置1.1.1添加一个JDBC连接1、页面介绍:“Recent report”最近打开的报表;“Step1”建立数据连接;“Step2”新建报表;“Step3”运行、预览报表2、点击Step1开始建立连接3、选择“数据源”4、连接JDBC如果没有该数据库的JCBC驱动jar包,iReport会很智能的用红色来显示该驱动的名称,所有你赶快找到该驱动jar包。
5、JDBC的配置6、测试连接是否成功1.2报表配置1.2.1报表配置1、完成数据库的连接之后就开始设计自己报表,点击“Step2”2、选择报表样式3、报表命名及存储路径的选择4、数据源选择5、选择表6、选择字段7、选择字段后展示8、根据你设计表的样式选择需要的字段9、这次做的是简单的报表,“Group by”跳过10、报表创建完成2.认识进价2.1界面认识2.1.1主页面1、每一个部分我们叫它为“band”Title:title段只在整个报表中的第一页的最上面部分显示,除了第一页以外,不管报表中共有多少个页面也不会出现Title bandPage Header:Page Header段中的内容将会在整个报表中的每一个页面中都会出现,显示在页面的上部Column Header:针对Detail Band的表头段,一般情况下在这个段中画报表的表头Detail:报表内容段,在这个Band中设计报表中需要重复出现的内容,Detail段中的内容每页都会出现Column Footer:正对Detail Band的表尾段Page Footer:显示在所在页面的最下端Summary:表格的合计段,出现在整个报表的最后一页中的Detail Band的后面,一般用来统计报表中某一个或某几个字段的合计值2.1.2 Report Inspector:2.1.3组件面板组件面板包括:Break(分页)组件、Chart(图形)组件、Crosstab(交叉表)组件、Frame (框架)组件、Image(图片)组件、Barcode(条形码)组件、generic element(通用元素)组件、List(列表)组件、Spider Chart(蜘蛛图)组件、Round Rectangle(圆角矩形)组件、Table(表格)组件、Line(线条)组件、Map(地图)组件、Rectangle(矩形)组件、Sort(分类)组件、Subreport(子报表)组件Text Field(文本字段)组件、Static Text(静态文本)组件。
iReport使用教程(示例教程)

iReport使⽤教程(⽰例教程)在使⽤ireport的过程中,因为各种功能都要百度,但是⼤家使⽤的例⼦⼜千差万别让⼈很苦恼,所以⽤⼀个简单例⼦贯穿的展⽰⼀下ireport的常见功能。
iReport简介说到iReport不得不先介绍Jasperreport,Jasperreport是⼀个报表制作程序,⽤户需要按照它制定的规则编写⼀个XML⽂件,然后得到⽤户需要输出的格式⽂件。
它⽀持输出的⽂件格式包括PDF,HTML,XML,XLS,CVS等等。
⽽iReport就是⼀个制作Jasperreport的XML⽂件的可视化开发⼯具。
只是⼀个UI。
我使⽤的是iReport 3.5.1,使⽤的⽰例数据表如图:sales表:(⼈名、⼤致结构来⾃帆软电⼦⽂档,如有雷同,⽆意冒犯)sellers表:报表结构左边是view区,联系着主设计区中的各个band区域的数据,以及参数、变量等。
中间是主设计区,通过拖拽控件⾯板可以在此区域进⾏设计,有三种模式:设计(Designer)、源码(Xml)、预览(Preview),设计模式是可视的,源码⽅式可以直接在上修改,预览是对设计好的报表样式进⾏预览,也是⼀个编译的过程;右边是控件⾯板和属性⾯板,可以在此使⽤控件和设置属性。
JasperReport有三个⽅式来保持数据:Field、Paramrter、Variables。
⼀般情况下,Field是⽤作保存从数据源取出来的数据,⽤法是;Parameter是⽤来占位—我们在设计时往往不知道具体的值,那么⽤⼀个参数来占住它们的位置,在执⾏时,从程序或者数据库中传递对应的参数过来,从⽽实现⼀个动态的过程,⽤法是Variables是变量,可以将变量⽤于TextFild表达式中,也可以设置它的属性,使它具有⼀些功能,如求和,求平均数等,⽤法是数据源ireport提供很多种数据源的连接⽅式,点上⽅的数据库标识就可以设置数据库,下⽅的数据标识⽤来写SQL语句获取数据。
iReport使用教程

一、iReport简介说到iReport不得不先介绍Jasperreport,Jasperreport是一个报表制作程序,用户需要按照它制定的规则编写一个XML文件,然后得到用户需要输出的格式文件。
它支持输出的文件格式包括PDF,HTML,XML,XLS,CVS等等。
而iReport就是一个制作Jasperreport的XML文件的可视化开发工具。
只是一个UI。
二、安装说明2.1 基本安装现在最新的版本是iReport 0.5.1 (Aug 27, 2005).下载后解压然后在根目录双击iReport.bat就可以用了,但是为了可以使用external ttf font还必须要把 iReport-0.5.1/fonts 加到环境变量里面去。
2.2 了解制作报表用的包下载后到到 iReport-0.5.1/lib 里看看,你就可以发现iReport的真面目了。
(1) jasperreports-1.0.1.jarjasperreports 是iReport的核心内容。
它是一个强力的报表产生工具,他有能力描述丰富内容到屏幕上、到打印机或到PDF, HTML, XLS, CSV和XML文件。
它完全用Java编写的,并可在各种Java应用(包括J2EE或WEB应用)中用来产生动态内容。
它的主要目的是以一种简单而灵活的方式来帮助创建导向的页面。
JasperReports组织根据在一个XML文件中定义的报表设计通过JDBC来接受来自一个关系数据库中的数据. 为了以数据来填充报表,报表设计必须首先被编译。
jasperreports的官方网站:/(2) itext-1.3.1.jariText是一个开放源码的Java类库,是用来生成PDF文件的。
iText的官方网站:如果要在生成的pdf文件显示中文等亚洲字符,还必须下载itext的亚洲字符包。
tTextAsian的官方下载地址:/downloads/iTextAsian.jar(3) jfreechart-1.0.0-rc1.jarjfreechart是一款免费的、功能强大的统计图生成工具,可以直接生成PNG,JPG 等各式的文件。
iReport工具使用说明

1.1iReport工具使用说明1.1.1iReport 的使用iReport 是一个能够创建复杂报表的开源项目,它用纯java语言编写,是目前全球最为流行的开源报表设计器之一。
一、iReport运行环境iReport运行时需要SUN JAVA2 SDK 1.5及以上版本,为能编译我们的报表文件需要安装完整的JDK 注:在本文中iReport的版本是3.7.0二、报表结构栏(Bands)报表被分为若干个部分,每一个部分我们叫它“band”,每一个band都有自己的特性,在报表生成的时候有些会打印依次,有些会打印多次。
新建一个报表都会出现这7种类型的band,下面是对每一种类型的band分别介绍:Title:它是报表的标题。
Title段只在整个报表的第一页的最上面部分显示,除了第一页,不管报表中有多少页都不会再显示Title中的内容.Page Header:page Header段的内容将会在整个报表中的每一个页面中都会出现,显示的位置在页面的上部。
若是报表的第一页,Page Header的内容将显示在Title的下面。
除了页以外的的其他所有页面中,Page Header的内容都会显示在页面的最上端。
即页眉Column Header: 它是针对Detail的表头段,一般情况下在这个段画报表的标头。
Detail:它是报表的内容段,在此段中设计报表中需要重复出现的内容,detail段中的内容每页都会出现。
Column Footer:针对detail段的表尾端。
Page Footer:显示在页面的最下端,与Page Header想对。
即页脚Summary:表格的合计段,出现在整个报表的最后一页的Detail段的后边,一般用来统计报表中某一个或某几个字段的合计值。
三、测试每种类型栏的作用首先我们需要在报表中的每种类型的栏中添加不同的对象,来测试每种类型栏的作用。
第一步:选择“文件”点击new弹出如下对话框选择需要的模板点击“Open this Template”弹出如下图示修改Report name为:MyReport 选择保存路径点击下一步弹出“Congratluations!”点击完成。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
ireport5.1.0教程之ireport快速入门文档必要条件:iReport需要Sun Java2SDK1.4以上版本;为了能编译jasper文件就必须安装完整的java2(JDK),不光是(JRE)这个运行环境。
如果你还想编译iReport 源代码,你还要安装Jakarta Ant version1.6以上版本。
硬件方面,类似于java的环境,iReport也占很多的RAM,所以它也需要只少256Mb的内存和至少20Mb的磁盘空间。
下载:你可以到SourceForge网站上的企业主页上下载最新发布的iReport,可能有几种不同的分类:iReport-x.x.x.zip这是官方的zip格式的二进制文件。
iReport-x.x.x.tgz这是官方的tar gz格式的二进制文件。
iReport-x-x-x-src.zip这是官方的包含源代码的zip格式的二进制文件。
x.x.x表明了iReport的版本号。
每一种都包含必须使用的第三方的库和程序及附加文件,例如模板和一些html格式的基础教程。
如果你想要更多最新版本的源程序,你可以直接地连接CVS库。
但必须要有一个CVS客户端(像CVS,JCVS或者WinCVS)。
如果你有CVS那就执行如下的命令行:cvs-d:pserver:anonymous@:/cvsroot/ireportlogin(目前好象无法连接)and then all on the same line…cvs-z3-d:pserver:anonymous@:/cvsroot/ireportco iReport2这样CVS客户端就可以将iReport的所有文件下载到本地,包括所有的文档,库和所有有用的编译iReport的文件。
就使用其他CVS的用户来说,SourceForge网站也自制了详细的解释用来检出工程。
编译iReport:这些源中包含一个build.xml文件,它是被Jakarta Ant用来编译和启动iReport和或用来创建不同类型的工程。
下载iReport-x.x.x-src.zip,解压缩到你指定的目录,例如:c:\devel(or/usr/devel on unix system)。
打开命令提示符或shell,进入你解压的目录和iReport目录:C:\devel\iReport-0.3.2>ant iReport如果这个源完整的存在与目录中,它将被编译进类中iReport就能直接启动。
基本的配置:如果选择下载了iReport二进制版本的,那就直接将该压缩文件解压缩到指定目录,例如:c:\devel(or/usr/devel on a unix system).打开命令提示符或shell,进入被解压缩的目录,输入iReport目录:C:\devel\iReport-0.3.2>iReport.bator on unix:$./iReport.sh(in this case,it should be preceded by a“chmod+x”if the file is not executable.)第一步执行完毕时iReport将创建一个名叫”.ireport”的文件在用户的主目录。
这里的主目录指由自己设置和配置的目录。
如果文件夹不能被创建,这就有可能是解压缩造成的影响而不能够配置成功,这时,你就要自己手动的创建一个目录。
进行下一步之前你需要将tools.jar文件拷贝到JDK的lib目录下以及iReport 的lib目录下。
如果没有这个文件的话在编译report时将会产生一些异常(carried out by using classes contained in this java library).在MacOS X系统中tools.jar文件就不需要拉,因为具有编译ireport所必须的类的classes.jar文件代替它。
iReport的初始化配置包括:设置所要查看运行后的文档的格式;选择语言;设置编译后的文件目录。
其他的配置说明将在以下进行。
为了继续的进行配置必须打开ireport,然后选择菜单选项中工具选项(menu Options→Tools.)。
此时将出现2.1选项窗口。
2.1图选择你最熟悉的语言接下来点“Compiler”选项卡。
2.2图这个选项卡是用来设置编译后的文件存储目录,默认的目录会在iReport的根目录。
一般情况下是要指定一个有效的目录来保存编译文件。
这个目录也可以是加载报表源时的目录,既然这样就选择“Use the reports directory for compiles”复选框。
2.3图完成以上列出的配置后,接下来我们还要设置报表输出格式和查看XML源所用编辑器。
重启iReport继续设置上图的选项。
创建一个空白报表测试一下我们的设置(menu File→New Document),领悟一下iReport所提供的功能。
之后点工具条上的运行按扭。
如果你操作的正确,将会有一个保存jrxml文件的提示,相应的一个jrxml文件将被创建,之后会发布出一个预先设置的空白页。
这就意味着你刚才的配置ok拉。
创建JDBC连接:一个有代表性的关系数据库可以提供最普通的数据源给一个报表。
首先,我们来看看如何设置一个JDBC连接,点菜单D atasourceConnections/Datasources并点窗口的连接列表的new按扭。
此时打开一个新建连接(图2.4)窗口。
在这个面板上填写连接名:(i.e.“My new connection”)并选择正确的JDBC驱动。
iReport支持大部分的JDBC驱动URL格式。
因此你能够自动创建一个URL通过在相应的输入框中填写服务器地址和数据库名。
若要完成连接你就必须输入数据库名和密码用来连接数据库。
如果你想保存密码,那就将“Save password”打对勾。
注意:iReport将密码保存在一个txt文件中,如果你不想保存密码就不要选择“Save password”复选框…点test按扭测试一下连接,不过最好是再保存之前测试。
2.4图iReport被装入的JDBC驱动只有MYSQL和HSQLDB。
如果在测试期间发现有ClassNotFound异常,很有可能是能被选择的驱动的classpath中不包含JAR或(ZIP)文件。
不用关闭iReport,拷贝这个JDBC驱动到lib目录下,重试一下;这个JAR将被重新被iReport加载。
在第十章,我们将深入广泛的解释所有的数据源的配置形式。
测试通过后按保存按钮保存连接。
通过这种方式我创建了一个新的数据源,这样iReport就可以将它作为预置的数据源来使用。
选择菜单中“build→Set active connection”项目。
2.5图从列表中选择我们的连接按OK按钮(图2.5).那么iReport就会在需要使用数据库时用这个连接(我们想要字段就可以通过SQL查询和打印来创建)。
第一个报表:现在我们已经安装配置了iReport,并创建了一个JDBC连接数据库,接下来我们将创建一个简单的报表用这个向导。
这个例子以及以后的所有例子我们都用HSQL数据库引擎(HSQLDB),它是一个小型的用java编写的关系型数据库,而且提供了JDBC驱动。
如果用它的话,我们就必须拷贝hsqldb.jar文件到libs目录(这个文件已经在0.3.2版本之后都包含在发布文件中了)。
为了能了解到更多的关于这个小家伙的信息,就登陆HSQLDB的官方网站.为了能设置一个有效的数据库连接我们给出以下例子(来源与本手册);使用以下参数:Proprieties ValueName NorthwindJDBC Driver org.hsqldb.jdbcDriverJDBC Url jdbc:hsqldb:c:/devel/northwind/northwindUsername saPassword表格2.1配置的最后请设置Northwind作为一个有效的连接(Build→Set active connection)。
选择菜单“File→Report Wizard”.这是一个用来一步步创建报表的工具。
图2.6在文本区域输入SQL查询用来充当报表中的数据,例如:select*from customers order by country…点Next.这里的分组选项是非常重要的一条。
接下来我们将详细讨论。
iReport将读取customers表的这些字段(图2.7).图2.7选择你需要的字段然后点Next.你会得到一个提示:你希望从这些被选择到报表中的那个字段用来分组(即便要)(图2.8)…图2.8根据这个向导,你最多可以创建四个组。
其他的可以随后来定义(事实上它是可以设置很多组的)。
我们将定义一个简单的组用COUNTRY字段(图.2.8).下一步向导会让你选择一个能被用来创建一个基本报表的模板。
iReport提供了一些非常简单摸板供选择,接下来我将试着创建一个新模板。
目前我们知道的有两种类型的模板:the tabular templates,所有的记录都在同一条表格线内,一个字段后面跟的一个数据。
the columnar templates,这里是将字段按列排列,每列一个字段,下面将是所有数据。
图2.9第一个报表选择tabular模板,它是著名的T样式(T的意思就是tabular)。
一但你选择这个模板,那就点next。
之后向导将展示我们操作的结果。
点Finish来创建这个报表,它将展现在iReport的中央区域,等待被执行。
执行之前你得先保存报表源,这样它才能被用来编译创建报表。
该如何编译创建呢?你可以点工具条上按钮(使用连接的运行报表)。
图2.10接下来你就点这个带连接的运行报表按钮,此时将会提示你输入你个文件名来保存这个文件。
可以以report1.jrxml的文件名来保存。
在控制面板上的下面的窗口将会有一些提示信息。
这些信息就是告诉你发生了什么事:一个报表被编译,并完成创建,输出“exported”图2.11操作完成后,如果不出以外,这个报表将以缺省的PDF格式展示在你面前,原因是你最初设置输出格式为PDF。
命令行选项:可能有一些特殊的参数出现在命令行上。
所有的参数不区分大小写的。
特们能被缩写知道最短(例如:这个命令:–ireport-home c就可以被指定为–i;并不是它因为以“i”开头;命令解释器将认为-i是一个不明确是否是–ireport-home选项).根据需要Boolean型选项可能被指定用缩写型–opzione和扩展型–opzione=true或–opzione=false。
以下命令可以得到命令选项的列表:iReport.bat-?或./iReport.sh-?以下的表格能解释不同的有效选项,它引用0.4.1版本,可能不能完成所有连续的版本。