JasperReport框架使用教程(附带常见空白页问题说明)

您所在的位置：网站首页 › 表格图片空白统计 › JasperReport框架使用教程(附带常见空白页问题说明)

JasperReport框架使用教程(附带常见空白页问题说明)

2024-01-01 03:21| 来源: 网络整理| 查看: 265

【该昵称无法识别】，希望小伙伴们可以帮忙关注一下，谢谢~

概述与安装使用 1. PDF报表概述概述

在企业级应用开发中，报表生成、报表打印下载是其重要的一个环节。在之前的课程中我们已经学习了报表中比较重要的一种：Excel报表。其实除了Excel报表之外，PDF报表也有广泛的应用场景，例如货运详情，货运单等。

常见PDF报表的制作方式

目前世面上比较流行的制作PDF报表的工具如下：

iText PDF：iText是著名的开放项目，是用于生成PDF文档的一个java类库。通过iText不仅可以生成PDF或rtf的文档，而且可以将XML、Html文件转化为PDF文件。 Openoffice：openoffice是开源软件且能在windows和linux平台下运行，可以灵活的将word或者Excel转化为PDF文档。 Jasper Report：是一个强大、灵活的报表生成工具，能够展示丰富的页面内容，并将之转换成PDF JasperReport框架的介绍

JasperReport是一个强大、灵活的报表生成工具，能够展示丰富的页面内容，并将之转换成PDF，HTML，或者XML格式。该库完全由Java写成，可以用于在各种Java应用程序，包括J2EE，Web应用程序中生成动态内容。只需要将JasperReport引入工程中即可完成PDF报表的编译、显示、输出等工作。

在开源的JAVA报表工具中，JASPER Report发展是比较好的，比一些商业的报表引擎做得还好，如支持了十字交叉报表、统计报表、图形报表，支持多种报表格式的输出，如PDF、RTF、XML、CSV、XHTML、TEXT、DOCX以及OpenOffice。

数据源支持更多，常用 JDBC SQL查询、XML文件、CSV文件、HQL（Hibernate查询），HBase，JAVA集合等。还允许你义自己的数据源，通过JASPER文件及数据源，JASPER就能生成最终用户想要的文档格式。

图片.png JasperReport生命周期(重点)

通常我们提到PDF报表的时候,浮现在脑海中的是最终的PDF文档文件。在JasperReports中，这只是报表生命周期的最后阶段。通过JasperReports生成PDF报表一共要经过三个阶段，我们称之为 JasperReport的生命周期，这三个阶段为：设计（Design）阶段、执行（Execution）阶段以及输出（Export）阶段，如下图所示：

图片.png 设计阶段（Design）：定义模板所谓的报表设计就是创建一些模板，模板包含了报表的布局与设计，包括执行计算的复杂公式、可选的从数据源获取数据的查询语句、以及其它的一些信息。模板设计完成之后，我们将模板保存为JRXML文件（JR代表JasperReports）,其实就是一个XML文件。执行阶段（Execution）：模板 + 数据使用以JRXML文件编译为可执行的二进制文件（即.Jasper文件）结合数据进行执行，填充报表数据输出阶段（Export）：展示。将模板和数据一起展示。数据填充结束，可以指定输出为多种形式的报表 JasperReport执行流程（重点+）图片.png JRXML:报表填充模板，本质是一个XML. JasperReport已经封装了一个dtd，只要按照规定的格式写这个xml文件，那么jasperReport就可以将其解析最终生成报表，但是jasperReport所解析的不是我们常见的.xml文件，而是.jrxml文件，其实跟xml是一样的，只是后缀不一样。 Jasper:由JRXML模板编译生成的二进制文件，用于代码填充数据。解析完成后JasperReport就开始编译.jrxml文件，将其编译成.jasper文件，因为JasperReport只可以对.jasper文件进行填充数据和转换，这步操作就跟我们java中将java文件编译成class文件是一样的 .Jrprint:当用数据填充完Jasper后生成的文件，用于输出报表。这一步才是JasperReport的核心所在，它会根据你在xml里面写好的查询语句来查询指定是数据库，也可以控制在后台编写查询语句，参数，数据库。在报表填充完后，会再生成一个.jrprint格式的文件（读取jasper文件进行填充，然后生成一个jrprint文件） Exporter:决定要输出的报表为何种格式，报表输出的管理类。 Jasperreport 可以输出多种格式的报表文件，常见的有Html,PDF,xls等 2. Jaspersoft Studio 模板工具概述

Jaspersoft Studio是JasperReports库和JasperReports服务器的基于Eclipse的报告设计器; 它可以作为Eclipse插件或作为独立的应用程序使用。Jaspersoft Studio允许您创建包含图表，图像，子报表，交叉表等的复杂布局。您可以通过JDBC，TableModels，JavaBeans，XML，Hibernate，大数据（如Hive），CSV，XML / A以及自定义来源等各种来源访问数据，然后将报告发布为PDF，RTF， XML，XLS，CSV，HTML，XHTML，文本，DOCX或OpenOffice。

Jaspersoft Studio 是一个可视化的报表设计工具,使用该软件可以方便地对报表进行可视化的设计，设计结果为格式.jrxml 的 XML 文件，并且可以把.jrxml 文件编译成.jasper 格式文件方便 JasperReport 报表引擎解析、显示。

安装配置到JasperReport官网下载 https://community.jaspersoft.com/community-download 图片.png

下载后，安装：TIB_js-studiocomm_6.5.0.final_windows_x86_64.exe。直接下一步下一步即可。

主界面

图片.png 基本使用如何创建模板？打开Jaspersoft Studio ，新建一个project, 步骤： File -> New -> Project-> JasperReports Project 图片.png 下一步，输入项目名称：图片.png

创建JasperReport模板

图1：

图片.png

图2：

图片.png

图3：

图片.png

图4：

图片.png 面版说明 Title(标题)：只在整个报表的第一页的最上端显示。只在第一页显示，其他页面均不显示。 Page Header(页头)：在整个报表中每一页都会显示。在第一页中，出现的位置在 Title Band的下面。在除了第一页的其他页面中Page Header 的内容均在页面的最上端显示。 Page Footer(页脚)：在整个报表中每一页都会显示。显示在页面的最下端。一般用来显示页码。 Detail 1(详细)：报表内容，每一页都会显示。 Column Header(列头)：Detail中打印的是一张表的话，这Column Header就是表中列的列头。 Column Footer(列脚)：Detail中打印的是一张表的话，这Column Footer就是表中列的列脚。 Summary(统计)：表格的合计段，出现在整个报表的最后一页中，在Detail 1 Band后面。主要是用来做报表的合计显示。完善模板、编译模板

第一步：可以把不需要的面版删除：这里只留了Title、Summary

图片.png

第二步：拖入Image到面版中，输入url地址：http://i1.qhimg.com/t01e0356c940bf0a30c.jpg

图片.png

第三步：拖入Static Text，静态文本

图片.png

第四步：点击预览

图片.png

第四步：现在已经创建了jrxml模板，现在需要编译它：

注:这里千万千万注意要先保存再编译,不然打印出来的内容会是空白的,还有汉字问题,字体需要选择系统有的,如果导入到java程序中,最好在包中存放该字体文件

图片.png

编译结果：

图片.png 数据填充 1. 数据填充（一）参数map填充需求

通过java代码往jasper模板中传入参数。

步骤

第一步：定义模板。先定义模板、在模板中定义一些参数。

模板预览：

图片.png

第二步：导出PDF。通过java代码，往模板中设置参数，导出pdf。

第一步：定义模板

① 拖入frame

图片.png

② 设置frame边框

图片.png

③ 拖入Line到frame、设置宽度与frame一致。

图片.png

④ 设置h为1px后

图片.png

⑤ 预览

图片.png

⑥设置Parameter

图1：

图片.png

图2：

图片.png

⑦ 制作模板

图片.png

⑧ 修改文字大小、修改文字字体、编译模板生成jasper文件、把jasper文件拷贝到项目中。

第二步：导出PDF

① 拷贝jasper文件到项目中

图片.png

② 编写控制器

/** * 2）带参数的导出 * @throws Exception */ @RequestMapping("/exportPdf") public void exportPdf() throws Exception{ //1.读取.japser文件，构建输入流 InputStream in = session.getServletContext().getResourceAsStream("/jasper/test02_param.jasper"); //2.构建Print对象，用于让模块结合数据 //第二个参数就是用来填充模板中的parameters Map map = new HashMap(); map.put("userName","小泽"); map.put("email","[email protected]"); map.put("companyName","小泽科技"); map.put("deptName","视频组"); JasperPrint print = JasperFillManager.fillReport(in,map,new JREmptyDataSource()); //3.使用Exporter导出PDF JasperExportManager.exportReportToPdfStream(print,response.getOutputStream()); } 2. 数据填充（二）JDBC数据源 A 配置数据源分析

数据源填充数据分为：JDBC数据源填充数据（数据库连接）、JavaBean填充数据（list集合）

如图：

图片.png 配置数据源

图1：

图片.png

图2：

图片.png

图3：配置数据库连接信息

图片.png

图4：选择驱动、点击完成

图片.png

图5：配置结果

图片.png 3. 数据填充（三）JDBC数据源 B 制作模板制作模板第一步：新建模板

① 新建jasper模板

图片.png

输入模板名称：

图片.png

下一步，完成

图片.png 第二步：模板制作

①创建空白模板后，并将不需要的Band删除，只留下如下面版：

图片.png

②新建数据源

图1：

图片.png

图2：

图片.png 图片.png

③ 新建数据源后，自动生成如下四个Fields

图片.png

④ 构造模板

图片.png 第三步：制作细节

①由于模板数据有空格，需要去除数据的空格

图1：双击空白区域

图片.png

图2：

图片.png

由于没有边框，现在设置边框

图1：

图片.png 4. 数据填充（四）JDBC数据源 C 代码实现

这里的数据是从pe_user表查询出来的，在jasper模板中配置的数据源。

实现

第一步：拷贝生成的jasper文件到项目中

图片.png

第二步：实现导出PDF

//注入数据源 @Autowired private DataSource dataSource; /** * 3)使用JDBC数据源导出 * @throws Exception */ @RequestMapping("/exportPdf") public void exportPdf() throws Exception{ //1.读取.japser文件，构建输入流 InputStream in = session.getServletContext().getResourceAsStream("/jasper/test03_jdbc.jasper"); //2.构建Print对象，用于让模块结合数据 //第三个参数：如果是JDBC数据源，应该设置Connection对象 JasperPrint print = JasperFillManager.fillReport(in,new HashMap(),dataSource.getConnection()); //3.使用Exporter导出PDF JasperExportManager.exportReportToPdfStream(print,response.getOutputStream()); } 5. 数据填充（五）JavaBean数据源(重点) 需求

刚才我们实现了jdbc数据源，直接查询表中的数据填充jasper模板。但是很多时候我们需要对数据进行处理，再把处理后的数据填充到jasper模板。所以，我们就需要把处理后的数据用javabean封装，这里就用到了javabean数据源。

我们的实现步骤分为下面2步：

制作jasper模板导出pdf 制作模板图片.png 导出pdf

先把编译后的jasper模板文件拷贝到项目中，再在控制器添加如下方法：

/** * 4)使用JavaBean数据源导出 * @throws Exception */ @RequestMapping("/exportPdf") public void exportPdf() throws Exception{ //1.读取.japser文件，构建输入流 InputStream in = session.getServletContext().getResourceAsStream("/jasper/test04_javabean.jasper"); //2.构建Print对象，用于让模块结合数据 //注意：JavaBean的属性名称和模版的Fileds的名称一致的 List list = new ArrayList(); for(int i=1;i

【本文地址】

JasperReport框架使用教程(附带常见空白页问题说明)

JasperReport框架使用教程(附带常见空白页问题说明)

今日新闻

推荐新闻