iReport+JasperReports Server开发过程的Troubleshooting

本文涉及的内容：主要是实现一个subreport的masterreport成功在JasperReports Server（下文简称为JRS）上生成报表。

首先是使用iReport分别设计masterreport和subreport，并preview成功；然后再将这两份报表模版在JasperReports Server上连接数据源，并最终生成报表。

问题1： No suitable driver found for jdbc:mysql

背景：在使用iReport设计报表模版，使用到subreport的时候，一般都是设计好subreport之后，将subreport嵌入masterreport使用，然而在嵌入subreport的时候，需要定义一个连接,比如： java.sql.DriverManager.getConnection("jdbc:mysql://localhost:3306/dbname","username","passwd") ，但是最后生成报表preview的时候会报错No suitable driver found for jdbc:mysql。

问题解决：

这最主要还是个driver的问题，关于这个，则必须要将mysql-connector.jar放到正确的位置：
可以参考：http://community.jaspersoft.com/questions/534375/multi-database-issue-lets-see-if-someone-can-help

其中主要的内容为：
OK, here is the solution for Ubuntu 10.10 with netbeans 6.8 and 6.9.1, plus iReport, please post here where you find other solutions as well, as this applies on Windows as well. 
Forget the classes folder, the driver has to be located in this folder to have it working correctly:
/usr/lib/jvm/java-6-sun-1.6xxxx/jre/lib/ext (xxx for whatever revision you have).

我的jar包为: mysql-connector-java-5.1.7-bin.jar。关于这个目录地址，肯定不完全一样，视具体情况而需灵活运用。

问题2：JRS创建MySQL数据源时抛出Driver找不到的异常

背景：当使用iReport设计完两个报表模版的之后，需要在JasperReports Server上实现这个功能。首先需要创建数据源，但是在JRS创建数据源之后，当尝试连接测试的时候，会显示连接失败，运行reports的时候就会报错：com.jaspersoft.jasperserver.api.JSExceptionWrapper: com.mysql.jdbc.Driver。也就是在找不到MySQL的驱动，而它默认是会安装postgresql的驱动的。

问题解决：

关于这个问题，官网上也有一些解答：http://community.jaspersoft.com/questions/540839/jasper-42-commysqljdbcdriver-problem

将mysql-connector-5.1.7-bin.jar放入tomcat目录下的lib文件夹下，也就是目录/opt/jasperreports-server-5.0.1/apache-tomcat/lib，并使用脚本重启JasperReports Server（没有重启的时候，也试过，不行，可能JRS只是在启动的时候加载驱动jar包，而不是动态的加载）

问题3：subreport从iReport迁移到JRS时出错

背景：在iReport中，设计好了加有subreport的主表，并且preview成功，希望转移到JRS生成报表。JRS实现：创建两个数据源，创建两个report，master和sub，分别连接一个数据源，master包含sub，最终生成一个表。如果直接按普通流程操作的话，会报错：net.sf.jasperreports.engine.JRRuntimeException: Parameter "DATABASE_TIMEZONE" does not exist.

问题解决：

JRS实现

Step1. 上传两个数据源，masterCon和subCon，然后上传subreport，并将它与subCon绑定。

Step2. 在本地打开masterreport.jrxml文件，关于其中subreport的配置，部分需要修改：
<defaultValueExpression><![CDATA[ "repo:subreport"]]></defaultValueExpression>
<subreportExpression><![CDATA[ "repo:subreport"]]></subreportExpression>

注意红色的书写格式，引号和冒号。

Step3. 上传masterreport，并上传subreport.jrxml。如果选择subreport.jasper文件的话。会报错：com.jaspersoft.jasperserver.api.JSExceptionWrapper: java.io.UTFDataFormatException: Invalid byte 1 of 1-byte UTF-8 sequence.

Step4. 成功运行。

转载清注明出处。

本文档更多出于我本人的理解，肯定在一些地方存在不足和错误。如果你对这方面感兴趣，并有更好的想法和建议，请联系我。

我的邮箱：[email protected]

新浪微博：@莲子弗如清