是在一个星期以前接触iReport 和 Jasperreport的,下载最初它们并没有吸引我的兴趣(或信任),主要是他们的版本的问题(我一直不敢用版本都不到1.0的工具软件,目前它们的版本:iReport0.2.2,Jasperreport0.5.0),不过听说有人在用他们,于是就仔细看了一下(因为在java应用程序的web打印方面我一直都是采用浏览器打印,非常痛苦,所以宁可信其有不可信其无,呵呵……)
一个星期下来,我针对项目中关于报表的一些需求点进行了尝试,发现他们都可以解决,真实大快人心,于是今天把他们推荐给各位。
其实我们做报表用的只是Jasperreport,iReport是一个Jasperreport的可视化开发工具(不要看它的界面有些简陋,我们要的操作他都可以帮我们轻松搞定。),当然iReport还有其他的用处,不过这里不做阐述。
目前几乎还没有中文的介绍他们整合开发的文章,尽管如此我也不准备非常详细的介绍它们,在这里我仅将我的一些经验写出来,不乏有些地方浅尝辄止,如果想细致的研究它们还请阅读它们被套的英文文档。
Jasperreport的配套文档非常详细,该文档是收费的,不过网上有流传的电子版本,本人有幸得到一份,如果你需要可以到本人站点(http://plateau.sicool.com)获得,在此感谢Jasperreport的为开源世界做出的贡献。
相反iReport的文档不多,也许作者认为其足够简单J,我也是经过无数的探索才有些开发的经验。
好了,让我们进入上述两者整合开发报表的历程……
1. 首先你要得到它们最新的版本,你可以到下边的地址下载
iRport: http://ireport.sourceforge.net
Jasperreport: http://jasperreports.sourceforge.net
他们的配置也很简单:
iReport解压缩以后编辑目录下的iReport.bat文件即可,如下
@echo off
set JAVA_HOME=C:/jdk14 set ANT_HOME=d:/ant set IREPORT_HOME=C:/Documenti/progetti/iReport/iReport2/
rem %ANT_HOME%/bin/ant javadocs %ANT_HOME%/bin/ant iReport |
是不是很简单,你只要设置相应的一些路经就可以,这里是采用ant来运行,当然如果你没有安装ant也不想安装它,那么也可以,不过这里我买个官子,你们自己可以到解压缩以后的目录中找到相应的运行方法。呵呵,安装ant吧J
Jasperreport不需要任何配置,你只需将下载以后的jar包放到classpath下即可。呵呵,说来简单,可是如果没有iReport来替我们干“脏活”,那么做报表的工作将是怎样的痛苦~!
2. Jasperreport是如何工作的?
这里我就往简单里说了。
首先要先有个xml文件,然后编译成jasper文件(以.jasper结尾),我们真正要使用的是编译以后的.jasper文件,这很像我们熟悉的.jsp文件,其实我们调用的是其编译以后的servlet。
(图片来自http://ireport.sourceforge.net/cap3.html#3.1)
不过静态的报表没有什么意思,所以有句话说得好:
“A datasource + a jasper = a print”
它可以支持的输出格式如下:PDF,HTML,XML,XLS,CVS等等。
因此,Jasperreport的原始输入就是一个.xml文档,想象看一个简单报表的xml文件也有几百行,在没有iReport以前用它做报表是多么痛苦。(令我不可思议的是,我一个同学公司曾经用jasperreport做报表,可是它们竟然没有用过iReport,天!)
现在不用怕了,用iReport可以轻松的搞定这个XML,写到这里,我想起了struts_config.xml,也曾出现不少关于它的可视化的编辑器,呵呵J
如果在iReport以前,如果你要做报表,你要华上很长时间来熟悉Jasperreport的文档,熟悉文档的一个用途就是编写那个xml文件,现在你只要他熟悉文档的时间来熟悉iReport就可以了。
3. IReport初探
先来看一下这个(rich and very simple to user GUI)吧:
如果以前你有过用vb或其他的开发工具开发报表的经验的话,这个界面乍一看应该很熟悉的,如果碰巧你又熟悉java语言,哇,那么你用iReport应该易如反掌啊,呵呵J
在上一篇文档里我们初步介绍了iReport和Jasperreport,基本上我们已经对它们有了一个最初的认识,在今天这篇文档里,我将深入的对iReport这个工具进行说明。
让我们先回顾一下上一篇文档中已经阐述的问题:
1. 如何连接数据库?
2. 如何定义变量、参数以及字段?
3. 如何定义字体以及如何使用自定义的字体(如黑体、楷体或者比较艺术化的子体)?
下面我们接着往下阐述余下的两个问题,在开始以前我补充两个因该在上篇文档阐述而没有阐述的地方。
第一个就是我忘记说明iReport怎样把xml文件编译成jasper文件,其实很简单,点击“编译”按钮 即可,其实在你点击两种“运行
”按钮的是缺省的操作就是先对xml文件进行编译。
第二个就是如何设置iReport的输出格式,我们在前面曾说过iReport可以以很多种格式进行输出,如PDF,HTML,XML,XLS,CVS等等,那么我们该如何设置以何种方式输出呢?
在菜单Build中我们可以看出iReport的缺省输出格式为PDF,如图:
| PDF preview 缺省输出格 HTML preview 以网页的格式输出 剩下的就不说了,大家试一下就明白了,J |
但是只在此设置输出格式了,还没有完成设置,还有一个必需的设置就是,为每一种设置选择执行“环境”,例如,如果你选择以PDF输出,那么你需要为其指明Acrobat Reader的路径,如图选择菜单Tools/Options,则会弹出如下属性页:
这里还有一点我要说明的就是,在上边途中External editor的设置是选择编辑xml文件的编辑器,这里我一般用UltraEdit来编辑,你可能喜欢用其他的,譬如editplus等,那么就把常用的xml编辑器输入在这里就可以随心所欲的编辑xml文件了,编辑xml文件进入菜单“Edit/edit XML source”,则会弹出你熟悉的编辑器来编辑该xml文件,如图:
还有最后一点要补充的就是,在上一篇文档中我引入非宋体的字体的pdfFontName的ttf文件路径都是绝对路径(如:c:/winnt/fonts/simhei.ttf),其实这是不对的,应该把你在应用程序中的字体打包进来,这样改绝对路径为相对路径(如 reportfonts/simhei.ttf),这样就万无一失了,呵呵J
好了,做完上边的补充,让我们接着前面的问题往下进行,先把下面要解决的问题列如下:
4. 如何执行SQL脚本进行查询?
5. 如何把做好的报表引入到应用程序中?
接下来让我们一个问题一个问题的解决它J
4.如何执行SQL脚本进行查询?
我们大家都知道,从数据查询必须要有查询语句,特别综合查询的时候可能sql语句会复杂的多,那么iReport是怎样让我们使用自己的查询语句进行输出的呢?我们在上一篇中曾提到过,呵呵J,希望你不会忘记,在菜单view下有Reprot query项,点击则会弹出如下属性页:
点击上图的“Save query to report”则会把这条SQL语句就会把这条查询语句“引入”到报表中了,如果你此时查看XML文件,则会发现如下片断:
<queryString><![CDATA[select * from users where name='Jplateau']]></queryString> |
此时我们还以上篇文章开始的例子入手,让我们“加工”一下,如下图:
假设我们已经设置好连接数据,那么此时点击“运行”按钮 则会得到如下效果:
呵呵,得到了我们期望的效果,这时,可能你要问,如果我要在sql语句中使用参数呢,那么又该如何?其实我接下来马上要说这个问题,如果我们要以名称来进行模糊查询,传递的参数为name,那么期望的sql语句可能是下面这个样子:
Select * from users where name like ‘%name%’ |
其实在iReport中也可以很容易实现,记得我们在上一篇文档中曾说过参数的使用方法,因此我不多说,我只把最终的sql语句写给大家,相信大家一看就明白:
Select * from users where name like ‘%$P{name}%’ |
是不是很简单?J
5. 如何把做好的报表引入到应用程序中?
其实在问题4中,如果要运行带参数的查询报表的话,就会牵涉到问题5的,因此我在这里还是要引用问题4种的例子。
此时我们就要引入一个jsp页面,假设是pdf.jsp,那么下面就是pdf.jsp的代码:
<%@ page import="dori.jasper.engine.*" %> <%@ page import="java.util.*" %> <%@ page import="java.io.*" %> <%@ page import="java.sql.*" %>
<% File reportFile = new File(application.getRealPath("/reports/test.jasper"));
Map parameters = new HashMap(); parameters.put("name", "p");
Connection conn=null
//以下忽略得到数据库连接过程 //…… //……
byte[] bytes = JasperRunManager.runReportToPdf( reportFile.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(); %> |
还有一个必要的步骤就是把你下载的Jasperreport.jar放在你应用程序的lib下,
好了,启动你的应用程序,运行dbf.jsp则会看到如下效果
怎么样,根据名称的模糊查询结果是符合我们的期望的,相信你已经掌握了上边的方法了。
当然上边我给出的例子都是最简单的,而且报表的排版也比较随意,相信一点,精美的报表可是细活啊,呵呵J,多练习吧。