birt部署 博客分类： 专业 birt部署web.xml配置

最近接触报表，使用Birt报表，还不错！一点小总结：

Birt部署，只是添加jar而已。

下载相应的runtime架包，单独解压birt.war

在项目中的WEB-INF下新建report-engine文件夹（可自定义），拷贝文件如下：logs、scriptlib、images、documents（需要自己创建，版本中没有，用来缓存document）.

拷贝WEB-INF文件夹除了web.xml以外的xml以及properties文件和wsdd文件，顺便把lib中的架包放到位置

拷贝tlds下的birt.tld文件到项目tld文件夹

拷贝webcontent到项目WEB下或者WEBCONTENT下（不必奇怪WEBCONTENT/WEBCONTENT,报表需要）

接下来，web.xml文件配置，添加如下代码：

 <display-name>Eclipse BIRT Report Viewer</display-name>

 

<!-- 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>

<context-param>

<param-name>BIRT_OVERWRITE_DOCUMENT </param-name>

<param-value>true</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></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>

 

<!--

Temporary image/chart directory. Defaults to ${birt home}/report/images

-->

<!--

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>

<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>SEVERE</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 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 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, 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/tld/birt.tld</taglib-location>

  </taglib>

如此，配置完成！

调用如下代码：展示报表，

http://localhost:8080/testProject/frameset?__report=/report/testReport.rptdesign