JasperReport经验谈

核心提示：JasperReport和iReport是不错的java报表工具. 在实际项目中, 本人用它们开发了20个Report, 涉及SubReport, Image, Graph, 积累了一些经验. 尤其是关于EXPort到Excel方面, 文档上也很少提及, 纯粹是摸索出来的, 有的问题还是通过读源代码才解决的. 此贴并非

JasperReport和iReport是不错的java报表工具. 在实际项目中, 本人用它们开发了20个Report, 涉及SubReport, Image, Graph, 积累了一些经验. 尤其是关于EXPort到Excel方面, 文档上也很少提及, 纯粹是摸索出来的, 有的问题还是通过读源代码才解决的. 此贴并非入门教程, 差不多算是笔记吧, 以问答形式记录. 

1. iReport
2. 安装
   1. 下载，解压iReport 0.4.0 (推荐src版本）
   2. 确认JDK是1.4以上
   3. 把JDK /lib下的tools.jar拷贝到{ireport_home}/lib目录中
3. 运行
   1. 对于下载的Binary版本，只能运行/bin/startup.bat
   2. 对于下载的Src版本，可以通过ant iReport运行（先安装ant)
   3. 假如运行startup.bat，出现java.lang.NoSUChMethodError错误，一般是JDK版本太低。假如确认已安装了1.4或以上，检查path系统变量，看看有1.3的JRE是不是排在前面（比如安装了Oracle的客户端，往往有1.3的JRE），假如出现Class Not Found，检查classpath。对于通过ant的方式运行，一般都没什么问题，所以推荐下载src版本
4. JasperReport 常见问题
   1. .jrxml vs .jasper
      • 假如在运行时载入.jrxml, 那么每次调用还得编译, 不如预先编译成.jasper.不过预先编译的jasper,必须用同样版本的JasperReport载入,而且灵活性差些. 不过对于大部分报表,还是预先编译成jasper方便
   2. 假如批量编译jrxml
      • 用Ant很轻易解决
        
 

.....

 


   3. 如何使用图片？
      • 很轻易,用Image控件就可以了. 在Image ExPRess里面可以用String来表示图片的路径, 或者用InputStream, File对象.不过不管用File还是String对象, 都不得不用绝对路径, 这显然很不灵活. 解决办法是,穿入一个$P的参数,表示图片所在的目录,然后用$P和文件名拼接出完整的绝对路径. 更好的方法是用InputStream, 例如this.getClass().getResourceAsStream("logo.jpg") ,这时只要把图片放在当前.jasper所在的目录就可以了,不必考虑什么参数,什么路径了
   4. 显示非数据库字段变量
      • 显示如运行日期等,可以直接在Text Field里面输入new java.util.Date(), 然后把Pattern设成如mm/dd/yyyy.
   5. 动态控制某些Field是否显示
      • 每个Static Text, Text Field甚至整个Band的属性里面都有Print When Expression, 比如设成new Boolean(!$P{isDisplay}.equalsIgnoreCase("yes")), 那么只有当参数display的值为yes的时候才显示
   6. 使用Sub Report, 如何使用相对路径
      • 见1.3, 和使用图片类似, 用InputStream或者传入参数
   7. Query里面如何使用参数
      • $P!{xxx} 或者 $P{xxx} 后者只能用于类似PreparedStatement参数绑定, 而前者可替换Sql的任意部分. 在需要动态排序的时候, 前者非凡有用. 比如 select a,b,c from t order by $P!{orderClause}　 不管用$P还是$P!, SQL最终是以PreparedStatement方式执行的, 不必太担心性能问题　 注重:参数是不能嵌套的, 比如$P{a} =''$P{b}''　 , $P{b}=''value'', 不要指望$P{a}能被替换成''value''
   8. 如何使用图表(Graph)
      • JasperReport本身没有图表功能, 只有显示Image的功能(见4.3). iReport里有个Graph向导, 其实质是通过jFreeChart生成Image. 更另外, 更直接的做法是放一个Image控件, Image Express Class设置成java.awt.Image, 在Image Expression里通过自定义的类返回java.awt.Image对象. 例如''Graphprovider.getImage($P{REPORT_DATASOURCE},title, suBTitle.....)''.  GraphProvider是自己的类, public static Image getImage(JRDataSource, ....)
   9. 假如显示多个图表
      • 在一张报表上显示一个图表和显示多个图表是不同的. 假设Query是select name,price,qty from xxx, 第一张图显示name-price, 第二张图显示name-qty, 假如还是按3.8的方法, 第二张图根本显示不出来! 为什么  因为传入的是JRDataSource, 而JRDataSource仅仅是对ResultSet的简单封装, 在第一张图处理完后, 游标已经到了eof位置了, 在开始处理第二张图的时候,就必然抛出游标耗尽的异常! 怎么办　 自己写个JRDataSourceAdapter, 把JRDataSource对象里面的值预先保存到一个Collection (相当于一个Offline的数据集), 然后把这个Collection传个getImage方法. 具体是, 建一个Variable  mydate, 类型是java.util.Map, Calculation Type- System, Initial Value Expression是JRDataSourceAdapter.JRDataSource2Map($P{REPORT_DATA_SOURCE},new String[]{"NAME","PRICE","QTY"},new Class[]{java.lang.String.class,java.lang.Double.class,java.lang.Double.class}), JRDataSource2Map是自己写的一个Adapter. 然后在Image的Expression里面换成如''GraphProvider.getImage(mydata,title, other params...), 当然得修改getImage方法
5. Export到Excel的问题
   1. 如何去掉报表头等
      • 直接把不需要的Band删除(把其高度设为0). 假如仅仅是export到Excel的时候不需要报表头, 而输出到PDF等仍然需要保留, 那么使用print when expression, 见4.4
   2. 假如让Excel看起来整洁
      • 不要有空白地方! 首先把所有的Field设成一样高, 对齐! 把所在Band的高度也设成和Field一样高, 让Field正好放入Band. 然后调整Field的宽度, 让每个Field都相邻,没有空隙. 最后,记得设置参数: exporter.setParameter(JRXlsExporterParameter.IS_REMOVE_EMPTY_SPACE_BETWEEN_ROWS,