iReport整合web（Struts2）后台开发

上一篇我们大概讲了一下iReport设计器的使用——如何生存模板文件并编译。这次来好好讲下如何整合web环境来进行报表的开发。

开发之前你需要注意的一点是：既然通过web后台来动态绑定数据源，那么，你就必须要意识到，产生模板文件时，不能通过Launch report wizard来产生报表模板，因为在这个向导中，你已经绑定过数据源了，所以这次必须直接透过左边的open this template按钮来修改模板，并自己加上一些Fields和Parameters了。。——这是我做分组得到的惨痛教训！！！

步骤：

1）前端：

<div class="date_select"><font>请选择日期：</font><@s.textfield label="请选择日期" name="transDateFrom" id="date" class="date" theme="simple" placeholder="点击选择日期"/></div></div><div style="text-align:center">   <button id="btn_query" class="btn btn-primary">查询</button>    <button id="btn_download"  class="btn btn-primary">导出</button> </div><br/> <div id="report" style="text-align:center"></div>

 其中id为report的div即是呈现报表的区域，之前这个也是困惑我的难点之一：如何把报表渲染到指定区域？

页面上有2个按钮——查询和导出；还有一个输入查询指定日期的数据的日期选择插件，这个插件所产生的值将会作为参数传递到后台。这里又出现了难点之二——如何把参数传给报表？解决方案是把参数值作为后台产生数据源的条件就ok了。。

对应的js为：

$('#btn_query').click(function(){  var transDate=$("[name='transDate']").eq(0).val();  /*if(transDate==''){     alert('请选择日期');return;      }*/     var url="${request.contextPath}/report/jasper?type=reportSnap&format=HTML&snapDate="+$("[name='transDate']").eq(0).val();     $.ajax({  url: url, dataType:"html",headers:{"X-Fragment":"_"}, cache:false,success: function(html) { $("#report").empty();$("#report").html(html);    } });         });

 这里的js告诉我们解决第一个困惑的办法，通过ajax请求把报表渲染到指定区域，同时，ajax的dataType为html而不再是典型的json了。

加一个导出成excel的代码吧：

 var transDate=$("[name='transDate']").eq(0).val();  if(transDate==''){     alert('请选择日期');return;      }   var url='${request.contextPath}/report/jasper';  var form = $("<form>");  form.attr("action",url);  form.attr("method","get");  form.attr("style","display:none");  form.append("<input name='type' value='reportTest'>");  form.append("<input name='transDate' value='"+transDate+"'>");    form.append("<input name='format' value='XLS'>");  $('body').append(form);  form.submit();  form.remove();

 而导出成pdf格式时，还需要jar包的支持：itextpdf-xxx.jar和itext-pdfa-xxx.jar。

 

2）接下来我们探讨下后台，后台则负责产生动态数据源。

public class ReportAction extends BaseAction {private static final long serialVersionUID = -8674663678097055820L;private Logger log = LoggerFactory.getLogger(ReportAction.class);@Autowiredprivate ReportDao reportDao;@Autowiredprivate DB db;private String snapDate;private String type;private String title;private String format;private String appid;private Map<Object, Object> reportParameters = new HashMap<Object, Object>();private List<? extends Serializable> list;private String defaultDate;//分页相关private String page;public String jasper() {if (type != null) {try {getClass().getDeclaredMethods();Method method = getClass().getDeclaredMethod(type);method.invoke(this, new Object[0]);} catch (NoSuchMethodException e) {e.printStackTrace();throw new RuntimeException("没有此报表");} catch (Exception e) {log.error("", e);throw new RuntimeException(e.getMessage());}}if (list == null || list.isEmpty()) {addActionError("没有数据"); }return "jasper";}public String getDocumentName() {try {StringBuilder sb = new StringBuilder();sb.append(URLEncoder.encode(title, "UTF-8"));return sb.toString();} catch (UnsupportedEncodingException e) {return "";}}public Map<Object, Object> getReportParameters() {reportParameters.put("SUBREPORT_DIR", ServletActionContext.getServletContext().getRealPath("/WEB-INF/jasper/"));JRAbstractLRUVirtualizer virtualizer = new JRGzipVirtualizer(2);reportParameters.put(JRParameter.REPORT_VIRTUALIZER, virtualizer);return reportParameters;}public String getLocation() {return "/WEB-INF/jasper/" + type + ".jasper";}//reportSnap报表public void reportSnap() {List list = new ArrayList();long count = 0;String transDate = null;try {list = reportDao.getSnapGroupByApp(snapDate);count = list.size();} catch (Exception e) {log.error("", e);addActionError(e.getMessage());} finally {db.close();}this.list = list;reportParameters.put("su", count + "");reportParameters.put("oper_date", DateUtils.parsFormat(new Date(), "yyyy-MM-dd"));reportParameters.put("trans_date", transDate);title = "系统快照报表";}public String getType() {return type;}public void setType(String type) {this.type = type;}public String getTitle() {return title;}public void setTitle(String title) {this.title = title;}public String getFormat() {return format;}public void setFormat(String format) {this.format = format;}public String getAppid() {return appid;}public void setAppid(String appid) {this.appid = appid;}public void setReportParameters(Map<Object, Object> reportParameters) {this.reportParameters = reportParameters;}public String getPage() {return page;}public void setPage(String page) {this.page = page;}public List<? extends Serializable> getList() {return list;}public void setList(List<? extends Serializable> list) {this.list = list;}public String getSnapDate() {return snapDate;}public void setSnapDate(String snapDate) {this.snapDate = snapDate;}}

 别忘记了给这个action在struts.xml中配置起来，以便它包含的一些属性和方法都可以找到，关键的地儿在于result name="jasper" type="jasperreports"这里~~后面的param都是在指定jasperreport报表的一些属性：

（这里是参考的struts2-jasperreports-plugin-2.3.24.jar里面的struts-plugin.xml配置，即参考struts2支持的对jasperreport的配置。。）

<package name="default" namespace="/" extends="default"><action name="report" class="com.xxxx.action.report.snap.ReportAction"><result name="jasper" type="jasperreports"><param name="reportParameters">reportParameters</param><param name="contentDisposition">attachment</param><!--这里指定了以附件形式导出时打开询问窗口--><param name="dataSource">list</param><!--数据源绑定在list变量--><param name="format">${format}</param><!--导出附件格式，支持PDF/XLS等--><param name="location">${location}</param><!--指定模板的jasper二进制文件存放位置--><param name="documentName">${documentName}</param></result></action></package>

 其中查询的dao省略，dao将返回一个List<Map<String, Object>>类型的数据，Action里通过this.list = 该数据集合 来绑定报表数据源，通过reportParameters.put("oper_date", DateUtils.parsFormat(new Date(), "yyyy-MM-dd"));来向报表的$P{oper_date}传参~~

 

我这里由于用到了分组，所以在dao里面写sql时，对于分组的sql最好加上order by 。这是官方API规定的，分组的时候，要给分组字段order by。

SELECT    app_id,   snap_date,    SUM(total_cnt) total_sum,    SUM(succ_cnt) succ_sum,    SUM(excp_cnt) excp_sum,    SUM(fail_cnt) fail_sum   FROM    itm_snap_tran_count GROUP BY app_id , snap_date order by app_id, snap_date

 其中app_id和snap_date为本例的分组字段，那么在模板文件中，我就需要为这两个字段分别都添加在Group Header当中，如：

 并且最最重要的一点：这2个Group Header都要分别指定属性Group Expression为$F{该字段名}，否则将无法正常显示（因为我就在此困扰多时，Group by的字段无法显示，为null或显示不正确）！！！

注意：

也不要通过Lauch report wizard按钮导向（会在设计器中绑定好数据源）生成的模板编译文件给web后台，否则会重复group by哦，必须是通过open this wizard的方式修改模板并自己手动加上一些参数和变量所生成的模板才行！

也要注意，dao生成的数据集的每个map的key必须跟模板文件中的 $F{变量名}对应上才能填充进去。。

只需把在js中把format修改为对应的后缀，就可以导出不同格式的报表文件。

当然，千万别忘记把模板文件的编译文件（二进制文件，后缀为.jasper而不是模板文件本身哦）放在WEB-INF/jasper目录下

这里，在页面上渲染，其实就是把报表文件以html的格式 export出来，其本质还是导出。。

附上效果图：

 

这个我是使用Cherry Landscape模板做的，黑色部分为外层group by的字段app_id，斜体部分为内嵌的group by的字段snap_date，即在app_id分组的情况下再次以snap_date分组，这也是一大难点之一！！！

 

其实，对于iReport的API我也没有研究得很透彻，因为的确比较难！顺便，附上jasperreports对报表的解析过程图：