上一篇我们大概讲了一下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);
@Autowired
private ReportDao reportDao;
@Autowired
private 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对报表的解析过程图: