Jasperreport报表开发指南

Jasperreport是http://www.sourceforge.net上一个优秀的开源的报表工具，其强大的功能及免费的特性得到了广大的认可和赞誉，现在的最新版本是Jasperreport0.6.1。下载地址是

　　https://sourceforge.net/projects/jasperreports/。

　　iReport是jasperreport的一个IDE的开发工具，使Jasperreport变得更易用，其最新版本是iReport0.3.2支持到Jasperreport0.5.3，和Jasperreport一样也在不断的更新中。下载地址是https://sourceforge.net/projects/ireport/。

　　关于利用这两个工具开发Web报表，这里已经有几份很好的材料：

　　JasperReport与iReport的配置与使用.pdf（该文档可用于一开始入门熟悉这两个工具）

　　TheJasperReportsUltimateGuide.1.0.pdf （这个本是一份收费的文档，讲述了Jasperreport生成的原理方面的知识，如果你打算能熟练的使用Jasperreport这个报表工具，需要好好看这份英文资料的）

　　http://www.javaresearch.org/forum/thread.jsp?column=316&thread=14374

　　第一次运行

　　第一次总是比较痛苦，使用这个报表工具也是，下面是我总结出的一些运行中比较容易出现的问题。

　　我的总结是建立在使用iReport0.3.2 ＋ Jasperreport0.5.3（没办法，iReport0.4.0还没出来，0.3.2只支持到Jasperreport0.5.3）。至于这两者的组合，我用到现在还是觉得比较顺的。

　　从souceforge上下载iReport-0.3.2.zip 解压后，要注意一点，把你的JDK的tools.jar拷到你解压后的iReport的lib目录下，做中文的pdf报表还需要把iTextAsian.jar拷到lib下，如果你用的是Oracle的数据库，那么你还需要把class12.jar也就是Oracle的Jdbc包拷到lib下，其他数据库也一样。

　　好了准备工作做好了，运行iReport.bat。如果比较顺利，应该能看到以下画面，说明iReport成功运行了。

　　如果dos界面一闪而过，并且没有出现以上界面，说明没有成功。按以下步骤可解决该问题：

　　确定系统安装有JDK，而且系统环境设置，path里有JDK的bin目录，并有java_home参数，以下是我的几个参数的配置情况可供参考：

　　1

　　java_home

　　D:\JBuilder9\jdk1.4

　　2

　　path

　　D:\JBuilder9\jdk1.4\bin;D:\Install\ant161\bin

　　3

　　classpath

　　D:\iReport032\fonts;E:\Project\EssV6\webapps\WEB-INF\classes

　　4

　　ant_home

　　D:\Install\ant161

　　（关于上面参数设置的说明：)

　　Report0.3.2及Jasperreport0.5.3都要求JDK1.4以上版本，所以要注意Oracle9装好会自动把java环境设为Oracle自带的JDK1.3.1，会导致无法运行iReport。

　　ant_home及path中ant的设置是为了可以用ant来学习Jasperreport的例子，这些例子在Jasperreport解压后的demo\samples目录下，比如在Dos环境下进入demo\samples\jasper目录下，输入命令ant view 就可以看到该示例报表。

　　classpath中D:\iReport032\fonts;的设置是确保iReport里字体设置的时候能选择一些外部字体，比如要让PDF显示黑体，那么把windows下的simhei.ttf拷到D:\iReport032\fonts下，在iReport中如下设置:pdffontname为外部字体、truetypefont 为simhei.ttf、 编码为unicode with horizontal writing，这样就能使用黑体了

　　E:\Project\EssV6\webapps\WEB-INF\classes，classpath里的这是设置，是让报表里一些数据要经过特殊处理，可以用工程里的函数。

　　这些设置完成后，到dos环境下的iReport目录下，运行iReport.bat，dos环境下的好处是如果iReport运行失败可以看到失败原因，然后针对性的解决。

　　iReport可以运行后就是一个摸索使用，慢慢了解熟悉的过程了，直到你能做出像样的一些报表。这个过程可以参考上面提到的

　　http://www.javaresearch.org/forum/thread.jsp?column=316&thread=14374

　　常见问题的解决

　　具体做报表的时候会碰到许多问题，关键的是我们需要分析出错提示，根据找到解决办法，比如你把报表放到你的工程下，比如运行结果提示java.io.FileNotFoundException，那么你就需要确定你的报表编译后的文件在相应的目录；又比如提示NoClassDefFoundError，那你就要看看是哪个包没有放到你的工程下。一下是一些常见问题：

　　Jasper报表中画的交叉线在html和xls中无法显示?

　　答：要想在html里面显示的话，线与线之间，线与字框之间不能有任何一点重合所以你说的交叉线，如果是两条线直接交叉画的话，就只能由一条显示，需要分三条线段画。