使用JasperReport制作PDF,Excel报表(Struts2实现)

来源:互联网 发布:淘宝德国啤酒杯 编辑:程序博客网 时间:2024/03/29 20:02
JasperReport是一款非常优秀的Java开源报表API,它利用模板文件和数据源可以动态生成各种报表,并且提供模板制作工具iReport。网上有很多JasperReport的教程,不过大多都是拷来拷去,想制作一个报表还真难。最近项目组有PDF报表的需求,就把JasperReport报表的基础结合实例学了一遍。以一个例子来说明报表的做法,并结合当红Web框架Struts2来说明,其他框架都大同小异,但是本质不变。
    JasperReport编辑好后生成XML模板文件JRXML和它独有的JASPER模板,使用二者之一即可在Web应用中编译运行。
    首先,是下载API组件,到JasperReport的官网http://jasperforge.org/下载Jar开发包和模板制作工具iReport。下载完成,安装iReport。需要说明的是iReport的版本要和Jar的版本一致,否则会导致模板文件不识别的问题,这里都用3.7.2的版本来说明。
    打开iReport,点击文件->New,选择Report中的一个模板,这里我选择空白A4页面来做演示,可以任我书写。

    下一步给模板起名字,选择存放路径。下一步选择查询数据源,点击New新建,选择合适的数据连接即可,这里选择Database JDBC Connection,并选择MySQL作为数据库服务,后面的配置虽然是英文的,但是见名知义,就很简单了。
    数据库配置完毕,就开始写SQL语句,这里不要挂where子句,只是select语句即可,不过要注意,字段名必须as重命名,否则到web应用中将会出现找不到字段的问题,如果列名太多,就耐心的一个一个写完。

    这里我已经耐心的写完了,是一个简历库,字段比较多。第四步是选取字段,当然都选过来就行了。第五步是Group By就是分组设置,如果报表中需要合并单元格之类的高级操作,那么就需要考虑合理的分组显示了,我们演示不涉及高深操作。这里是和业务挂钩的,必须开发者自行研究了。然后就Finish了,得到一个完整的工作区。

    左面是文档的结构,当前已经给我们分好了栏位,可以不全用,不需要的删除即可。中间是文档工作区,是我们创作的区域,右边是工具栏,有属性,控件等。属性工具栏提供对文档元素的控制,如大小,字体等。控件工具栏提供文档可以使用的控件,常用的是静态文本和属性文本。大家可以自行尝试使用,这里给出一个设计好的模板。

    不需要改变的单元就是Static Text,需要动态变化的是Text Field。拖放好位置后右键Edit Expression即可修改表达式,iReport支持函数和参数定义,非常强大,支持运算,这里我们只选择已有字段的名即可。
    设置好后,开始对中文进行处理,因为默认做好的模板是不支持中文显示的,在模板中修改字体属性,如下图。

    这里只需设置Font Name,PDF Embedded勾上,上面那个选STSong-Light,PDF Encoding选择UniGB-UCS2-H即可。当然在Web应用中还需要一些支持PDF中文的Jar依赖,后面说明。注意任何字段不能遗漏,否则在编译JRXML时会报错。
    模板制作完毕,拷贝JRXML文件出来,我们使用编译JRXML即可,而且这是可以阅读的XML文档。下面就是往Web应用中集成,我们使用Struts2,由于Struts2先天已经支持JasperReport的视图显示,拷贝插件包(Struts2的源码包中可以找到)到编译路径即可。这里我们不使用它提供的,而是自己做,感觉更容易理解。
    在webapp目录(MyEclipse里默认是WebRoot目录)下新建文件夹jasper存放模板文件。

    在Struts2中采用简单的处理方式,可以这样进行。
Java代码 复制代码 收藏代码
  1. public String printResumeToPDF() throws Exception {   
  2.         String jrxmlPath = getServletContext().getRealPath(   
  3.                 "/jasper/sovoResume.jrxml");   
  4.         List resumeInfo = getServMgr().getUserService().getResumeForDataSource(   
  5.                 getLoginUserId());   
  6.         Map<String, String> parameters = new HashMap<String, String>();   
  7.         parameters.put("SUBREPORT_DIR", getServletContext().getRealPath(   
  8.                 "/jasper"));   
  9.         JRDataSource dataSource = new JRBeanCollectionDataSource(resumeInfo);   
  10.         JasperReport report = JasperCompileManager.compileReport(jrxmlPath);   
  11.         JasperPrint jasperPrint = JasperFillManager.fillReport(report,   
  12.                 parameters, dataSource);   
  13.         HttpServletResponse response = ServletActionContext.getResponse();   
  14.         OutputStream ouputStream = response.getOutputStream();   
  15.         // 设置相应参数,以附件形式保存PDF  
  16.         response.setContentType("application/pdf");   
  17.         response.setCharacterEncoding("UTF-8");   
  18.         response.setHeader("Content-Disposition""attachment; filename=\""  
  19.                 + URLEncoder.encode(getLoginUserRealName() + "的个人简历""UTF-8")   
  20.                 + ".pdf\"");   
  21.         // 使用JRPdfExproter导出器导出pdf  
  22.         JRPdfExporter exporter = new JRPdfExporter();   
  23.         exporter.setParameter(JRExporterParameter.JASPER_PRINT, jasperPrint);   
  24.         exporter.setParameter(JRExporterParameter.OUTPUT_STREAM, ouputStream);   
  25.         exporter.exportReport();// 导出  
  26.         ouputStream.close();// 关闭流  
  27.         return null;   
  28.     }  

    JRDataSource可以有很多中类型,这里使用的是JRBeanCollectionDataSource,参数是Collection类型的,那么使用List封装数据库操作提取的结果即可。这里使用Spring提供的JdbcTemplate对象的queryForList方法获取结果。
Java代码 复制代码 收藏代码
  1. public List getResumeForDataSource(Integer empId) {   
  2.         return jt.queryForList(SQL_GET_RESUME_FOR_DATASOURCE,   
  3.                 new Object[] { empId });   
  4.     }  

    只需传入SQL语句,就是我们在iReport中写的那个,然后加让where子句获取单一记录即可。而要获取Excel,就把生成PDF部分的代码替换为:
Java代码 复制代码 收藏代码
  1. // 设置相应参数,以附件形式保存XLS   
  2.         response.setContentType("application/vnd.excel");   
  3.         response.setCharacterEncoding("UTF-8");   
  4.         response.setHeader("Content-Disposition""attachment; filename=\""  
  5.                 + URLEncoder.encode(getLoginUserRealName() + "的个人简历""UTF-8")   
  6.                 + ".xls\"");   
  7.         // 使用JRXlsExporter导出器导出xls  
  8.         JRXlsExporter exporter = new JRXlsExporter();   
  9.         exporter.setParameter(JRExporterParameter.JASPER_PRINT, jasperPrint);   
  10.         exporter.setParameter(JRExporterParameter.OUTPUT_STREAM, ouputStream);   
  11.         exporter.exportReport();// 导出  
  12.         ouputStream.close();// 关闭流  

    其他都是不变的。之后配上Struts2的Action就可以访问了。还有几点需要说明:JasperReport所依赖的JAR包可以在运行时报错中去补充,这里给出所需依赖:apache-common的digester,beanutils,collections。Groovy包。iText2.1.7,它当前版本是5了,但是用2.1.7就行,因为新版本的package结构有所改变。处理中文的iTextAsian和iTextAsianCmaps,生成Excel需要POI包,如果没记错的话,就是这么多了。
     最后注意系统运行环境,Linux下所需的字体可能没有,而Windows下是有的,所以服务器需要有字体才能生成报表,否则就会报错说字体不存在。这个操作很简单:把windows的中文字体(一般在C:\Windows\Fonts目录),复制到linux的/usr/share/fonts/chinese/TrueType目录下即可。最终我们得到的运行结果如下: