Birt + SSH2 完整实践_birt birtenginefactory setlogdirectory-程序员宅基地

技术标签： Other  

开发环境： 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 =  new Packages.test.report.BirtFactory.getInstance();
unitsList = factory.getUnitsLst(params["unitsId"].value);
iterator = unitsList.iterator();

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

    2)、数据集的fetch属性:

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

    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

<% @ taglib uri="/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  class BirtFilter  implements Filter  {
    /**
     * 容器，封装birt相关功能的uri和所对应Servlet名的键值对
     */
    Map<String, String> map = new HashMap<String, String>();

    /**
     * Context.
     */
    ServletContext context;

    /**
     * debug开关
     */
    static boolean debug = false;

    /**
     */
    public void destroy() {
        map = null;
    }

    /**
     * 过滤birt请求，转发到对应的servlet，以绕过其他过滤器，e.g. struts
     *
     */
    public void doFilter(ServletRequest request, ServletResponse response,
            FilterChain fc) throws IOException, ServletException {

        HttpServletRequest req = (HttpServletRequest) request;
        String uri = req.getRequestURI();
        if (debug) {
            System.out.println(">>>Requesting " + uri + "?"
                    + req.getQueryString());
        }
        Set<String> keys = map.keySet();

        for (String key : keys) {
            /*
             * TODO:这里的判断只是简单地调用contains方法，这样就带来较多限制。
             * 比如工程子目录的命名、struts命名空间等都受到birtViewer的约束。待改进。
             */
            if (uri.contains(key)) {
                RequestDispatcher rd = this.context.getNamedDispatcher(map
                        .get(key));
                if (rd != null) {
                    if (debug) {
                        System.out.println(">>>Redirect successfully executed");
                    }
                    // 跳过其他过滤器，跳转到对应的servlet
                    rd.forward(request, response);
                } else {
                    if (debug) {
                        System.out
                                .println(">>>Redirect unsuccessfully executed");
                    }
                }
                return;
            }
        }

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

    /**
     * @description
     * @author Shoru
     * @date 2009-8-21
     * @version 1.0.0
     * @param fc
     * @throws ServletException
     */
    public void init(FilterConfig fc) throws ServletException {

        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  class BirtFactory  {

 private static final Logger logger = Logger.getLogger(BirtFactory.class);

 private static BirtFactory instance;
 
 private static ApplicationContext context = WebApplicationContextUtils 
  .getRequiredWebApplicationContext(InitServlet.SERVLET_CONTEXT); 

 private final UnitsBuz manager = (UnitsBuz) context.getBean("unitsBuz");
 private BirtFactory() {
  logger.debug("Init the instance of BirtFactory");
 }

 public static BirtFactory getInstance() {

  if (instance == null) {

   instance = new BirtFactory();
  }

  return instance;
 }

 public List<SysUnits> getUnitsLst(String unitId) {

  return manager.findByIdList(unitId);

 }
}


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

public  class InitServlet  extends HttpServlet  {

 private static final long serialVersionUID = 1L;

 public static ServletContext SERVLET_CONTEXT;

 public void init() throws ServletException {

  SERVLET_CONTEXT = getServletContext();
 }

}


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

     <!--  Birt和Spring集成的Servlet ,用以Birt可利用Spring完成报表数据源的建立、
              数据的获取及事务的管理功能！10/8/17 22:02  -->
     < servlet >
      < servlet-name >Birt config </ 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 >
 
  <!--  Report resources directory for preview. Default to ${birt home}  -->
  < context-param >
   < param-name >BIRT_VIEWER_WORKING_FOLDER </ param-name >
   < param-value >/jsp/report/ </ param-value >
  </ context-param >
 
  <!--  The generated document files directory. Default to ${birt home}/documents  -->
  < context-param >
   < param-name >BIRT_VIEWER_DOCUMENT_FOLDER </ param-name >
   < param-value >/documents </ param-value >
  </ context-param >

  <!--  If only access the reprot resources under working folder. Default is true  -->
  < context-param >
   < param-name >WORKING_FOLDER_ACCESS_ONLY </ param-name >
   < param-value >false </ param-value >
  </ context-param >

  <!--  Output image/chart directory. Default to ${birt home}/report/images  -->
  < context-param >
   < param-name >BIRT_VIEWER_IMAGE_DIR </ param-name >
   < param-value >/jsp/report/ </ param-value >
  </ context-param >

  <!--  Engine log directory. Default to ${birt home}/logs  -->
  < context-param >
   < param-name >BIRT_VIEWER_LOG_DIR </ param-name >
   < param-value >/logs </ param-value >
  </ context-param >

  <!--  Report engine log level  -->
  < context-param >
   < param-name >BIRT_VIEWER_LOG_LEVEL </ param-name >
   < param-value >WARNING </ param-value >
  </ context-param >

  <!--  Directory to store all birt report script libraries (JARs). Default to ${birt home}/scriptlib  -->
  < context-param >
   < param-name >BIRT_VIEWER_SCRIPTLIB_DIR </ param-name >
   < param-value >/scriptlib </ param-value >
  </ context-param >
 
  <!--  Resource location directory. Default to ${birt home}  -->
  < context-param >
   < param-name >BIRT_RESOURCE_PATH </ param-name >
   < param-value ></ param-value >
  </ context-param >

  <!--  Preview report max rows limited.  -->
  < context-param >
   < param-name >BIRT_VIEWER_MAX_ROWS </ param-name >
   < param-value >100 </ param-value >
  </ context-param >

  <!--  Preview report max cube fetch levels limited.(Only support to preview a report design file using preview pattern.)  -->
  < 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 >

  <!--  Memory size(MB) for creating cube.  -->
  < context-param >
   < param-name >BIRT_VIEWER_CUBE_MEMORY_SIZE </ param-name >
   < param-value ></ param-value >
  </ context-param >
 
  <!--  If always overwrite generated document file. For runtime,efalult to true  -->
  < context-param >
   < param-name >BIRT_OVERWRITE_DOCUMENT </ param-name >
   < param-value >true </ param-value >
  </ context-param >

  <!--  Define BIRT viewer configuration file  -->
  < context-param >
   < param-name >BIRT_VIEWER_CONFIG_FILE </ param-name >
   < param-value >WEB-INF/viewer.properties </ param-value >
  </ context-param >

  <!--  If turn on the function that supports print on the server side. Default to on.  -->
  < context-param >
   < param-name >BIRT_VIEWER_PRINT_SERVERSIDE </ param-name >
   < param-value >ON </ param-value >
  </ context-param >

  <!--  If force optimized HTML output. Default to true  -->
  < context-param >
   < param-name >HTML_ENABLE_AGENTSTYLE_ENGINE </ param-name >
   < param-value >true </ param-value >
  </ context-param >

  <!--  Viewer Filter.Currently, set request character encoding to UTF-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 >
        
  <!--  Viewer Servlet Context Listener  -->
  < listener >
   < listener-class >org.eclipse.birt.report.listener.ViewerServletContextListener </ listener-class >
  </ listener >

  <!--  Viewer HttpSession Listener  -->
  < listener >
   < listener-class >org.eclipse.birt.report.listener.ViewerHttpSessionListener </ listener-class >
  </ listener >
 
  <!--  Viewer Servlet, Support SOAP  --> 
  < servlet >
   < servlet-name >ViewerServlet </ servlet-name >
   < servlet-class >org.eclipse.birt.report.servlet.ViewerServlet </ servlet-class >
  </ servlet >

  <!--  Engine Serlvet  -->
  < 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/17 22: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 报表，传查询参数
  */
  public String getUnitsList() {
  
  if (null == unitsId  || "".equals(unitsId)) {
   unitsId = "10011001";
  }
  
  return SUCCESS;
 }

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.

  <!--  If force optimized HTML output. Default to true  -->
  < 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  void init(FilterConfig fc)  throws ServletException  {

  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");
 }
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/guluxiaogong/article/details/45847299

智能推荐

海康威视网络摄像头开发流程（五）------- 直播页面测试_ezuikit 测试的url-程序员宅基地

文章浏览阅读3.8k次。1、将下载好的萤石js插件，添加到SoringBoot项目中。位置可参考下图所示。（容易出错的地方，在将js插件在html页面引入时，发生路径错误的问题）所以如果对页面中引入js的路径不清楚，可参考下图所示存放路径。2、将ezuikit.js引入到demo-live.html中。（可直接将如下代码复制到你创建的html页面中）<!DOCTYPE html><html lan..._ezuikit 测试的url

如何确定组态王与多动能RTU的通信方式_组态王ua-程序员宅基地

文章浏览阅读322次。第二步，在弹出的对话框选择，设备驱动—>PLC—>莫迪康—>ModbusRTU—>COM,根据配置软件选择的协议选期期，这里以此为例，然后点击“下一步”。第四步，把使用虚拟串口打勾(GPRS设备)，根据需要选择要生成虚拟口，这里以选择KVCOM1为例，然后点击“下一步”设备ID即Modbus地址(1-255) 使用DTU时，为下485接口上的设备地址。第六步，Modbus的从机地址，与配置软件相同，这里以1为例，点击“下一步“第五步，Modbus的从机地址，与配置软件相同，这里以1为例，点击“下一步“_组态王ua

npm超详细安装（包括配置环境变量）！！！npm安装教程(node.js安装教程)_npm安装配置-程序员宅基地

文章浏览阅读9.4k次，点赞22次，收藏19次。安装npm相当于安装node.js,Node.js已自带npm，安装Node.js时会一起安装，npm的作用就是对Node.js依赖的包进行管理，也可以理解为用来安装/卸载Node.js需要装的东西_npm安装配置

火车头采集器AI伪原创【php源码】-程序员宅基地

文章浏览阅读748次，点赞21次，收藏26次。大家好，小编来为大家解答以下问题，python基础训练100题，python入门100例题，现在让我们一起来看看吧！宝子们还在新手村练级的时候，不单要吸入基础知识，夯实自己的理论基础，还要去实际操作练练手啊！由于文章篇幅限制，不可能将100道题全部呈现在此除了这些，下面还有我整理好的基础入门学习资料，视频和讲解文案都很齐全，用来入门绝对靠谱，需要的自提。保证100%免费这不，贴心的我爆肝给大家整理了这份今天给大家分享100道Python练习题。大家一定要给我三连啊~

Linux Ubuntu 安装 Sublime Text (无法使用 wget 命令，使用安装包下载)_ubuntu 安装sumlime text打不开-程序员宅基地

文章浏览阅读1k次。 为了在 Linux （ Ubuntu） 上安装sublime，一般大家都会选择常见的教程或是 sublime 官网教程，然而在国内这种方法可能失效。为此，需要用安装包安装。以下就是使用官网安装包安装的教程。打开 sublime 官网后，点击右上角 download， 或是直接访问点击打开链接，即可看到各个平台上的安装包。选择 Linux 64 位版并下载。下载后，打开终端，进入安装..._ubuntu 安装sumlime text打不开

CrossOver for Mac 2024无需安装 Windows 即可以在 Mac 上运行游戏 Mac运行exe程序和游戏 CrossOver虚拟机 crossover运行免安装游戏包-程序员宅基地

文章浏览阅读563次，点赞13次，收藏6次。CrossOver24是一款类虚拟机软件，专为macOS和Linux用户设计。它的核心技术是Wine，这是一种在Linux和macOS等非Windows操作系统上运行Windows应用程序的开源软件。通过CrossOver24，用户可以在不购买Windows授权或使用传统虚拟机的情况下，直接在Mac或Linux系统上运行Windows软件和游戏。该软件还提供了丰富的功能，如自动配置、无缝集成和实时传输等，以实现高效的跨平台操作体验。

随便推点

一个用聊天的方式让ChatGPT写的线程安全的环形List_为什么gpt一写list就卡-程序员宅基地

文章浏览阅读1.7k次。一个用聊天的方式让ChatGPT帮我写的线程安全的环形List_为什么gpt一写list就卡

Tomcat自带的设置编码Filter-程序员宅基地

文章浏览阅读336次。我们在前面的文章里曾写过Web应用中乱码产生的原因和处理方式，旧文回顾：深度揭秘乱码问题背后的原因及解决方式其中我们提到可以通过Filter的方式来设置请求和响应的encoding，来解..._filterconfig selectencoding

javascript中encodeURI和decodeURI方法使用介绍_js encodeur decodeurl-程序员宅基地

文章浏览阅读651次。转自：http://www.jb51.net/article/36480.htmencodeURI和decodeURI是成对来使用的，因为浏览器的地址栏有中文字符的话，可以会出现不可预期的错误，所以可以encodeURI把非英文字符转化为英文编码，decodeURI可以用来把字符还原回来_js encodeur decodeurl

Android开发——打包apk遇到The destination folder does not exist or is not writeable-程序员宅基地

文章浏览阅读1.9w次，点赞6次，收藏3次。前言在日常的Android开发当中，我们肯定要打包apk。但是今天我打包的时候遇到一个很奇怪的问题Android The destination folder does not exist or is not writeable，大意是目标文件夹不存在或不可写。出现问题的原因以及解决办法上面有说报错的中文大意是：目标文件夹不存在或不可写。其实问题就在我们的打包界面当中图中标红的Desti..._the destination folder does not exist or is not writeable

Eclipse配置高大上环境-程序员宅基地

文章浏览阅读94次。一、配置代码编辑区的样式 <1>打开Eclipse，Help —> Install NewSoftware，界面如下： <2>点击add...，按下图所示操作： name：随意填写，Location：http://eclipse-color-th..._ecplise高大上设置

Linux安装MySQL-5.6.24-1.linux_glibc2.5.x86_64.rpm-bundle.tar_linux mysql 安装 mysql-5.6.24-1.linux_glibc2.5.x86_6-程序员宅基地

文章浏览阅读2.8k次。一，下载mysql:http://dev.mysql.com/downloads/mysql/； 打开页面之后，在Select Platform:下选择linux Generic，如果没有出现Linux的选项，请换一个浏览器试试。我用的谷歌版本不可以，换一个别的浏览器就行了，如果还是不行，需要换一个翻墙的浏览器。 二，下载完后解压缩并放到安装文件夹下： 1、MySQL-client-5.6.2_linux mysql 安装 mysql-5.6.24-1.linux_glibc2.5.x86_64.rpm-bundle

推荐文章

热门文章

相关标签