JasperReports介绍
JasperReport是一个强大、灵活的报表生成工具,能够展示丰富的页面内容,并将之转换成PDF、HTML或者XML格式,该库完全由Java写出,可以用于在各种Java应用程序,非常适合Java开发者用来做报表生成。
基本使用指南
新建项目
首先选择模板,这里就直接选了普通的A4模板。
这里用来设置文件名字和文件路径。
这里是选择数据源,我这里已经事先创建好了数据库连接,在后续测试取数据的时候会用到。
这里就是JasperReport的主界面,首先介绍一下界面的五个主要区域:
区域1:选择数据源和项目;
区域2:用于展示报表的内容列表,报表内所含有的所有组件信息都会展示在这里;
区域3:就是可视化报表内容区域,包含报表样式,报表源码和预览生成;
区域4:组件列表;
区域5:属性编辑区域。
再介绍一下需要用的几个基本属性名称:
Parameters:报表的参数,通常由外部传入数据填充;
Fileds:字段,由关联的数据库或实体类生成;
Vareables:变量,可以用来进行一些数学计算。
最后介绍一下报表内容的几个模块:
Title(标题):只在整个报表的第一页最上端显示,其他页面均不显示;
Page Header(页头):在整个报表每一页都会显示,第一页在Title区域下面,之后的每一页均在页面的最上端显示;
Column Header(列头):Detail中打印的是一张表的话,Column Header就是表中每一列的列头;
Deatil(详情):报表内容,可以循环显示数据;
Column Footer(列脚):Detail中打印的是一张表的话,Column Footer就是表中每一列的列脚;
Page Footer(页脚):整个报表每一页都会在最下端显示,一般用来显示页码;
Summary(合计):出现在整个报表的最后一页中,在Detail后面,主要用来做报表的合计显示。
开始画报表
这是该项目的源代码,我在这里需要取一些产品表里的数据,queryString标签内就是主项目的取数sql,直接加进去。
这里加入sql后取到了产品ID字段,后续会在报表内显示,所以在FIelds域里也新增了ID_PRODUCT的属性,可以直接在代码里添加,也可以在主界面添加,如下图,直接右键Create Field,然后在区域5里可以修改类和名称。
接下来我们将Static Text和“Text Field”拖入Detail区域中,一个是静态文本,一个用来放属性。
双击Text Field,可以选择我们刚才新添加的属性ID_PRODUCT,并将静态文本改为产品ID,即可初步生成我们的报表。
可以看到已经生成成功了,我这里只去了前十条数据,这里再展示一下通过外部输入数据来筛选数据,使用投资性质VLU_INVEST_PROPERTY这个字段,先添加该字段的外部输入参数,再在sql里加入对应筛选的语句。
之后将该字段加入主界面,生成报表即可根据外部输入该字段来筛选数据。
这里模板文件生成的基本的操作流程就已经介绍完了,这时候是.jxml文件,然后需要build成.jasper文件,就可以在java程序里调用jasper相关方法生成报表了。
常见问题
如图错误
这个错误一般是由于页面的宽度和列长度不匹配导致的。
在xml源码开头将columnWidth改为比pageWidth小一截即可。
主界面有些表格无法显示
很有可能是表格重叠导致,分开后即可。
无查询结果
在使用table组件后,外部数据输入后sql查询没有结果。
因为外部输入的数据没有传递到子查询中,需要设置值的传递。
像图中所示即可将主项目的值传递到table中。
内存泄漏或者溢出
可以使用仿真器来解决问题,推荐使用JRGzipVirtualizer仿真器,能够将内存泄漏压缩在最小的范围里了。
作者:田佳霖