第十二章 BIRT报表的部署与配置

12.1 报表的工作模式以及相应的部署和配置

虽然为了示例的需要，在前文的第二章讲过BIRT的配置，以及在文本类报表，网格报表，图表中用过birt jsp tag，也做过一些说明。但报表的工作模式，不仅仅包含这两种。实际上，BIRT有五种工作模式，

第一种是用jsp或者javascript访问url，这个url遵循特定的格式，例如url/frameset?__report=&__paraname=paravalue；

第二种方式是在jsp页面中嵌入birt tag；

第三种模式是在servlet或者java class中打开用报表设计器设计的报表，导出一个html，pdf或者其它格式的文档的输出到既定的目录；

第四种是扩展报表展示器birt web viewer，也即是改写birt web viewer的servlet，配置访问路径，并用它来展示先前在报表设计器中设计的报表；

第五种模式即是在java class中利用报表设计API，生成报表设计文档，并用报表引擎API打开并生成html，pdf或者其它格式的文档。

本章先详细说明前文用到的两种工作模式，后面的三种，我们会在第十三章及之后的章节详细描述。

第一种工作模式：url

Url的一个例子如下：

http://localhost:8080/birt/frameset?__report=test.rptdesign&__bookmark=bk&__isreportlet=true

说明：

http://localhost:8080：代表访问的服务器地址

/birt ：代表访问的app的根目录

/frameset： 代表访问的servlet的模式，在web.xml中有配置的说明

__report=test.rptdesign&__bookmark=bk&__isreportlet=true 代表访问的参数，其中birt保留的参数以两个下划线开头，例如__report指定报表的名称；__bookmark指定报表的书签；报表参数不需要以__开头。

报表访问servlet的模式，主要有以下几种：

 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的速度是最快的。

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

这个模式会直接调用浏览器的下载功能弹出下载框或者调用默认的下载工具打开下载目录地址指定输入框。

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

下面说说最主要的保留参数的含义：

“__report”  定义要预览的rptdesign文件路径，支持相对路径和绝对路径ÿ