birt报表部署方式有两种,一种是通过官方提供的WebViewerExample webapp去部署
另一种是通过ReportEngine API自行开发部署程序;
采用第一种的好处是不需要编写额外的代码,直接就能部署,比较方便,但是限制很多
如果采用第二种的话就很灵活了。
本日志主要记录采用ReportEngine API来进行报表的部署;
编码前准备:
下载birt-runtime-version.zip(www.eclipse.org有下载)
解压,其中ReportEngine目录存放着所有所需的东西
准备数据库驱动
编写birt报表文件
利用下边的代码就可以执行报表文件并生成目标html文件
package report;
import java.util.HashMap;
import java.util.logging.Level;
import org.eclipse.birt.core.framework.Platform;
import org.eclipse.birt.report.engine.api.EngineConfig;
import org.eclipse.birt.report.engine.api.EngineConstants;
import org.eclipse.birt.report.engine.api.EngineException;
import org.eclipse.birt.report.engine.api.HTMLActionHandler;
import org.eclipse.birt.report.engine.api.HTMLEmitterConfig;
import org.eclipse.birt.report.engine.api.HTMLRenderContext;
import org.eclipse.birt.report.engine.api.HTMLRenderOption;
import org.eclipse.birt.report.engine.api.HTMLServerImageHandler;
import org.eclipse.birt.report.engine.api.IReportEngine;
import org.eclipse.birt.report.engine.api.IReportEngineFactory;
import org.eclipse.birt.report.engine.api.IReportRunnable;
import org.eclipse.birt.report.engine.api.IRunAndRenderTask;
public class ExecuteReport {
static void executeReport() throws EngineException {
HashMap<String, String> parameters = new HashMap<String, String>();
//报表的参数名称
String name = "byCondition";
//报表的参数值,将来可以做个jsp传进来
String pvalue = "3";
//封装成map
parameters.put(name, pvalue);
IReportEngine engine = null;
EngineConfig config = null;
try {
// 设置Engine并且启动报表平台
config = new EngineConfig();
config.setEngineHome("E:/TDDOWNLOAD/birt-runtime-2_6_1/birt-runtime-2_6_1/ReportEngine");
// 设置报表日志保存的位置和等级( null, Level ) 如果你不需要日志可以设置为null
config.setLogConfig("d:/birt/logs", Level.FINE);
// 平台初始化,启用
Platform.startup(config);
IReportEngineFactory factory = (IReportEngineFactory) Platform
.createFactoryObject(IReportEngineFactory.EXTENSION_REPORT_ENGINE_FACTORY);
engine = factory.createReportEngine(config);
engine.changeLogLevel(Level.WARNING);
} catch (Exception ex) {
ex.printStackTrace();
}
// 设置发起者的一些操作,比如显示图片,报表生成到html页面,很关键的部分
HTMLEmitterConfig emitterConfig = new HTMLEmitterConfig();
emitterConfig.setActionHandler(new HTMLActionHandler());
HTMLServerImageHandler imageHandler = new HTMLServerImageHandler();
emitterConfig.setImageHandler(imageHandler);
config.getEmitterConfigs().put("html", emitterConfig); //$NON-NLS-1$
IReportRunnable design = null;
// 打开设计好的报表,取绝对路径,最好使用context.getRealPath();这种方法实现,官方这个比较呆
design = engine
.openReportDesign("D:/Java/eclipse/workspace/TestReport/WebContent/change_bettiems.rptdesign");
// 创建报表任务
IRunAndRenderTask task = engine.createRunAndRenderTask(design);
// // 设置报表的路径和图片显示的路径
// HTMLRenderContext renderContext = new HTMLRenderContext();
// // 为所有的actions设置Base URL,这个不写就是默认服务器URL的
// renderContext.setBaseURL("http://localhost/");
// // 设置所有图片显示的URL - 如果之前没有emitterConfig.setImageHandler( imageHandler
// // );的话会造成显示的URL是本地的绝对路径,其实http://localhost不写也是可以的,会自动添加服务器的URL
// renderContext.setBaseImageURL("http://localhost/myimages");
// // 设置所有图片存放的位置,最好使用context.getRealPath();
// renderContext.setImageDirectory("C:/xampplite/htdocs/myimages");
// // 设置图片支持的格式,据官方说必须有SVG,我没写也没出错
// renderContext.setSupportedImageFormats("JPG;PNG;BMP;SVG");
// HashMap<String, HTMLRenderContext> contextMap = new HashMap<String, HTMLRenderContext>();
// contextMap.put(EngineConstants.APPCONTEXT_HTML_RENDER_CONTEXT,
// renderContext);
// task.setAppContext(contextMap);
// 设置参数
task.setParameterValues(parameters);
// 要所有的参数一条一条的写入,例如: task.setParameterValue("Top Count", new
// Integer(12));
task.validateParameters();
// 增加scrpit参考下面的例子
// pFilter.myjavamethod()
// ProcessFilter pf = new ProcessFilter();
// task.addScriptableJavaObject("pFilter", pf);
// 设置rendering操作- 例如file or stream output, output format, whether it is
// embeddable, etc
HTMLRenderOption options = new HTMLRenderOption();
// 例如:Remove HTML and Body tags
// options.setEmbeddable(true);
// 设置输出本地文件
options.setOutputFileName("C:/test/2.1/output.html");
// 设置输出文件格式
options.setOutputFormat("html");
task.setRenderOption(options);
// 运行report任务,然后关闭
// 如果要长期留驻的话可以不关闭,我建议不关闭engine和Platform,要不每次打开报表都要等好久……
task.run();
task.close();
engine.shutdown();
Platform.shutdown();
System.out.println("Finished");
}
/**
* @param args
*/
public static void main(String[] args) {
try {
executeReport();
} catch (Exception e) {
e.printStackTrace();
}
}
}