当前位置:文档之家› JasperReports入门详细步骤

JasperReports入门详细步骤

JasperReports报表生成的基本步骤:1.扩展名为.jrxml的文件为标准的xml文件,该文件定义了报表的格式和数据构成。

可以通过jasperReports的“黄金搭档”iReport以可视化的方式生成并编辑这个文件。

2.jrxml文件经过JasperReports API 编译后将生成扩展名为.jasper的二进制文件。

3.可以调用JasperReports API针对jasper文件进行数据和参数的填充,生成扩展名为.jrprint的文件。

4.调用JasperReports API可以将jrprint文件最终导出成PDF、Excel、Html等各种格式的文件。

下面将采用iReport + JasperReports 生成如下图的PDF格式报表,表格中的数据来源于数据库,是在固定格式报表基础上,由JasperReport填充得到的。

整个报表的生成过程需要两个步骤:1.使用iReport生成规定报表格式和数据构成的jrxml文件。

2.调用JasperReports API 编译、填充并导出固定格式的报表。

一、用iReport生成报表文件(.jrxml)开源工具iReport用于定义报表的格式,可以从其官方网站下载/cap3.html本应用所使用的是iReport-1.2.2-windows-installer.exe 安装程序,启动后,按照向导即可安装(要确认系统中装有1.4版本以上JDK)。

下面的操作大致分为12个步骤:步骤1:安装成功后启动该程序,将显示如下画面,选择菜单“File->New Document”新建报表文档,可在弹出的对话框选择报表的大小、版式等。

步骤2:按照默认版式创建报表,选择菜单“Data->Connections/Datasources”指定数据库连接或数据源,在弹出的对话框中单击“New”,并在弹出的对话框中指定数据库的连接参数(驱动类、URL、用户名和密码等)iReport通过JDBC 连接数据库,要确认相应数据库的驱动类置于iReport安装路径的lib文件夹下。

步骤3:选择菜单“Data->Report Query”在弹出的对话框中输入SQL语句:select id, name, salary from emp,选中所有查询的字段后,单击“OK”。

该SQL语句查询的数据为将来报表中要显示的数据,除了用SQL语句,这里还支持HQL(Hibernate Query Language)等其他多种查询方式。

这样的操作将在报表的xml文件中生成如下定义:<queryString><![CDATA[select id, name, salary fromemp]]></queryString><field name="id" class="ng.Integer"/><field name="name" class="ng.String"/><field name="salary" class="ng.Double"/>其中元素定义了用于获取数据的查询语句,将来JasperReports将通过这样的方式查询数据。

元素定义了对应于查询结果的字段名称和类型,将来报表中可以使用$F{字段名称}获取并显示查询得到的数据。

步骤4:选择菜单“Format->Styles”用于指定报表元素将使用的样式,这里的Style类似于HTML中CSS样式,一个样式规定了字体、前景色、背景色等显示特征,样式创建后,可以将其施加于特定的报表元素。

为了便于维护,样式之间可以实现继承关系,子样式将拥有父样式的一切特征。

在弹出的对话框中单击“New”指定一个名为default的样式(通过Style name指定样式名称),指定其字体、颜色等特征。

步骤5:继续指定一些其他的样式,如用于表头字体的“灰底白字”的样式header,将这些样式的Parent style值指定为刚刚创建的default样式,即指定default 是所有样式的父样式,这样可以通过编辑default样式指定一些所有样式共同的特征。

步骤6:单击“Edit->Insert element...->Static Text”或使用工具栏的按钮,在报表页面中添加静态文本框,将这些文本框置于合适的位置并填入文字,作为表头,通过右边的Element properties 视图将这些文本框的Style(样式)置为方才创建的header。

步骤7:打开右边Library视图的Fields图标,可以看到id,name,salary三个标识,这三个标识对应在“步骤3”中创建的“查询字段”,用鼠标直接拖动这些字段到报表页面的适当位置,这样的操作将在报表xml文本中产生形如:<textFieldExpression class="ng.Integer"><![CDATA[$F{字段名称}]]></textFieldExpression>的文本。

其中$F{字段名称}表示该字段的查询值。

步骤8:在Library视图中单击右键,在弹出的快捷菜单中选择“Add...->Parameter”,用于创建参数,在弹出的对话框中指定参数的名称和数据类型。

步骤9:在Library视图的Parameter下可以看到刚刚建立的名为“Title”的参数,用鼠标拖到其到指定位置,并适用在步骤5中创建的title样式,此处为报表的标题。

这样的操作将在xml文件中产生如下内容:<textFieldExpression class="ng.String"><![CDATA[$P{Title}]]></ textFieldExpression>其中的$P{Title}对应Title参数的值,将来将通过JasperReports API 对“Title”参数赋值。

步骤10:选择菜单“File->Save”或单击工具栏按钮保存生成的xml文件,注意,文件的扩展名一般为jrxml,该文件定义的报表的格式及其数据构成。

步骤11:可以通过iReport的编译工具对生成的报表文件进行测试,单击工具栏的按钮编译报表文件,如果无误可单击工具栏的按钮将显示报表生成的样式,如果单击工具栏的按钮,iReport将会查询数据显示填充数据后的报表,注意:这里的报表的标题显示null是因为没有对报表的“Title”赋值,这里仅仅是通过iReport工具对生成的报表进行测试,下面将通过JasperReports API以编程的方式编译、填充并导出报表。

步骤12:为了是将来导出的PDF格式报表支持中文显示,可以手工的编辑iReport 生成的xml文件,在定义default样式的位置加入支持中文的PDF字体和编码设置:<stylename="default"isDefault="true"mode="Opaque"pdfFontName="STSong-Light"pdfEncoding="UniGB-UCS2-H"/>由于其他样式继承了该样式,从而自动拥有的支持中文的设置。

二、用JasperReports编译、填充,并导出报表可以从JasperReports的官方网站下/jaspersoft/opensource/business_intelligenc e/jasperreports/载JasperReports的发行包,本应用使用的版本是jasperreports-1.2.3,将其发行包中dist目录下的:jasperreports-1.2.3.jar以及lib目录下的如下jar 文件:poi-2.0-final-20040126.jarjdt-compiler-3.1.1.jaritext-1.3.1.jarcommons-beanutils-1.5.jarcommons-collections-2.1.jarcommons-digester-1.7.jarcommons-javaflow-20060411.jarcommons-loggin-1.0.2.jar复制到应用的类路径(CLASSPATH)下。

为了支持中文的PDF报表导出,还需要有iTextAsian.jar文件,该文件可以从/itext/iTextAsian.jar?download处下载。

注意,由于要连接数据库,还需要将数据库的JDBC驱动类包复制到类路径下。

编译报表(.jrxml -> .jasper),JasperCompileManager类的静态方法compileReportToFile用于编译报表文件第一个String参数为待编译的报表xml 文件,第二个String参数为编译后的文件名。

代码如下所示:public void testCompile() throws Exception {pileReportToFile("test.jrxml", "test.jasper");}填充报表(.jasper -> .jrprint),JasperFillMangager类的静态方法fillReportToFile用于实现对二进制报表文件的填充,该方法有三个参数:1.一个参数为String类型,表示待填充的文件名。

2.第二个参数为Map对象,存放用于填充报表参数(对应与报表中的$P{参数名称})的键值对,下面代码中map对象中存有键值对{Title=员工列表},则对应报表中的$P{Title}位置将被填充为“员工列表”。

3.第三个参数为数据库的连接(java.sql.Connection)对象,方法进行数据填充时需要用到该连接实现查询。

代码如下所示:public void testFill() throws Exception {Map map = new HashMap();map.put("Title", "员工列表");JasperFillManager.fillReportToFile("test.jasper", map, getConnection());}private Connection getConnection() throws Exception {Class.forName("com.mysql.jdbc.Driver");Connection con = DriverManager.getConnection("jdbc:mysql://localhost:3306/test", "root","root");return con;}导出报表,JRPdfExporter类用于将.jrprint格式的报表导出Pdf格式,类似的类还有:∙JRXlsExporter 导出成Excel文件格式∙JRHtmlExporter 导出成HTML文件格式∙JRCsvExporter 导出成Csv文件格式∙JRRtfExporter 导出成RTF文件格式∙JRTextExporter 导出成纯文本文件格式∙JRXmlExporter 导出成Xml文件格式JasperPrint类用于封装.jrprint文件数据。

相关主题