iReport 和 Jasperreport 整合开发 WEB 报表向导

iReport 和Jasperreport 整合开发WEB 报表向导

本文由Jplateau 所撰写版权归属于Jplateau

作者主页https://www.360docs.net/doc/d47521895.html,

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

一个星期下来，我针对项目中关于报表的一些需求点进行了尝试，发现他们都可以解决，真实大快人心，于是今天把他们推荐给各位。其实我们做报表用的只是Jasperreport，iReport 是一个Jasperreport 的可视化开发工具（不要看它的界面有些简陋，我们要的操作他都可以帮我们轻松搞定。），当然iReport 还有其他的用处，不过这里不做阐述。目前几乎还没有中文的介绍他们整合开发的文章，尽管如此我也不准备非常详细的介绍它们，在这里我仅将我的一些经验写出来，不乏有些地方浅尝辄止，如果想细致的研究它们还请阅读它们配套的英文文档。Jasperreport 的配套文档非常详细，该文档是收费的，不过网上有流传的电子版本，本人有幸得到一份，如果你需要可以到本人站点（https://www.360docs.net/doc/d47521895.html,）获得，在此感谢Jasperreport 的为开源世界做出的贡献。相反iReport 的文档不多，也许作者认为其足够简单，我也是经过无数的探索才有些开发的经验。

好了，让我们进入上述两者整合开发报表的历程……

1．首先你要得到它们最新的版本，你可以到下边的地址下载

iRport: https://www.360docs.net/doc/d47521895.html,

Jasperreport: https://www.360docs.net/doc/d47521895.html,

他们的配置也很简单：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 吧! Jasperreport 不需要任何配置，你只需将下载以后的jar 包放到classpath 下即可。呵呵，说来简单，可是如果没有iReport 来替我们干“脏活”，那么做报表的工作将是怎样的痛苦~！

2．Jasperreport是如何工作的？

这里我就往简单里说了。首先要先有个xml 文件，然后编译成jasper 文件（以 .jasper 结尾）,我们真正要使用的是编译以后的 .jasper 文件，这很像我们熟悉的 .jsp 文件，其实我们调用的是其编译以后的servlet。

(图片来自https://www.360docs.net/doc/d47521895.html,/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，也曾出现不少关于它的可视化的编辑器，呵呵。

如果在iReport 以前，如果你要做报表，你要花上很长时间来熟悉Jasperreport 的文档，熟悉文档的一个用途就是编写那个xml 文件，现在你只要他熟悉文档的时间来熟悉iReport 就可以了。

3．IReport初探

先来看一下这个（rich and very simple to user GUI）吧：

如果以前你有过用vb 或其他的开发工具开发报表的经验的话，这个界面乍一看应该很熟悉的，如果碰巧你又熟悉java 语言，哇，那么你用iRepor t应该易如反掌啊，呵呵

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

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

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

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

好了，输入一段文本，很简单，点击创建“静态文本”按钮，然后在报表任何一个工作区（如

title,pageheader,detail,pagefooter summary 等等）输入，如输入“今天天气不错！”。在属性框页可以对输入的内容进行属性控制，如字体，颜色，大小，以及其他的属性，报表中任何的元素（静态文本，线，框等等）都有自己的属性页，一般双击任何元素都可以弹出该元素的属性页，属性页如下图：

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

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

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

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

下面我将采用问答的方式进行逐步讲解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

Report groups

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

在iReport 中引用的方式，如下表

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

3．如何定义字体以及如何使用自定义的字体（如黑体、楷体或者比较艺术化的子体）？

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

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

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

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

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

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

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

后来我查看了相应的xml 文件，如下：（由于文件较大，因此只截取我们关心的）

mode="Opaque"

x="13"

y="42"

width="239"

height="53"

forecolor="#000000"

backcolor="#FFFFFF"

positionType="FixRelativeToTop"

isPrintRepeatedV alues="true"

isRemoveLineWhenBlank="false"

isPrintInFirstWholeBand="false"

isPrintWhenDetailOverflows="false"/>

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

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