BIRT报表

http://www.springside.org.cn/docs/reference/Birt.htm
1.概述

网站: http://www.eclipse.org/birt/phoenix/

BIRT报表 拥有和Dreamweaver一般的操作界面，可以像画table一样画报表，生成图片，导出Excel，html分页样样齐全，样式和script设置简单，貌似还有OLAP导航功能，JasperReport注定要被打入冷宫了。

特别留意，SpringSide里仿照Spring集成JasperReport的做法，集成了Birt View。

另外特别Demo了把查询语句统一写在SaleReportManager里，对查询语句综合处理与重用，而不是默认的在每个模版文件里面写SQL。

学习资料:

1.Birt的IBM DW的中文教程：http://www-128.ibm.com/developerworks/cn/opensource/os-ecl-birt/，
2.最权威、详细的莫过于birt 官方文档
3.难得的比较全面的 BIRT 中文指南
4.Flash Demo
2.部署BIRT2.1
2.1. 拷贝文件

将/plugins, /configuration两个目录复制到webapp 根目录， 将lib复制到webapp/WEB-INF/lib
2.2. 瘦身

Birt实在太过庞大，如果将以上三个目录全拷的话几十M.因此，可以参考SS里对/lib/birt 和 webapp/plugins目录反复试验后的精简。
另外，/lib和/plugins有好多jar是重复的，只要在编译时把jar 从一个目录copy过去就行。又要注意两个目录里相同的jar的命名并不相同，而/plugins里面的文件名很严格，可参考build.xml里的这段复制命令

<copy file="lib/birt/com.ibm.icu-3.4.4.1.jar" tofile="${web.dir}/plugins/com.ibm.icu_3.4.4.1.jar"/>
<copy file="lib/birt/js-2.1.jar" tofile="${web.dir}/plugins/org.mozilla.rhino/lib/js.jar"/>
<copy file="lib/birt/chartengineapi-2.1.jar" tofile="${web.dir}/plugins/org.eclipse.birt.chart.engine_2.1.0.N20060628-1351.jar"/>
<copy todir="${web.dir}/plugins">
<fileset dir="lib/birt">
<include name="org.eclipse.emf.*"/>
</fileset>
</copy>

3.将spring与birt集成在一起
3.1 why not 说明
3.1.1 为什么没有使用 birt report viewer

BIRT Report Viewer 貌似做得很周到，提供如浏览，打印，export to CSV ,过滤参数的传入等一系列的快速操作．

然而细心思考过，这个viewer还是存在不少问题：

如不适用的报表传入参数方式(无输入验证，无日期控件)；代码复杂，可扩展性差......

发现不少功能形同虚设，所以决心抛弃．
3.1.2 为什么不在.rptdesign里写sql

往往实际项目的业务总是复杂的，不希望将复杂的逻辑通过几个简单的参数传入拼凑sql来实现，再说这样调试sql也是一件麻烦的事情，也不利于SQL管理

所以我们提倡 将查询的商业逻辑放回java Manager类，然后designer负责设计数据如何排列。这样子更适和实际项目．
3.2 自己实现的BirtReportsView的原理

实现Spring MVC的View，关键是重载它的protected void renderMergedOutputModel(Map model, HttpServletRequest request, HttpServletResponse response) 函数
3.2.1 创建 EngineConfig 与 ReportEngine 实例

public class BirtReportsView extends AbstractUrlBasedView {



private String engineHome;
private ReportEngine engine;

public BirtReportsView() {
engineHome = System.getProperty("bookstore.root"); //engine home
EngineConfig birtConfig = new EngineConfig();
birtConfig.setEngineHome(engineHome);
engine = new ReportEngine(birtConfig);
}


}

3.2.2 设定报表文件

public void openReportDesign(String filePath) throws IOException, EngineException {
File reportFilte = new File(engineHome + "/" + filePath);
IReportRunnable design = engine.openReportDesign(reportFilte.getAbsolutePath());
task = engine.createRunAndRenderTask(design);
}

3.2.3 配置 htmlrendercontext

private String scriptableJOName = "dsFactory"; //dsFactory 自由定义,主要在rptdesign中调用
private String imageDirectory = "/report/images";
private String baseImageUrl = "images";


private void run(OutputStream outputStream) throws EngineException {

HTMLRenderContext renderContext = new HTMLRenderContext();


//chart 生成图片目录
renderContext.setImageDirectory(this.engineHome + "/" + imageDirectory);


//web页面浏览 base url
renderContext.setBaseImageURL(baseImageUrl);
HashMap contextMap = new HashMap();
contextMap.put(EngineConstants.APPCONTEXT_HTML_RENDER_CONTEXT, renderContext);


task.setAppContext(contextMap);


BirtDataSourceObject birtDataSourceObject = new BirtDataSourceObject();
HTMLRenderOption options = new HTMLRenderOption();
birtDataSourceObject.setResultList(resultList);
options.setOutputStream(outputStream);
task.setRenderOption(options);

//增加api级别的java对象,以方便报表中调用获取报表数据
task.addScriptableJavaObject (scriptableJOName, birtDataSourceObject);
task.run();
}

相关文章：
1.BIRT and POJOs as datasources example
2.详细的 Report Engine API 请见[官方 ]
3.3 Birt View的使用

见SaleReprontController.

public ModelAndView view(HttpServletRequest request, HttpServletResponse response) throws Exception {
String status = request.getParameter("status");
String beginDate = request.getParameter("beginDate");
String endDate = request.getParameter("endDate");
List bookList = saleReportManager.findBooksByReportParam(status,
DateUtil.parse(beginDate, "yyyy-M-d"), DateUtil.parse(endDate, "yyyy-M-d"));
　 BirtReportView view = new BirtReportView();
view.openReportDesign("/report/sale_report.rptdesign");
view.putModel(bookList);
return new ModelAndView(view);
}