海鸥航际

JAVA站
posts - 11, comments - 53, trackbacks - 1, articles - 102
我是在一个星期以前接触iReport Jasperreport的,下载最初它们并没有吸引我的兴趣(或信任),主要是他们的版本的问题(我一直不敢用版本都不到1.0的工具软件,目前它们的版本:iReport0.2.2,Jasperreport0.5.0),不过听说有人在用他们,于是就仔细看了一下(因为在java应用程序的web打印方面我一直都是采用浏览器打印,非常痛苦,所以宁可信其有不可信其无,呵呵……)

一个星期下来,我针对项目中关于报表的一些需求点进行了尝试,发现他们都可以解决,真实大快人心,于是今天把他们推荐给各位。

其实我们做报表用的只是JasperreportiReport是一个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也不想安装它,那么也可以,不过这里我买个官子,你们自己可以到解压缩以后的目录中找到相应的运行方法。呵呵,安装antJ

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

 

在上一篇文档里我们初步介绍了iReportJasperreport,基本上我们已经对它们有了一个最初的认识,在今天这篇文档里,我将深入的对iReport这个工具进行说明。

 

       接着上篇文档的结尾,如果我们成功运行iReport的话,可以看到如下的主界面:

 

 

点击“新增”  按钮可以创建一个新的空报表,考虑到生成后的XML文件编辑的时候可以显示中文,请在xml encoding选项上GB2312(没有选项自己手动输入),如下图:

 

当设置玩必要的选项点击完成可以得到一个空白的报表,如下图:

 

 

好了,输入一段文本,很简单,点击创建“静态文本”按钮 ,然后在报表任何一个工作区(如title,pageheader,detail,pagefooter summary等等)输入,如输入“今天天气不错!”

在属性框页可以对输入的内容进行属性控制,如字体,颜色,大小,以及其他的属性,报表中任何的元素(静态文本,线,框等等)都有自己的属性页,一般双击任何元素都可以弹出该元素的属性页,属性页如下图:

 

完工,一个最简单的报表就生成了,iReport配有运行环境,如下快捷按钮:

左边的按钮是运行静态报表(无需数据库环境),右边的是运行动态报表(这时需要设置数据库连接,数据库的连接载下面介绍)

 

那么经过上遍的努力,很显然我们将要运行的静态报表,那么点击左边的按钮就可以看到下面的pdf,如图:

当然上遍的例子是最简单,呵呵J

 

下面我将采用问答的方式进行逐步讲解iReport的用法

1. 如何连接数据库?

2. 如何定义变量、参数以及字段?

3. 如何定义字体以及如何使用自定义的字体(如黑体、楷体或者比较艺术化的子体)?

4. 如何执行SQL脚本进行查询?

5.  如何把做好的报表引入到应用程序中?

 

好了,针对上面的问题,我在下面的篇幅中给于解答并穿插介绍iReport中其它的功能菜单。

1. 如何连接数据库?

静态的报表其实很少的,我在前一篇文档中有提到过一句经典的话:

A datasource + a jasper = a print”因此有必要首先介绍一下如何连接数据库,其实很简单

进入Datasource/Connections/Datasources菜单或者点击 快捷按钮,则出现下面属性页:


进行必要的数据库连接属性配置,然后点击test按钮进行测试,如果提示测试成功,则保存数据库连接,即可。

 

2. 如何定义变量、参数以及字段?

变量、参数以及字段的定义,在iReport里是比较方便的,在菜单view下可以看到一些控制点,如下图:

Report properties 设置报表属性

Report query 设置查询语句的,这个在下面有介绍

Report fields设置字段(数据库)

Report variables设置变量

Report parameters设置参数

Report fonts 设置字体

顺便把下面的你个也说明一下

Bands,弹出报表工作区(title detail)的属性页

Report groups设置组

 

Element properties 元素属性页

Element browser 显示报表所有元素的列表

 

设置很容易,但是在报表中引用这些变量、参数和字段就有写说头了,呵呵J,让我们一步一步慢慢来。

iReport中引用的方式,如下表

元素

名称

引用

变量

variablesName

$V{ variablesName }

参数

parameterName

$P{ parameterName }

字段

filedsName

$F{ filedsName }

其实这些不说明好像不知道如何办,一单说明了,它们也是很好用的也很简单的。多用吧J

 

3. 如何定义字体以及如何使用自定义的字体(如黑体、楷体或者比较艺术化的子体)?

 

因为考虑到使用亚洲字体,因此你需要下在额外的jariTextAsian.jar,如果iReport下载包中含有此jar包,此步骤可免。

 

目前在iReport中使用中文字体,好像只有宋体一种,如果想用其它的字体(如黑体、楷体等)需要另外的方法,这在下面介绍,下面介绍如何使用常用的中文字体“宋体”的设置方法,在问题2中我们看到引入字体的选项,点击“Report fonts”可以看到下面属性页:

 

好,如上边的设置就已经设置好宋体,以后在报表的任何地方都可以引用该字体,如下面我们要把我们在上边的例子中的元素“今天天气不错!”改为用宋体,如下:

这样只要我们在Report font选项中选中songti 那么下面的属性自动继承,呵呵,方便吧J

好,下面讲述如何使用宋体以外的中文字体,如:黑体、楷体或其他的艺术化的字体。

 

也很简单,不过好像目前iReport的功能不够完美的缘故,还要手动修改xml文件才可以达到要求,如下图我们定义黑体:

首先不同的是在PDF font name选项中选中External TTF font…,按照常理,此时要在紧接着的选项中选择黑体的ttf文件SIMHEI.TTF,可是不知为什么TrueType font的选项是空的,(当时我在学习的时候,这步操作让我好胜郁闷),天啊,该怎么办?!

 

后来我查看了相应的xml文件,如下:(由于文件较大,因此只截取我们关心的)

                            <staticText>

                                   <reportElement

                                          mode="Opaque"

                                          x="13"

                                          y="42"

                                          width="239"

                                          height="53"

                                          forecolor="#000000"

                                          backcolor="#FFFFFF"

                                          positionType="FixRelativeToTop"

                                          isPrintRepeatedValues="true"

                                          isRemoveLineWhenBlank="false"

                                          isPrintInFirstWholeBand="false"

                                          isPrintWhenDetailOverflows="false"/>

                                   <textElement textAlignment="Left" verticalAlignment="Top" lineSpacing="Single">

                                          <font fontName="黑体" pdfFontName="" size="36" isBold="false" isItalic="false" isUnderline="false" isPdfEmbedded ="true" pdfEncoding ="Identity-H" isStrikeThrough="false" />

                                   </textElement>

                            <text><![CDATA[黑体]]></text>

                            </staticText>

 

大家可以看到黑体的pdfFontName=””是空的,于是我尝试把系统黑体的TTF文件路径(C:\WINNT\fonts\SIMHEI.TTF)写到这个地方,哈哈,居然成功了。

于是我得到这样一个结论,目前如果你在报表中使用其它的字体,首先要做上面图中所做的属性设置,然后手动把字体的TTF文件写到pdfFontName=””,虽然麻烦了点,不过这招挺管用,呵呵J

让我们先回顾一下上一篇文档中已经阐述的问题:

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文件,如图:

 

还有最后一点要补充的就是,在上一篇文档中我引入非宋体的字体的pdfFontNamettf文件路径都是绝对路径(如: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,多练习吧。

 

 

总结

 

这篇系列文档总算写完了,总觉得有点随意的样子,不过还是希望能给一点帮助,文档中不乏有些浅尝辄止的地方,希望你不明白的地方或认为我阐述的不对的地方给我留言或写信。

我的站点:http://plateau.sicool.com

Feedback

# re: iReport 和 Jasperreport整合开发web报表向导   回复  更多评论   

2006-06-08 14:51 by zhuiyun
你能不能指导我一下关于在WEB客户端直接打印JasperReport报表的问题。
我现在做出来的只能在自己的机上访问,在其他机子上反问ie会自动关闭。

只有注册用户登录后才能发表评论。


网站导航: