There is no report design object available.


Birt + SSH2 完整实践


sparta-紫杉 2010-8-18 8:12

开发环境: eclipse3.4.2, spring3.0, struts2.1.8, hibernate3.3.1, weblogic10.3, oracle9.2, birt2.3.2。

一、安装Birt到Eclipse

1、直接下载All-ine-one, 即直接下载带有Birt的Eclipse。该种方法已经试验可行。
2、可下载相关部件,然后安装到各相关目录。该种方法没有试过,但可参见网络文章“Birt安装指南”。
3、直接通过Eclipse的Software Updates安装Birt插件,参见如下网址:
http://download.eclipse.org/birt/downloads/updmaninst2.2.php

笔者就是通过第3种方式安装Birt到Eclipse的。

二、在已有项目中做报表,报表文件默认为test.rptdesign

1、将报表文件放到webapp/jsp/report/文件夹下。
当然,假设Birt报表文件嵌入在jsp中,Birt在找相关的*.rptdesign文件进行显示时,会默认从webapp文件夹下找。
笔者将*.rptdesign文件放到webapp/jsp/report/文件夹下之后,birt就会找不到该文件,怎么办?可以在Web.xml中设置:

< context-param >
< param-name >BIRT_VIEWER_WORKING_FOLDER </ param-name >
< param-value >/jsp/report/ </ param-value >
</ context-param >

2、编辑数据源, 数据源为“脚本数据源 scripted Data Source”,为该数据起个名字为SSH2。
3、编辑数据集,该数据集和SSH2数据源挂接。
1)、数据集的open属性:

factory= newPackages.test.report.BirtFactory.getInstance();
unitsList=factory.getUnitsLst(params["unitsId"].value);
iterator=unitsList.iterator();

注意: 上述BirtFactory类在第四标题中给出代码!

2)、数据集的fetch属性:

if(iterator.hasNext()== false) {
returnfalse;
}
else {
varunits=iterator.next();
row["id"]=units.getId();
row["name"]=units.getName();
row["type"]=units.getType();
returntrue;
}

3)、数据集的close属性:

units= null;
iterator= null;
unitsList= null;
factory= null;

4、本例子为显示相关的“单位列表”,因此报表文件显示字段为: 单位id, 单位名称, 单位类型。
5、还必须为报表文件设置参数:
1)、设置报表参数: 在“Report Parameters”中设置,本例中为unitsId,默认值为10011001。
2)、设置Data Set参数:
在“Data Set”点右键编辑,在弹出的窗口中再点“Parameters”,设置一个与报表参数同名的参数unitsId,默认值为10011001,要注意同名,要不然,在页面上会找不到相关的参数而报错。

三、将报表文件嵌入到jsp

<% @tagliburi="/birt.tld"prefix="birt" %>
<!-- 报表 -->
< div id ="reprot" >

< birt:viewer id ="birtViewer"
reportDesign
="testBirtAndSpring.rptdesign" format ="HTML"
width
="800" height ="480" left ="0"
top
="0" showParameterPage ="false" >
< birt:param name ="unitsId" value ="${unitsId}" />
</ birt:viewer >

</ div >


四、Birt和SSH2集成

1、为了防止Birt在通过URL输出显示报表时, 其中的frameset被Struts2过滤掉,须编写下面的自定义过滤器,当然这个自定义过滤器不是我写的,是一个叫做Shoru的人写的:

public classBirtFilter implementsFilter {
/**
*容器,封装birt相关功能的uri和所对应Servlet名的键值对
*/

Map<String,String>map=newHashMap<String,String>();

/**
*Context.
*/

ServletContextcontext;

/**
*debug开关
*/

staticbooleandebug=false;

/**
*/

publicvoiddestroy(){
map=null;
}


/**
*过滤birt请求,转发到对应的servlet,以绕过其他过滤器,e.g.struts
*
*/

publicvoiddoFilter(ServletRequestrequest,ServletResponseresponse,
FilterChainfc)throwsIOException,ServletException{

HttpServletRequestreq=(HttpServletRequest)request;
Stringuri=req.getRequestURI();
if(debug){
System.out.println(">>>Requesting"+uri+"?"
+req.getQueryString());
}

Set<String>keys=map.keySet();

for(Stringkey:keys){
/*
*TODO:这里的判断只是简单地调用contains方法,这样就带来较多限制。
*比如工程子目录的命名、struts命名空间等都受到birtViewer的约束。待改进。
*/

if(uri.contains(key)){
RequestDispatcherrd=this.context.getNamedDispatcher(map
.get(key));
if(rd!=null){
if(debug){
System.out.println(">>>Redirectsuccessfullyexecuted");
}

//跳过其他过滤器,跳转到对应的servlet
rd.forward(request,response);
}
else{
if(debug){
System.out
.println(">>>Redirectunsuccessfullyexecuted");
}

}

return;
}

}


//将请求交给下一个过滤器
fc.doFilter(request,response);
}


/**
*@description
*
@authorShoru
*@date2009-8-21
*
@version1.0.0
*
@paramfc
*
@throwsServletException
*/

publicvoidinit(FilterConfigfc)throwsServletException{

this.context=fc.getServletContext();
/*
*这里注意,在项目目录的命名时,不要取和birt内置的一些servlet名重复。请根据项目的web.xml自行配置。
*(包括frameset、run、preview、download、parameter、document、output)
*/

map.put("frameset","ViewerServlet");
map.put("preview","EngineServlet");
map.put("report","ViewerServlet");
}

}


并且需要在Web.xml中进行如下配置才生效(并且必须要配置在Struts2的过滤器的前面):

< filter >
< filter-name >BirtFilter </ filter-name >
< filter-class >avatar.base.birt.BirtFilter </ filter-class >
</ filter >
< filter-mapping >
< filter-name >BirtFilter </ filter-name >
< url-pattern >/* </ url-pattern >
</ filter-mapping >

2、和Spring集成,以便利用Spring来管理Bean、事务及数据源:

编写BirtFactory类:

public classBirtFactory {

privatestaticfinalLoggerlogger=Logger.getLogger(BirtFactory.class);

privatestaticBirtFactoryinstance;

privatestaticApplicationContextcontext=WebApplicationContextUtils
.getRequiredWebApplicationContext(InitServlet.SERVLET_CONTEXT);

privatefinalUnitsBuzmanager=(UnitsBuz)context.getBean("unitsBuz");
privateBirtFactory(){
logger.debug("InittheinstanceofBirtFactory");
}


publicstaticBirtFactorygetInstance(){

if(instance==null){

instance=newBirtFactory();
}


returninstance;
}


publicList<SysUnits>getUnitsLst(StringunitId){

returnmanager.findByIdList(unitId);

}

}


编写在BirtFactory中用到的InitServlet类,以便在web容器启动时,获得ApplicationContext.xml中相关上下文参数。

public classInitServlet extendsHttpServlet {

privatestaticfinallongserialVersionUID=1L;

publicstaticServletContextSERVLET_CONTEXT;

publicvoidinit()throwsServletException{

SERVLET_CONTEXT=getServletContext();
}


}


上述InitServlet需要在Web.xml中进行配置:

<!-- Birt和Spring集成的Servlet,用以Birt可利用Spring完成报表数据源的建立、
数据的获取及事务的管理功能!10/8/1722:02
-->
< servlet >
< servlet-name >Birtconfig </ servlet-name >
< servlet-class >test.report.InitServlet </ servlet-class >
< load-on-startup >2 </ load-on-startup >
</ servlet >


五、集成到Web项目

1、拷相关的文件:
首先从http://download.eclipse.org/birt/downloads/build_list.php下载Birt的运行时: birt-runtime-2_3_2_2.zip,然后解压。

复制birt-runtime-2_3_2\WebViewerExample\下的logs,report,scriptlib,webcontent文件夹到avatar项目的webapp目录下。

复制birt-runtime-2_3_2\WebViewerExample\WEB-INF\下的lib,platform,tlds文件夹,及相关server-config.wsdd,viewer.properties文件到avatar项目的webapp\WEB-INF下面。

将\birt-runtime-2_3_2\ReportEngine\文件夹打包成reportEngine.zip,复制到avatar\webapp\WEB-INF\lib文件夹下(这个东西缺了不行)。

2、web.xml配置,好家伙,这个配置比较繁琐:

< context-param >
< param-name >BIRT_VIEWER_TIMEZONE </ param-name >
< param-value ></ param-value >
</ context-param >

<!-- Reportresourcesdirectoryforpreview.Defaultto${birthome} -->
< context-param >
< param-name >BIRT_VIEWER_WORKING_FOLDER </ param-name >
< param-value >/jsp/report/ </ param-value >
</ context-param >

<!-- Thegenerateddocumentfilesdirectory.Defaultto${birthome}/documents -->
< context-param >
< param-name >BIRT_VIEWER_DOCUMENT_FOLDER </ param-name >
< param-value >/documents </ param-value >
</ context-param >

<!-- Ifonlyaccessthereprotresourcesunderworkingfolder.Defaultistrue -->
< context-param >
< param-name >WORKING_FOLDER_ACCESS_ONLY </ param-name >
< param-value >false </ param-value >
</ context-param >

<!-- Outputimage/chartdirectory.Defaultto${birthome}/report/images -->
< context-param >
< param-name >BIRT_VIEWER_IMAGE_DIR </ param-name >
< param-value >/jsp/report/ </ param-value >
</ context-param >

<!-- Enginelogdirectory.Defaultto${birthome}/logs -->
< context-param >
< param-name >BIRT_VIEWER_LOG_DIR </ param-name >
< param-value >/logs </ param-value >
</ context-param >

<!-- Reportengineloglevel -->
< context-param >
< param-name >BIRT_VIEWER_LOG_LEVEL </ param-name >
< param-value >WARNING </ param-value >
</ context-param >

<!-- Directorytostoreallbirtreportscriptlibraries(JARs).Defaultto${birthome}/scriptlib -->
< context-param >
< param-name >BIRT_VIEWER_SCRIPTLIB_DIR </ param-name >
< param-value >/scriptlib </ param-value >
</ context-param >

<!-- Resourcelocationdirectory.Defaultto${birthome} -->
< context-param >
< param-name >BIRT_RESOURCE_PATH </ param-name >
< param-value ></ param-value >
</ context-param >

<!-- Previewreportmaxrowslimited. -->
< context-param >
< param-name >BIRT_VIEWER_MAX_ROWS </ param-name >
< param-value >100 </ param-value >
</ context-param >

<!-- Previewreportmaxcubefetchlevelslimited.(Onlysupporttopreviewareportdesignfileusingpreviewpattern.) -->
< context-param >
< param-name >BIRT_VIEWER_MAX_CUBE_ROWLEVELS </ param-name >
< param-value ></ param-value >
</ context-param >
< context-param >
< param-name >BIRT_VIEWER_MAX_CUBE_COLUMNLEVELS </ param-name >
< param-value ></ param-value >
</ context-param >

<!-- Memorysize(MB)forcreatingcube. -->
< context-param >
< param-name >BIRT_VIEWER_CUBE_MEMORY_SIZE </ param-name >
< param-value ></ param-value >
</ context-param >

<!-- Ifalwaysoverwritegenerateddocumentfile.Forruntime,efalulttotrue -->
< context-param >
< param-name >BIRT_OVERWRITE_DOCUMENT </ param-name >
< param-value >true </ param-value >
</ context-param >

<!-- DefineBIRTviewerconfigurationfile -->
< context-param >
< param-name >BIRT_VIEWER_CONFIG_FILE </ param-name >
< param-value >WEB-INF/viewer.properties </ param-value >
</ context-param >

<!-- Ifturnonthefunctionthatsupportsprintontheserverside.Defaulttoon. -->
< context-param >
< param-name >BIRT_VIEWER_PRINT_SERVERSIDE </ param-name >
< param-value >ON </ param-value >
</ context-param >

<!-- IfforceoptimizedHTMLoutput.Defaulttotrue -->
< context-param >
< param-name >HTML_ENABLE_AGENTSTYLE_ENGINE </ param-name >
< param-value >true </ param-value >
</ context-param >

<!-- ViewerFilter.Currently,setrequestcharacterencodingtoUTF-8. -->
< filter >
< filter-name >ViewerFilter </ filter-name >
< filter-class >org.eclipse.birt.report.filter.ViewerFilter </ filter-class >
</ filter >

< filter-mapping >
< filter-name >ViewerFilter </ filter-name >
< servlet-name >ViewerServlet </ servlet-name >
</ filter-mapping >

< filter-mapping >
< filter-name >ViewerFilter </ filter-name >
< servlet-name >EngineServlet </ servlet-name >
</ filter-mapping >

<!-- ViewerServletContextListener -->
< listener >
< listener-class >org.eclipse.birt.report.listener.ViewerServletContextListener </ listener-class >
</ listener >

<!-- ViewerHttpSessionListener -->
< listener >
< listener-class >org.eclipse.birt.report.listener.ViewerHttpSessionListener </ listener-class >
</ listener >

<!-- ViewerServlet,SupportSOAP -->
< servlet >
< servlet-name >ViewerServlet </ servlet-name >
< servlet-class >org.eclipse.birt.report.servlet.ViewerServlet </ servlet-class >
</ servlet >

<!-- EngineSerlvet -->
< servlet >
< servlet-name >EngineServlet </ servlet-name >
< servlet-class >org.eclipse.birt.report.servlet.BirtEngineServlet </ servlet-class >
</ servlet >

< servlet-mapping >
< servlet-name >ViewerServlet </ servlet-name >
< url-pattern >/frameset </ url-pattern >
</ servlet-mapping >

< servlet-mapping >
< servlet-name >ViewerServlet </ servlet-name >
< url-pattern >/run </ url-pattern >
</ servlet-mapping >

< servlet-mapping >
< servlet-name >EngineServlet </ servlet-name >
< url-pattern >/preview </ url-pattern >
</ servlet-mapping >

< servlet-mapping >
< servlet-name >EngineServlet </ servlet-name >
< url-pattern >/download </ url-pattern >
</ servlet-mapping >

< servlet-mapping >
< servlet-name >EngineServlet </ servlet-name >
< url-pattern >/parameter </ url-pattern >
</ servlet-mapping >

< servlet-mapping >
< servlet-name >EngineServlet </ servlet-name >
< url-pattern >/document </ url-pattern >
</ servlet-mapping >

< servlet-mapping >
< servlet-name >EngineServlet </ servlet-name >
< url-pattern >/output </ url-pattern >
</ servlet-mapping >

< servlet-mapping >
< servlet-name >EngineServlet </ servlet-name >
< url-pattern >/extract </ url-pattern >
</ servlet-mapping >

< jsp-config >
< taglib >
< taglib-uri >/birt.tld </ taglib-uri >
< taglib-location >/WEB-INF/tlds/birt.tld </ taglib-location >
</ taglib >
</ jsp-config >

3、struts.xml配置:

<!-- birt报表-试验,在试验后删除。10/8/1722:17 -->
< action name ="UnitsQry2" class ="unitsAct" method ="getUnitsList" >
< result name ="input" >jsp/report/unitsBirtAndSpring.jsp </ result >
< result name ="success" >jsp/report/unitsBirtAndSpring.jsp </ result >
</ action >


4、Action:

/*
*试验Birt报表,传查询参数
*/

publicStringgetUnitsList() {

if(null==unitsId||"".equals(unitsId)){
unitsId="10011001";
}


returnSUCCESS;
}

5、业务逻辑Buz: 执行dao.getUnitsList(String unitsId)
6、Model:单位表的Pojo。
7、Dao: 通过执行getHibernateTemplage().getUnitsList(String unitsId)提取相应数据(当然了,你得确保数据库里面有数据才可以)。
8、applicationContext.xml:
注入UnitsModel、注入业务逻辑组件、注入SessionFactory。


六、运行

在游览器中运行Struts2的Action, 如下URL:
http://192.268.0.72:7001/webapp/UnitsQry2

若成功,就会显示相关结果,如下截图:


七、常见问题归纳

1、提示如下错误: org.eclipse.birt.report.exception.ViewerException: There is no report design object available.(这里我吃了大亏)

在birt里,发现图片和css没有导入,根据路径找到css,发现There is no report design object available.

我是SSH和birt整合出来的....网上搜索了一圈,,都说是版本问题.....我新建了一个report,发现版本都是3.2.22...

版本都是是一致的,新建的界面复制过去,仍这样

解决办法:

<!-- IfforceoptimizedHTMLoutput.Defaulttotrue -->
< context-param >
< param-name >HTML_ENABLE_AGENTSTYLE_ENGINE </ param-name >
< param-value >false </ param-value >
</ context-param >

是true时不行,改为false可以了。

2、并且在BirtFilter中的init方法中,不能map.put("report");这个应该是和Birt有冲突。

public voidinit(FilterConfigfc) throwsServletException {

this.context=fc.getServletContext();
/*
*这里注意,在项目目录的命名时,不要取和birt内置的一些servlet名重复。请根据项目的web.xml自行配置。
*(包括frameset、run、preview、download、parameter、document、output)
*/

map.put("frameset","ViewerServlet");
map.put("preview","EngineServlet");
//map.put("report","ViewerServlet");
}

在提供的代码及说明中,尽量的全面,为初学者提供个参考吧!有不明白者或需要探讨的地方或不足之处,欢迎联系我!



  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值