现有的maven工程，集成birt（及birt的参数配置详解）

最新推荐文章于 2022-03-13 09:54:37 发布
最新推荐文章于 2022-03-13 09:54:37 发布
阅读量4.2k 收藏
点赞数
文章标签： birt maven+birt birt参数配置
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Fly_maxiaotiao/article/details/94734771
版权

从官网下载新的birt-runtime

下载地址为：http://download.eclipse.org/birt/downloads/
解压zip格式文件后如图：
在这里插入图片描述

配置目录结构

将上图中WebViewerExample中的文件，按如下图进行目录结构的配置：
在这里插入图片描述

  1. 根目录下新建reportFiles文件夹（放报表文件）；
  2. webcontent文件夹直接从WebViewerExample里拿；
  3. WEB-INF下的lib和tlds文件夹直接从WebViewerExample里拿；
  4. 在WEB-INF下新建report-engine文件夹，在eport-engine文件夹下新建documents images logs scriptlib四个文件夹；
  5. jrun.web.xml server-config.wsdd viewer.properties 三个文件直接从WebViewerExample里拿；
  6. 将WebViewerExample里web.xml里的内容拷到你工程里的web.xml。

web.xml的代码片

<!-- Default locale setting. -->
	<context-param>
		<param-name>BIRT_VIEWER_LOCALE</param-name>
		<param-value>en-US</param-value>
	</context-param>

	<!-- Default timezone setting. Examples: "Europe/Paris", "GMT+1". Defaults 
		to the container's timezone. -->
	<context-param>
		<param-name>BIRT_VIEWER_TIMEZONE</param-name>
		<param-value></param-value>
	</context-param>

	<!-- Report resources directory for preview. Defaults to ${birt home} -->
	<context-param>
		<param-name>BIRT_VIEWER_WORKING_FOLDER</param-name>
		<param-value>reportFiles</param-value>
	</context-param>

	<!-- Temporary document files directory. Defaults to ${birt home}/documents -->
	<context-param>
		<param-name>BIRT_VIEWER_DOCUMENT_FOLDER</param-name>
		<param-value>WEB-INF/report-engine/documents</param-value>
	</context-param>

	<!-- Flag whether the report resources can only be accessed under the working 
		folder. Defaults to true -->
	<context-param>
		<param-name>WORKING_FOLDER_ACCESS_ONLY</param-name>
		<param-value>true</param-value>
	</context-param>

	<!-- Settings for how to deal with the url report path. e.g. "http://host/repo/test.rptdesign". 
		Following values are supported: <all> - All paths. <domain> - Only the paths 
		with host matches current domain. Note the comparison is literal, "127.0.0.1" 
		and "localhost" are considered as different hosts. <none> - URL paths are 
		not supported. Defaults to "domain". -->
	<context-param>
		<param-name>URL_REPORT_PATH_POLICY</param-name>
		<param-value>domain</param-value>
	</context-param>

	<!-- Temporary image/chart directory. Defaults to ${birt home}/report/images -->
	<context-param>
		<param-name>BIRT_VIEWER_IMAGE_DIR</param-name>
		<param-value>WEB-INF/report-engine/images</param-value>
	</context-param>

	<!-- Engine log directory. Defaults to ${birt home}/logs -->
	<context-param>
		<param-name>BIRT_VIEWER_LOG_DIR</param-name>
		<param-value>WEB-INF/report-engine/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 where to store all the birt report script libraries (JARs). 
		Defaults to ${birt home}/scriptlib -->
	<context-param>
		<param-name>BIRT_VIEWER_SCRIPTLIB_DIR</param-name>
		<param-value>WEB-INF/report-engine/scriptlib</param-value>
	</context-param>

	<!-- Resource location directory. Defaults to ${birt home} -->
	<context-param>
		<param-name>BIRT_RESOURCE_PATH</param-name>
		<param-value></param-value>
	</context-param>

	<!-- Preview report rows limit. An empty value means no limit. -->
	<context-param>
		<param-name>BIRT_VIEWER_MAX_ROWS</param-name>
		<param-value></param-value>
	</context-param>

	<!-- Max cube fetch levels limit for report preview (Only used when previewing 
		a report design file using the 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 in MB for creating a cube. -->
	<context-param>
		<param-name>BIRT_VIEWER_CUBE_MEMORY_SIZE</param-name>
		<param-value></param-value>
	</context-param>

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

	<!-- Flag whether to allow server-side printing. Possible values are "ON" 
		and "OFF". Defaults to "ON". -->
	<context-param>
		<param-name>BIRT_VIEWER_PRINT_SERVERSIDE</param-name>
		<param-value>ON</param-value>
	</context-param>

	<!-- Flag whether to force browser-optimized HTML output. Defaults to true -->
	<context-param>
		<param-name>HTML_ENABLE_AGENTSTYLE_ENGINE</param-name>
		<param-value>true</param-value>
	</context-param>

	<!-- Filename generator class/factory to use for the exported reports. -->
	<context-param>
		<param-name>BIRT_FILENAME_GENERATOR_CLASS</param-name>
		<param-value>org.eclipse.birt.report.utility.filename.DefaultFilenameGenerator</param-value>
	</context-param>


	<!-- 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 Filter used to set the 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, Supports SOAP -->
	<servlet>
		<servlet-name>ViewerServlet</servlet-name>
		<servlet-class>org.eclipse.birt.report.servlet.ViewerServlet</servlet-class>
	</servlet>
	<!-- Engine Servlet -->
	<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>

运行

访问连接：http://localhost:8080/report/preview?__report=test.rptdesign
访问后如图，那么恭喜你，成功了：
在这里插入图片描述

birt参数配置

1. Servlet模式说明

查看BIRT Viewer自带的web.xml文件，可以看到有以下几个pattern：

frameset ---- 采用Ajax框架，可以显示工具条，导航条和TOC面板，实现复杂的操作，如分页处理，导出数据，导出报表，打印等等。该模式下会自动生成report document文件(预览report design文件)到特定的目录(用户可以用参数指定，也可以定义在web.xml里)。采用Ajax，速度较慢。

run ---- 也采用Ajax框架，但不实现frameset的复杂功能，不会生成临时的report document文件(预览report design文件)，也不支持分页，这个主要是应用在BIRT Designer里的preview tab里，可以支持cancel操作，其它不怎么常用。采用Ajax，速度较慢。

preview — 没有用到Ajax框架，直接调用底层Engine API对报表进行render，把生成的报表内容直接输出到浏览器。这种模式和run模式调用的是相同的Engine API，唯一区别在于run采用Ajax获取报表内容，而preview直接输出到浏览器。如果要支持分页，用户需要在URL上定义__page和 __pagerange参数，这两个参数也会在后面详细说明。需要特别说明的是，在这几种预览模式中，preview的速度是最快的。

document — 该模式主要是为了从report design文件生成report document文件。用户可以在URL上提定document文件生成存放的路径(存放在server端)，如果未指定，会直接生成 rptdocument发送到客户端浏览器，用户可以下载到客户端。

output — 该模式类似于frameset，会自动生成report document文件(预览report design文件)，区别在于output不采用Ajax，而是将生成的报表内容直接输出到浏览器。

parameter — 该模式主要用于生成一个参数对话框，一般用户不常用，用户可以直接通过提供的JSP Tag–parameterPage去实现参数对话框，不需要直接调用。

download — 用于导出报表数据为CSV格式，当你使用frameset工具条里的导出数据功能时，会用到这个模式。

2. web.xml里的参数设置

web.xml文件里有许多参数，用户应该根据自已的需求出发对这些参数有一个深入的了解。下面我会对这些参数一一做以说明。

[BIRT_VIEWER_LOCALE]
设置默认的Locale信息，暂时没有太大意义。因为Locale的信息，首先以URL上定义的__locale为准，如果没有定义，会找到当前浏览器的Locale信息，最后才会用到这里定义的信息。

[BIRT_VIEWER_WORKING_FOLDER]
设置BIRT Viewer的工作目录。用户可以把report design或是report document文件存放在这个目录下，这样就可以在URL上采用相对路径去预览这些报表文件了。默认是当前根目录。
当前支持三种形式：
相对路径 — 这个相对当前的WEB应用的context root.
绝对路径
JAVA系统变量 — 可以在启动服务器时，定义JVM的系统变量，如java –Dmyworkingfolder=D:/reports。这样就可以在web.xml中用${myworkingfolder}进行引用了。

[BIRT_VIEWER_DOCUMENT_FOLDER]
设置生成的document文件的存放路径。默认是documents目录。路径设置同上。

[WORKING_FOLDER_ACCESS_ONLY]
简单的报表访问限制控制实现，如果设为true,哪就只能预览存放在工作目录下的报表文件。默认值是false。

[BIRT_VIEWER_IMAGE_DIR]
设置生成的临时图片的存放路径。默认是report/images目录。路径设置同工作目录设置。

[BIRT_VIEWER_LOG_DIR]
设置生成的日志文件存放路径。默认是logs目录。路径设置同工作目录设置。

[BIRT_VIEWER_LOG_LEVEL]
设置日志的level，可选的值有：ALL|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST|OFF。级别由高到低。

[BIRT_VIEWER_SCRIPTLIB_DIR]
设置用户script lib文件的存放目录( 在报表中用到的Java Event Handler Class )。默认值是scriptlib。路径设置同工作目录设置。

[BIRT_RESOURCE_PATH]
设置用户资源存放路径，这些资源包括library文件，image文件等。默认是当前根目录。路径设置同工作目录设置。

[BIRT_VIEWER_MAX_ROWS]
设置获取dataset的最大记录数。主要应用于设计报表的时候，预览报表如果记录数太多，会花费很多的时间，也可能会引起out of memory问题。默认是不限制。

[BIRT_VIEWER_MAX_CUBE_LEVELS]
设置CUBE查询的最大级数。和前面的参数作用类似。默认是不限制。

[BIRT_VIEWER_CUBE_MEMORY_SIZE]
设置在生成CUBE时，可以写在memory中的最大值，单位是MB。可以提高效率，写在内存会比直接写在硬盘快很多。但同时也要注意内存占用的问题。

[BIRT_OVERWRITE_DOCUMENT]
该参数主要用于frameset/output模式，它们会生成临时的document文件上。如果设为true，则每次刷新页面时，都会重新去生成document文件，如果为false，则不会重新生成，只会用原来的document文件去生成报表内容。

[BIRT_VIEWER_CONFIG_FILE]
定义properties文件的路径，不可以修改。

[BIRT_VIEWER_PRINT_SERVERSIDE]
在frameset工具条上，提供有后台服务器打印的功能，该参数可以设置是打开还是关闭后台打印的功能。默认是打开。可选值为: ON 和 OFF。

[HTML_ENABLE_AGENTSTYLE_ENGINE]
这个参数是会传递给Engine的，主要用于一些CSS的兼容性方面的问题。默认值是true。

3. viewer.properties参数设置

viewer.properties文件主要是定义一些扩展的参数。

#configurable variable for JSP base href. Please uncomment the below line.
#base_url=http://127.0.0.1:8080
该设置主要应用于代理服务器的情况下，在使用代理服务器后，从request里获取的URI并非真正的URI，需要在这里定义。

#[EXTENSION SETTING]
viewer.extension.html=html
viewer.extension.pdf=pdf
viewer.extension.postscript=ps
viewer.extension.doc=doc
viewer.extension.xls=xls
viewer.extension.ppt=ppt
定义输出的报表文件的后缀名，和format相关联。

#[OUTPUT FORMAT LABEL NAME]
viewer.label.html=HTML
viewer.label.pdf=PDF
viewer.label.postscript=PostScript
viewer.label.doc=Word
viewer.label.xls=Excel
viewer.label.ppt=PowerPoint
定义导出报表对话框里的报表格式列表，和format相关联，这样名字会更有意义。

#[CSV SEPARATOR]
viewer.sep.0=,
viewer.sep.1=;
viewer.sep.2=:
viewer.sep.3=|
viewer.sep.4=\t
支持多种CSV分隔符，用户也可以增加新的分隔符(只支持char，而不是string)。但同时需要修改JSP文件和Messages.properties文件。

#[VIEWING SESSION CONFIGURATION]
#The BIRT viewing session is a sub-session of the HTTP session.
#An HTTP session can have multiple BIRT viewing sessions.
#Each time a new viewer is opened, a new viewing session is created.
#The following parameters are used to configure the viewing session
#management.
#If the matching HTTP session expires, all the viewing sessions
#attached to it will expire as well.

#Timeout value in seconds after which a viewing session will expire.
#The value 0 means that a session will never expire, and the cached files
#will never be cleant unless the belonging HTTP session expires.
viewer.session.timeout=1800

#Defines a session count threshold after which the cleanup process
#will try to clean up expired sessions.
viewer.session.minimumThreshold=500

#Load factor to recalculate the minimum threshold value based on the remaining
#session count after cleanup.
viewer.session.loadFactor=0.75

#Maximum number of simultaneous viewing sessions that can be open at the
#same time, to prevent cache overflowing through multiple requests.
#A value of 0 means no limit.
viewer.session.maximumSessionCount=0

#Behavior that must be used once the maximum session count is reached
#(if different than 0):
#- A value of 0 will use the “Discard new session” policy that will show
#an error message for all the newer sessions.
#- A value of 1 will use the “Discard the oldest session” policy that will
#try to discard the oldest session, even if it has not expired yet.
#Note that “busy” sessions (for example downloading results) won’t be
#cleant by this mechanism.
viewer.session.maximumSessionCountPolicy=1

#[LOGGERS]
#“logger.”+class=level
#if no level is specified or the text “DEFAULT”,
#then the default level from the web.xml will be used
logger.org.eclipse.datatools.connectivity.oda=DEFAULT
logger.org.eclipse.datatools.enablement.oda=DEFAULT

其中session的含义如下图：
在这里插入图片描述

Fly_maxiaotiao
关注
Birt项目整合maven的POM文件配置
12-15
POM文件加入BIRT运行的所有依赖，再也不用去找jar包了
Birt报表开发工具及Birt runtime部署
ghost06211的博客
09-23 4652
Birt报表开发工具及Birt runtime部署
「Birt」创建报表引擎
FEEL
10-19 2202
报表引擎是ReportEngine类的一个实例，是任何报表应用程序的关键部分。首先用EngineConfig对象来为ReportEngine准备参数，然后用BIRT报表引擎工厂来创建引擎。 创建一个配置对象： EngineConfig config = new EngineConfig(); 设置BIRT home BIRT home就是BIRT plug-ins和类库的路径，它是报表引擎
IC设计中的DC综合学习记录——模板记录
u011974971的博客
03-13 5188
DC综合的学习记录——模板记录
birt 安装(2)—Runtime 下载部署及汉化—安装
weixin_33835690的博客
01-18 541
2019独角兽企业重金招聘Python工程师标准>>> ...
maven birt pom.xml 配置
12-26
maven birt pom.xml 配置
Maven安装及配置详解.pdf
最新发布
07-15
### Maven安装及配置详解 #### 一、Maven概述与优势 Maven是Apache软件基金会的一个开源项目，作为一款优秀的项目构建工具，它能够帮助开发者有效地管理项目中的jar包及jar包之间的依赖关系，同时也支持项目的编译...
Maven deploy配置方法详解
08-18
Maven deploy 配置方法详解，通过将项目的 jar 包上传到远程仓库中，以便其他开发者和工程共享。需要在 pom.xml 文件中配置 distributionManagement 标签，并在 setting.xml 文件中添加认证信息。同时，需要注意版本...
Birt + SSH2 完整实践
guluxiaogong的博客
05-19 474
开发环境： 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-report-framework-2_2_2.zip 下载
10-29
1.将features文件夹里面的所有文件复制，粘贴到eclipse的解压安装文件夹下的features文件夹下，这里我的是：D:\javawork\javasoft\eclipse 3.7.0\eclipse\features 2.将plugins文件夹下面的所有文件复制，粘贴到eclipse的解压安装文件夹下的plugins文件夹里面，这里我是：D:\javawork\javasoft\eclipse 3.7.0\eclipse\dropins
报表工具 web+birt的环境搭建
guxing_1的博客
12-08 784
一、BIRT与工程的集成 1、从eclipse官网下载birt的运行包（地址：http://www.eclipse.org/birt/）即birt-runtime-4.8.0-20180626，这是我用的版本，解压缩，先拷贝WebViewerExample\WEB-INF下如下文件到工程的WEB-INF目录下：jrun.web.xml server-config.wsdd viewer.prop...
BIRT报表使用
乱域葬魂
06-28 3531
BIRT是一个开源软件项目，它提供BIRT技术平台来创建数据可视化和报表，这些可视化和报表可以嵌入到丰富的客户端和Web应用程序中，尤其是那些基于Java和Java EE的应用程序。 内含下载地址
MyEclipse Reports 学习笔记
avaj的博客
03-28 434
MyEclipse Reports提供了丰富的功能设置来帮助开发人员快速的创建、部署和测试自定义Web应用程序的报表。      用MyEclipse Reports创建报表，详见《手把手教你用MyEclipse Reports™创建Web报表》。      我这里主要终结MyEclipse Reports配置和报表显示汉化方式。      MyEclipse Reports配置
第二章 BIRT设计器概述及本地化支持
qq_14956715的博客
09-13 378
转载自：https://blog.csdn.net/z1012890225/article/details/37815863 2.1&nbsp;BIRT设计器概述 2.1.1&nbsp;基本概念 数据源：数据的来源，或提供...
RTL Coding 读书笔记4：Data Path
niceshotgoodball的博客
01-20 734
############################################################# # 1) coding guideline for datapath synthesis SYNOPSYS ############################################################# 关键字： 符号 位宽 正确： ...
Design Compiler —— Design Compliler中常用到的命令（示例）总结（十三）
Paul 安的博客
01-01 5840
转载文章，来源出处 http://www.cnblogs.com/IClearner/ ，作者：IC_learner ============================================ 本文将描述在Design Compliler中常用到的命令，这些命令按照流程的顺序进行嵌套讲解，主要是列举例子；大概的讲解布局如下所示： 　　　　 　　　　　　　　　　　　　　　　　　 大概有11个部分，下
birt4.4下载及配置
jjc132的博客
10-10 540
 1. 官方网站 http://download.eclipse.org/birt/downloads/ 下载4.4 All-in-One版本，并下载 BIRT Runtime，如图所示     2. 解压后的jar包分别为eclipse解压缩文件，此时我们需要对eclipse环境及其birt 设计器进行汉化，其中eclipse汉化：   选择对应eclipse版本的汉化包并链接下...
BIRT：基于 Eclipse 的报表
风行天下
08-17 2207
  胡键 , 西安交通大学硕士 2006 年 3 月 22 日 几乎在各种应用中，报表都具有其不可替代的作用。各类报表软件也是争奇斗艳，如今Eclipse也推出了自己的报表框架：BIRT。现在，让我们不妨看看它到底提供了什么样的功能，
构建Android Maven工程：pom.xml配置详解
"这篇文档主要讨论的是如何使用Maven来构建一个Android项目，特别是通过配置pom.xml文件来管理依赖和构建过程。" 在Android开发中，Maven是一种流行的构建工具，它允许开发者管理和组织项目的依赖关系，以及自动化...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值