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.jar jasperreports 是iReport的核心内容。它是一个强力的报表产生工具，他有能力描述丰富内容到屏幕上、到打印机或到PDF, HTML, XLS, CSV和XML文件。它完全用Java编写的，并可在各种Java应用（包括J2EE或WEB应用）中用来产生动态内容。它的主要目的是以一种简单而灵活 的方式来帮助创建导向的页面。 JasperReports组织根据在一个XML文件中定义的报表设计通过JDBC来接受来自一个关系数据库中的数据. 为了以数据来填充报表，报表设计必须首先被编译。 jasperreports的官方网站:http://jasperreports.sourceforge.net/ (2) itext-1.3.1.jar iText是一个开放源码的Java类库，是用来生成PDF文件的。 iText的官方网站:http://itext.sourceforge.net 如果要在生成的pdf文件显示中文等亚洲字符，还必须下载itext的亚洲字符包。 tTextAsian的官方下载地址:http://itextdocs.lowagie.com/downloads/iTextAsian.jar (3) jfreechart-1.0.0-rc1.jar jfreechart是一款免费的、功能强大的统计图生成工具，可以直接生成PNG,JPG等各式的文件。 这些图表包括：饼图、柱状图(普通柱状图以及堆栈柱状图)、线图、区域图、分布图、混合图、甘特图以及一些仪表盘等等。 jfreechart的官方下载地址:http://www.jfree.org/jfreechart/ (4) jcommon-1.0.0-rc1.jar JCommon 是一组有用的classes集合.它已经用在JFreeChart,JFreeReport与其它项目上. 这个类库包含了以下功能: 文本工具类(text utilities), 用来显示关于应用程序信息的用户界面类,布局定制管理器,一个日期选择面板,序列化工具类,XML解析器支持类. jcommon的官方下载地址:http://www.jfree.org/jcommon/ (5) poi-2.0-final-20040126.jar Apache 的Jakata项目的POI子项目，目标是处理ole2对象。目前比较成熟的是HSSF接口，处理MS Excel（97-2002）对象。它不象我们仅仅是用csv生成的没有格式的可以由Excel转换的东西，而是真正的Excel对象，你可以控制一些属 性如sheet,cell等等。 直接调用poi包的不是ireport，而是jasperreport。 poi的官方下载地址:http://www.apache.org/dyn/closer.cgi/jakarta/poi/ 这些是用来制作报表用的包，所以可以用最新的版本来代替原有包。但是务必保持与项目中的包一致，因为很多开源的项目都不向下兼容。(例如jasperreport) 三、制作jrxml、jasper 3.1 选择语言 Tools->Option->General->Language 3.2 连接数据库 资料来源->连结/资料来源 如果要使用mysql以外的数据库,要保证jdbc包在环境变量里。放到iReport-0.5.1/lib 下也可以。name相当于一个JNDI。添好后点击test按钮如果显示成功就可以执行下一步了。 3.3 新建一个Report 定位可以控制报表是横向的还是纵向的。Portrait是纵向,Landscape是横向。 边距是可以调整的。 3.4 基本域 title域用来放报表的总标题 pageHeaher域顾名思义页头 columnHeader域是用来放static text的，也就是不循环的部分。 detail域是用来放text field的，也就是循环部分。 pageFooter域是用来放本页的统计参数的。 summary域是用来放整个表的统计参数的。 可以直接调整每个域的长度，也可以通过Band properties来调整。当然总长度是不会超过页面的原长。 3.5 报表查询 3.5.1 为报表添加SQL查询语句 资料来源->报表查询 在Report SQL query里填写SQl语句。如果语句正确,在下面的field里就会显示正常的表字段。 3.5.2 为报表添加动态字段 预览->报表字段 把fields里的字段直接拖到报表上就行了。 3.5.3 为SQL语句添加参数 预览->报表参数 在parameters里新增一个参数 paratemeter name 是参数名，在SQL语句里写成"$P{参数名}" paratemeter class type里选择参数类型。 注意:如果是int型的数据，最好在报表字段里将该字段的Class type改成java.lang.String型的。 另外一种办法,不管该字段原来是什么数据类型,直接在paratemeter class type里选择java.lang.String类型，然后在Default value expression 填写"Integer.toString(整数)"。 3.5.4 添加报表变量 预览->报表变量 $V{变量名} 3.5.5 处理字体 3.5.5.1 基本设置 选中字段->右键->properties->font(双击也可以) Report font 选择全局的字体(仅限于该报表) Font name 选择在ireport里面显示的字体 Pdf font name 选择在pdf里面显示的字体 Rotation 选择内容是否旋转(很有用的选项) PDF Encoding 中文要用UniGB-UCS2-H,外部字体要选Identity-H 3.5.5.2 选择外部字体 第一步 先在Pdf font name里选择External TTF font，然后在下面的Ture Type font里选择外部字体，当然要用的外部字体放在iReport-0.5.1/fonts目录下面。 第二步 在web项目的WEB-INF/classes/下面放要用到的外部字体，才能在程序里正常显示。 3.5.5.3 设定该报表的全局字体 预览->报表字型 3.6 编译jrxml 建立->编译 编译后生成一个后缀名为jasper的binary文件,可以直接给程序调用。 四、web项目应用 4.1 jsp输出PDF报表 4.1.1 需要放到项目里的包 itext-1.3.1.jar iTextAsian.jar jasperreports-1.0.1.jar 4.1.2 输出PDF注意事项: 4.1.3 jsp输出PDF的例子 <%@ page import="java.sql.*" %> <%@ page import="java.util.*" %> <%@ page import="java.io.*" %> <%@ page import="net.sf.jasperreports.engine.JasperFillManager" %> <%@ page import="net.sf.jasperreports.engine.JasperPrint"%> <%@ page import="net.sf.jasperreports.engine.JRException"%> <%@ page import="net.sf.jasperreports.engine.JasperRunManager"%>//pdf <% String rowid = "1";//初始化变量 Connection conn= DriverManager.getConnection("proxool.test");//从数据源连接数据库 //装载jasper文件application File exe_rpt = new File(application.getRealPath("/reports/test.jasper")); //rowid就是iReport的变量$P{rowid}的名称 Map parameters = new HashMap(); parameters.put("rowid",rowid); try{ // fill JasperPrint jasperPrint = JasperFillManager.fillReport(exe_rpt.getPath(),parameters,conn); // 生成pdf byte[] bytes = JasperRunManager.runReportToPdf(exe_rpt.getPath(),parameters,conn); response.setContentType("application/pdf"); response.setContentLength(bytes.length); ServletOutputStream ouputStream = response.getOutputStream(); ouputStream.write(bytes,0,bytes.length); ouputStream.flush(); ouputStream.close(); conn.close(); }catch(JRException ex){ out.print("Jasper Output Error:"+ex.getMessage()); } %> 4.2 jsp输出EXCEL报表 4.2.1 需要放到项目里的包 jasperreports-1.0.1.jar poi-2.0-final-20040126.jar 4.2.2 输出excel要注意的: (1) 输出excel报表必须fields的边界刚好填充满整个页面,不然会有大量的空白出现。 (2) 删除记录最下面的空行需要加上参数 exporter.setParameter(JRXlsExporterParameter.IS_REMOVE_EMPTY_SPACE_BETWEEN_ROWS,Boolean.TRUE); (3) 删除多余的ColumnHeader需要加上参数 exporter.setParameter(JRXlsExporterParameter.IS_ONE_PAGE_PER_SHEET,Boolean.FALSE); (4) 在ireport里给fields加上border,那输出的excel就会有很黑的边框，跟excel默认的灰度边框就会很不协调。但是如果不加border,在输出的excel里就不会显示每个表格的边框。 解决方法是: 第一步 在选中字段->右键->properties->Common->Transparent 打上勾。 第二步 在输出的jsp页面加上参数 exporter.setParameter(JRXlsExporterParameter.IS_WHITE_PAGE_BACKGROUND,Boolean.FALSE); 4.2.3 jsp输出EXCEL的例子 <%@ page import="java.sql.*" %> <%@ page import="java.util.*" %> <%@ page import="java.io.*" %> <%@ page import="net.sf.jasperreports.engine.JasperFillManager" %> <%@ page import="net.sf.jasperreports.engine.JasperPrint"%> <%@ page import="net.sf.jasperreports.engine.JRException"%> <%@ page import="net.sf.jasperreports.engine.JRExporterParameter"%>//excel <%@ page import="net.sf.jasperreports.engine.export.JRXlsExporterParameter"%>//excel <%@ page import="net.sf.jasperreports.engine.export.JRXlsExporter"%>//excel <% String rowid = "1"; Connection conn= DriverManager.getConnection("proxool.test"); //装载jasper文件application File exe_rpt = new File(application.getRealPath("/excel/test_excel.jasper")); //rowid就是iReport的变量$P{rowid}的名称 Map parameters = new HashMap(); parameters.put("rowid",rowid); try{ // fill JasperPrint jasperPrint = JasperFillManager.fillReport(exe_rpt.getPath(),parameters,conn); // excel输出 ByteArrayOutputStream oStream = new ByteArrayOutputStream(); JRXlsExporter exporter = new JRXlsExporter(); exporter.setParameter(JRExporterParameter.JASPER_PRINT, jasperPrint); exporter.setParameter(JRExporterParameter.OUTPUT_STREAM, oStream); exporter.setParameter(JRXlsExporterParameter.IS_REMOVE_EMPTY_SPACE_BETWEEN_ROWS,Boolean.TRUE); // 删除记录最下面的空行 exporter.setParameter(JRXlsExporterParameter.IS_ONE_PAGE_PER_SHEET,Boolean.FALSE);// 删除多余的ColumnHeader exporter.setParameter(JRXlsExporterParameter.IS_WHITE_PAGE_BACKGROUND,Boolean.FALSE);// 显示边框 exporter.exportReport(); byte[] bytes = oStream.toByteArray(); if(bytes != null && bytes.length > 0) { response.reset(); response.setContentType("application/vnd.ms-excel"); response.setContentLength(bytes.length); ServletOutputStream ouputStream = response.getOutputStream(); ouputStream.write(bytes,0,bytes.length); ouputStream.flush(); ouputStream.close(); }else{ out.print("bytes were null!"); } conn.close(); }catch(JRException ex){ out.print("Jasper Output Error:"+ex.getMessage()); } %> 4.3 jsp输出html报表 没有意义,不写。 五、备注 5.1 下载地址 iReport的官方网站:http://ireport.sourceforge.net/ jasperreports的官方网站:http://jasperreports.sourceforge.net/ tTextAsian的官方下载地址:http://itextdocs.lowagie.com/downloads/iTextAsian.jar jfreechart的官方下载地址:http://www.jfree.org/jfreechart/ jcommon的官方下载地址:http://www.jfree.org/jcommon/ poi的官方下载地址:http://www.apache.org/dyn/closer.cgi/jakarta/poi/